chiark - git - mdw - dpkg/blob - man/deb-override.man

   1 .\" dpkg manual page - deb-override(5)
   2 .\"
   3 .\" Copyright © 1996 Michael Shields <shields@crosslink.net>
   4 .\" Copyright © 2010 Raphaël Hertzog <hertzog@debian.org>
   5 .\"
   6 .\" This is free software; you can redistribute it and/or modify
   7 .\" it under the terms of the GNU General Public License as published by
   8 .\" the Free Software Foundation; either version 2 of the License, or
   9 .\" (at your option) any later version.
  10 .\"
  11 .\" This is distributed in the hope that it will be useful,
  12 .\" but WITHOUT ANY WARRANTY; without even the implied warranty of
  13 .\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  14 .\" GNU General Public License for more details.
  15 .\"
  16 .\" You should have received a copy of the GNU General Public License
  17 .\" along with this program.  If not, see <https://www.gnu.org/licenses/>.
  18 .
  19 .TH deb\-override 5 "%RELEASE_DATE%" "%VERSION%" "dpkg suite"
  20 .nh
  21 .SH NAME
  22 deb\-override \- Debian archive override file
  23 .
  24 .SH SYNOPSIS
  25 override
  26 .
  27 .SH DESCRIPTION
  28 While most information about a package can be found in the control file,
  29 some is managed centrally by the distribution czars rather than by the
  30 maintainer in order to offer some global consistency.
  31 This information is found in the override file.
  32 .PP
  33 The override file has a simple whitespace-delimited format. Comments are
  34 allowed (denoted with a
  35 .BR # ).
  36 .PP
  37 .in +5
  38 .I package
  39 .I priority
  40 .I section
  41 .RI [ maintainerinfo ]
  42 .in -5
  43 .PP
  44 .I package
  45 is the name of the package. Entries in the override file for packages
  46 not found in the tree of binary packages are ignored.
  47 .PP
  48 .I priority
  49 and
  50 .I section
  51 correspond to the respective control fields available in the .deb. The
  52 allowed values are specific to each distribution archive.
  53 .PP
  54 .IR maintainerinfo ,
  55 if present, can be either the name of a maintainer for an unconditional
  56 override, or else
  57 .I oldmaintainer
  58 .B =>
  59 .I newmaintainer
  60 to perform a substitution.
  61 .PP
  62 The override files used to make the official Packages lists may be found
  63 in the
  64 .I indices
  65 directory on any Debian mirror.
  66 .
  67 .SH SEE ALSO
  68 .ad l
  69 .BR dpkg\-scanpackages (1),
  70 .BR dpkg\-scansources (1),
  71 .BR apt\-ftparchive (1).