man: Document version when new programs where introduced
[dpkg.git] / man / deb-extra-override.pod
blob5df9d7008720d033fee3e188a35e7e7fb2de6cbe
1 # dpkg manual page - deb-extra-override(5)
3 # Copyright © 2009-2010 Raphaël Hertzog <hertzog@debian.org>
5 # This is free software; you can redistribute it and/or modify
6 # it under the terms of the GNU General Public License as published by
7 # the Free Software Foundation; either version 2 of the License, or
8 # (at your option) any later version.
10 # This is distributed in the hope that it will be useful,
11 # but WITHOUT ANY WARRANTY; without even the implied warranty of
12 # MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
13 # GNU General Public License for more details.
15 # You should have received a copy of the GNU General Public License
16 # along with this program.  If not, see <https://www.gnu.org/licenses/>.
18 =encoding utf8
20 =head1 NAME
22 deb-extra-override - Debian archive extra override file
24 =head1 SYNOPSIS
26 B<override>
28 =head1 DESCRIPTION
30 While most information about a binary/source package can be found in the
31 control/.dsc file, all of it can be overridden when it's exported to
32 Packages/Sources files. The extra override file contains those overrides.
34 The extra override file has a simple whitespace-delimited format. Comments are
35 allowed (denoted with a
36 B<#>).
38 =over
40 I<package>
41 I<field-name>
42 I<value>
44 =back
46 I<package>
47 is the name of the binary/source package.
49 I<field-name>
50 is the name of the field that is overridden.
52 I<value>
53 is the value to put in the field. It can contain spaces as the line is split
54 in no more than 3 columns when it's parsed.
56 The extra override files used to make the official Packages lists may be found
57 in the
58 I<indices>
59 directory on any Debian mirror.
61 =head1 SEE ALSO
63 B<dpkg-scanpackages>(1),
64 B<dpkg-scansources>(1),
65 B<apt-ftparchive>(1).