3
3
<!-- Some common paths.. -->
4
4
<!ENTITY docdir "/usr/share/doc/apt/">
5
<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</>">
6
<!ENTITY aptconfdir "<filename>/etc/apt.conf</>">
5
<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</filename>">
6
<!ENTITY aptconfdir "<filename>/etc/apt.conf</filename>">
7
7
<!ENTITY statedir "/var/lib/apt">
8
8
<!ENTITY cachedir "/var/cache/apt">
10
10
<!-- Cross references to other man pages -->
11
<!ENTITY apt-conf "<CiteRefEntry>
12
<RefEntryTitle><filename/apt.conf/</RefEntryTitle>
16
<!ENTITY apt-get "<CiteRefEntry>
17
<RefEntryTitle><command/apt-get/</RefEntryTitle>
21
<!ENTITY apt-config "<CiteRefEntry>
22
<RefEntryTitle><command/apt-config/</RefEntryTitle>
26
<!ENTITY apt-cdrom "<CiteRefEntry>
27
<RefEntryTitle><command/apt-cdrom/</RefEntryTitle>
31
<!ENTITY apt-cache "<CiteRefEntry>
32
<RefEntryTitle><command/apt-cache/</RefEntryTitle>
36
<!ENTITY apt-preferences "<CiteRefEntry>
37
<RefEntryTitle><command/apt_preferences/</RefEntryTitle>
41
<!ENTITY sources-list "<CiteRefEntry>
42
<RefEntryTitle><filename/sources.list/</RefEntryTitle>
46
<!ENTITY bug "<CiteRefEntry>
47
<RefEntryTitle><command/bug/</RefEntryTitle>
51
<!ENTITY dpkg "<CiteRefEntry>
52
<RefEntryTitle><command/dpkg/</RefEntryTitle>
56
<!ENTITY dpkg-buildpackage "<CiteRefEntry>
57
<RefEntryTitle><command/dpkg-buildpackage/</RefEntryTitle>
61
<!ENTITY gzip "<CiteRefEntry>
62
<RefEntryTitle><command/gzip/</RefEntryTitle>
66
<!ENTITY dpkg-scanpackages "<CiteRefEntry>
67
<RefEntryTitle><command/dpkg-scanpackages/</RefEntryTitle>
71
<!ENTITY dpkg-scansources "<CiteRefEntry>
72
<RefEntryTitle><command/dpkg-scansources/</RefEntryTitle>
76
<!ENTITY dselect "<CiteRefEntry>
77
<RefEntryTitle><command/dselect/</RefEntryTitle>
11
<!ENTITY apt-conf "<citerefentry>
12
<refentrytitle><filename>apt.conf</filename></refentrytitle>
13
<manvolnum>5</manvolnum>
17
<!ENTITY apt-get "<citerefentry>
18
<refentrytitle><command>apt-get</command></refentrytitle>
19
<manvolnum>8</manvolnum>
23
<!ENTITY apt-config "<citerefentry>
24
<refentrytitle><command>apt-config</command></refentrytitle>
25
<manvolnum>8</manvolnum>
29
<!ENTITY apt-cdrom "<citerefentry>
30
<refentrytitle><command>apt-cdrom</command></refentrytitle>
31
<manvolnum>8</manvolnum>
35
<!ENTITY apt-cache "<citerefentry>
36
<refentrytitle><command>apt-cache</command></refentrytitle>
37
<manvolnum>8</manvolnum>
41
<!ENTITY apt-preferences "<citerefentry>
42
<refentrytitle><command>apt_preferences</command></refentrytitle>
43
<manvolnum>5</manvolnum>
47
<!ENTITY sources-list "<citerefentry>
48
<refentrytitle><filename>sources.list</filename></refentrytitle>
49
<manvolnum>5</manvolnum>
53
<!ENTITY reportbug "<citerefentry>
54
<refentrytitle><command>reportbug</command></refentrytitle>
55
<manvolnum>1</manvolnum>
59
<!ENTITY dpkg "<citerefentry>
60
<refentrytitle><command>dpkg</command></refentrytitle>
61
<manvolnum>8</manvolnum>
65
<!ENTITY dpkg-buildpackage "<citerefentry>
66
<refentrytitle><command>dpkg-buildpackage</command></refentrytitle>
67
<manvolnum>1</manvolnum>
71
<!ENTITY gzip "<citerefentry>
72
<refentrytitle><command>gzip</command></refentrytitle>
73
<manvolnum>1</manvolnum>
77
<!ENTITY dpkg-scanpackages "<citerefentry>
78
<refentrytitle><command>dpkg-scanpackages</command></refentrytitle>
79
<manvolnum>8</manvolnum>
83
<!ENTITY dpkg-scansources "<citerefentry>
84
<refentrytitle><command>dpkg-scansources</command></refentrytitle>
85
<manvolnum>8</manvolnum>
89
<!ENTITY dselect "<citerefentry>
90
<refentrytitle><command>dselect</command></refentrytitle>
91
<manvolnum>8</manvolnum>
81
95
<!-- Boiler plate docinfo section -->
82
96
<!ENTITY apt-docinfo "
84
<address><email>apt@packages.debian.org</></address>
85
<author><firstname>Jason</> <surname>Gunthorpe</></>
86
<copyright><year>1998-2001</> <holder>Jason Gunthorpe</></>
87
<date>12 March 2001</>
98
<address><email>apt@packages.debian.org</email></address>
99
<author><firstname>Jason</firstname> <surname>Gunthorpe</surname></author>
100
<copyright><year>1998-2001</year> <holder>Jason Gunthorpe</holder></copyright>
101
<date>14 December 2003</date>
102
<productname>Linux</productname>
109
<email>apt@packages.debian.org</email>
113
<!ENTITY apt-author.jgunthorpe "
115
<firstname>Jason</firstname>
116
<surname>Gunthorpe</surname>
120
<!ENTITY apt-author.team "
122
<othername>APT team</othername>
126
<!ENTITY apt-product "
127
<productname>Linux</productname>
132
<email>apt@packages.debian.org</email>
136
<!ENTITY apt-author.jgunthorpe "
138
<firstname>Jason</firstname>
139
<surname>Gunthorpe</surname>
143
<!ENTITY apt-author.team "
145
<othername>APT team</othername>
149
<!ENTITY apt-copyright "
151
<holder>Jason Gunthorpe</holder>
152
<year>1998-2001</year>
156
<!ENTITY apt-product "
157
<productname>Linux</productname>
91
160
<!-- Boiler plate Bug reporting section -->
92
161
<!ENTITY manbugs "
93
<RefSect1><Title>Bugs</>
95
See the <ulink url='http://bugs.debian.org/apt'>APT bug page</>.
96
If you wish to report a bug in APT, please see
97
<filename>/usr/share/doc/debian/bug-reporting.txt</> or the &bug; command.
162
<refsect1><title>Bugs</title>
163
<para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>.
164
If you wish to report a bug in APT, please see
165
<filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the
101
171
<!-- Boiler plate Author section -->
102
172
<!ENTITY manauthor "
103
<RefSect1><Title>Author</>
105
APT was written by the APT team <email>apt@packages.debian.org</>.
173
<refsect1><title>Author</title>
174
<para>APT was written by the APT team <email>apt@packages.debian.org</email>.
109
179
<!-- Should be used within the option section of the text to
110
180
put in the blurb about -h, -v, -c and -o -->
111
181
<!ENTITY apt-commonoptions "
112
<VarListEntry><term><option/-h/</><term><option/--help/</>
114
Show a short usage summary.
182
<varlistentry><term><option>-h</option></term>
183
<term><option>--help</option></term>
184
<listitem><para>Show a short usage summary.
117
<VarListEntry><term><option/-v/</><term><option/--version/</>
119
Show the program verison.
190
<term><option>-v</option></term>
191
<term><option>--version</option></term>
192
<listitem><para>Show the program version.
122
<VarListEntry><term><option/-c/</><term><option/--config-file/</>
124
Configuration File; Specify a configuration file to use.
198
<term><option>-c</option></term>
199
<term><option>--config-file</option></term>
200
<listitem><para>Configuration File; Specify a configuration file to use.
125
201
The program will read the default configuration file and then this
126
202
configuration file. See &apt-conf; for syntax information.
129
<VarListEntry><term><option/-o/</><term><option/--option/</>
131
Set a Configuration Option; This will set an arbitary configuration
132
option. The syntax is <option>-o Foo::Bar=bar</>.
208
<term><option>-o</option></term>
209
<term><option>--option</option></term>
210
<listitem><para>Set a Configuration Option; This will set an arbitary
211
configuration option. The syntax is <option>-o Foo::Bar=bar</option>.
136
217
<!-- Should be used within the option section of the text to
137
218
put in the blurb about -h, -v, -c and -o -->
138
219
<!ENTITY apt-cmdblurb "
140
All command line options may be set using the configuration file, the
220
<para>All command line options may be set using the configuration file, the
141
221
descriptions indicate the configuration option to set. For boolean
142
222
options you can override the config file by using something like
143
<option/-f-/,<option/--no-f/, <option/-f=no/ or several other variations.
223
<option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
224
or several other variations.