1 <!-- -*- mode: xml; mode: fold -*- -->
3 <!-- Some common paths.. -->
4 <!ENTITY docdir "/usr/share/doc/apt/">
5 <!ENTITY guidesdir "/usr/share/doc/apt-doc/">
6 <!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</filename>">
7 <!ENTITY aptconfdir "<filename>/etc/apt.conf</filename>">
8 <!ENTITY statedir "/var/lib/apt">
9 <!ENTITY cachedir "/var/cache/apt">
11 <!-- Cross references to other man pages -->
12 <!ENTITY apt-conf "<citerefentry>
13 <refentrytitle><filename>apt.conf</filename></refentrytitle>
14 <manvolnum>5</manvolnum>
18 <!ENTITY apt-get "<citerefentry>
19 <refentrytitle><command>apt-get</command></refentrytitle>
20 <manvolnum>8</manvolnum>
24 <!ENTITY apt-config "<citerefentry>
25 <refentrytitle><command>apt-config</command></refentrytitle>
26 <manvolnum>8</manvolnum>
30 <!ENTITY apt-cdrom "<citerefentry>
31 <refentrytitle><command>apt-cdrom</command></refentrytitle>
32 <manvolnum>8</manvolnum>
36 <!ENTITY apt-cache "<citerefentry>
37 <refentrytitle><command>apt-cache</command></refentrytitle>
38 <manvolnum>8</manvolnum>
42 <!ENTITY apt-preferences "<citerefentry>
43 <refentrytitle><command>apt_preferences</command></refentrytitle>
44 <manvolnum>5</manvolnum>
48 <!ENTITY apt-key "<citerefentry>
49 <refentrytitle><command>apt-key</command></refentrytitle>
50 <manvolnum>8</manvolnum>
54 <!ENTITY apt-secure "<citerefentry>
55 <refentrytitle>apt-secure</refentrytitle>
56 <manvolnum>8</manvolnum>
60 <!ENTITY apt-ftparchive "<citerefentry>
61 <refentrytitle><filename>apt-ftparchive</filename></refentrytitle>
62 <manvolnum>1</manvolnum>
67 <!ENTITY sources-list "<citerefentry>
68 <refentrytitle><filename>sources.list</filename></refentrytitle>
69 <manvolnum>5</manvolnum>
73 <!ENTITY reportbug "<citerefentry>
74 <refentrytitle><command>reportbug</command></refentrytitle>
75 <manvolnum>1</manvolnum>
79 <!ENTITY dpkg "<citerefentry>
80 <refentrytitle><command>dpkg</command></refentrytitle>
81 <manvolnum>1</manvolnum>
85 <!ENTITY dpkg-buildpackage "<citerefentry>
86 <refentrytitle><command>dpkg-buildpackage</command></refentrytitle>
87 <manvolnum>1</manvolnum>
91 <!ENTITY gzip "<citerefentry>
92 <refentrytitle><command>gzip</command></refentrytitle>
93 <manvolnum>1</manvolnum>
97 <!ENTITY dpkg-scanpackages "<citerefentry>
98 <refentrytitle><command>dpkg-scanpackages</command></refentrytitle>
99 <manvolnum>1</manvolnum>
103 <!ENTITY dpkg-scansources "<citerefentry>
104 <refentrytitle><command>dpkg-scansources</command></refentrytitle>
105 <manvolnum>1</manvolnum>
109 <!ENTITY dselect "<citerefentry>
110 <refentrytitle><command>dselect</command></refentrytitle>
111 <manvolnum>1</manvolnum>
115 <!ENTITY aptitude "<citerefentry>
116 <refentrytitle><command>aptitude</command></refentrytitle>
117 <manvolnum>8</manvolnum>
121 <!ENTITY synaptic "<citerefentry>
122 <refentrytitle><command>synaptic</command></refentrytitle>
123 <manvolnum>8</manvolnum>
127 <!ENTITY squid-deb-proxy-client "<citerefentry>
128 <refentrytitle><command>squid-deb-proxy-client</command></refentrytitle>
129 <manvolnum>1</manvolnum>
133 <!ENTITY debsign "<citerefentry>
134 <refentrytitle><command>debsign</command></refentrytitle>
135 <manvolnum>1</manvolnum>
139 <!ENTITY debsig-verify "<citerefentry>
140 <refentrytitle><command>debsig-verify</command></refentrytitle>
141 <manvolnum>1</manvolnum>
145 <!ENTITY gpg "<citerefentry>
146 <refentrytitle><command>gpg</command></refentrytitle>
147 <manvolnum>1</manvolnum>
151 <!ENTITY wajig "<citerefentry>
152 <refentrytitle><command>wajig</command></refentrytitle>
153 <manvolnum>1</manvolnum>
157 <!ENTITY wget "<citerefentry>
158 <refentrytitle><command>wget</command></refentrytitle>
159 <manvolnum>1</manvolnum>
163 <!ENTITY apt-transport-debtorrent "<citerefentry>
164 <refentrytitle><package>apt-transport-debtorrent</package></refentrytitle>
165 <manvolnum>1</manvolnum>
169 <!ENTITY regex "<citerefentry>
170 <refentrytitle><abbrev>regex</abbrev></refentrytitle>
171 <manvolnum>7</manvolnum>
175 <!ENTITY glob "<citerefentry>
176 <refentrytitle><abbrev>glob</abbrev></refentrytitle>
177 <manvolnum>7</manvolnum>
181 <!-- Boiler plate docinfo section -->
184 <email>apt@packages.debian.org</email>
188 <!ENTITY apt-author.jgunthorpe "
190 <firstname>Jason</firstname>
191 <surname>Gunthorpe</surname>
196 <!ENTITY apt-author.moconnor "
198 <firstname>Mike</firstname>
199 <surname>O'Connor</surname>
204 <!ENTITY apt-name.dburrows "
205 <firstname>Daniel</firstname>
206 <surname>Burrows</surname>
209 <!ENTITY apt-copyright "
211 <holder>Jason Gunthorpe</holder>
212 <year>1998-2001</year>
216 <!ENTITY apt-product "
217 <productname>APT</productname>
218 <releaseinfo role='version'>&apt-product-version;</releaseinfo>
221 <!-- this will be updated by 'prepare-release' -->
222 <!ENTITY apt-product-version "0.9.14.2">
224 <!-- (Code)names for various things used all over the place -->
225 <!ENTITY oldstable-codename "squeeze">
226 <!ENTITY stable-codename "wheezy">
227 <!ENTITY testing-codename "jessie">
228 <!ENTITY stable-version "7">
229 <!ENTITY ubuntu-codename "trusty">
231 <!-- good and bad just refers to matching and not matching a pattern…
232 It is not a remark about the specific perl version.
233 There is no way perl could be clasified "good" (or "bad") in any version… -->
234 <!ENTITY good-perl "5.10">
235 <!ENTITY bad-perl "5.14">
238 <!ENTITY synopsis-arg-option "<arg><option>-o=<replaceable>&synopsis-config-string;</replaceable></option></arg>">
239 <!ENTITY synopsis-arg-config "<arg><option>-c=<filename><replaceable>&synopsis-config-file;</replaceable></filename></option></arg>">
240 <!ENTITY synopsis-arg-target-release "<arg><option>-t=<replaceable>&synopsis-target-release;</replaceable></option></arg>">
241 <!ENTITY synopsis-arg-architecture "<arg><option>-a=<replaceable>&synopsis-architecture;</replaceable></option></arg>">
242 <!ENTITY synopsis-arg-pkgver "<arg choice='plain' rep='repeat'><replaceable>&synopsis-pkg;</replaceable><arg><group choice='req'>
243 <arg choice='plain'>=<replaceable>&synopsis-pkg-ver-number;</replaceable></arg>
244 <arg choice='plain'>/<replaceable>&synopsis-target-release;</replaceable></arg>
245 </group></arg></arg>">
246 <!ENTITY synopsis-arg-pkg "<arg choice='plain' rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg>">
247 <!ENTITY synopsis-param-filename "<filename><replaceable>&synopsis-filename;</replaceable></filename>">
248 <!ENTITY synopsis-help "<arg choice='plain'><group choice='req'><arg choice='plain'>-v</arg><arg choice='plain'>--version</arg></group></arg>
249 <arg choice='plain'><group choice='req'><arg choice='plain'>-h</arg><arg choice='plain'>--help</arg></group></arg>">
250 <!ENTITY synopsis-command-apt "<refsynopsisdiv><cmdsynopsis>
251 <command>apt</command>
252 <arg><option>-h</option></arg>
253 &synopsis-arg-option;
254 &synopsis-arg-config;
255 &synopsis-arg-target-release;
256 &synopsis-arg-architecture;
258 <arg choice='plain'>list</arg>
259 <arg choice='plain'>search</arg>
260 <arg choice='plain'>show</arg>
261 <arg choice='plain'>update</arg>
262 <arg choice='plain'>upgrade</arg>
263 <arg choice='plain'>install &synopsis-arg-pkgver;</arg>
264 <arg choice='plain'>remove &synopsis-arg-pkg;</arg>
267 </cmdsynopsis></refsynopsisdiv>">
268 <!ENTITY synopsis-command-apt-get "<refsynopsisdiv><cmdsynopsis>
269 <command>apt-get</command>
270 <arg><option>-asqdyfmubV</option></arg>
271 &synopsis-arg-option;
272 &synopsis-arg-config;
273 &synopsis-arg-target-release;
274 &synopsis-arg-architecture;
276 <arg choice='plain'>update</arg>
277 <arg choice='plain'>upgrade</arg>
278 <arg choice='plain'>dselect-upgrade</arg>
279 <arg choice='plain'>dist-upgrade</arg>
280 <arg choice='plain'>install &synopsis-arg-pkgver;</arg>
281 <arg choice='plain'>remove &synopsis-arg-pkg;</arg>
282 <arg choice='plain'>purge &synopsis-arg-pkg;</arg>
283 <arg choice='plain'>source &synopsis-arg-pkgver;</arg>
284 <arg choice='plain'>build-dep &synopsis-arg-pkgver;</arg>
285 <arg choice='plain'>download &synopsis-arg-pkgver;</arg>
286 <arg choice='plain'>check</arg>
287 <arg choice='plain'>clean</arg>
288 <arg choice='plain'>autoclean</arg>
289 <arg choice='plain'>autoremove</arg>
292 </cmdsynopsis></refsynopsisdiv>">
293 <!ENTITY synopsis-command-apt-cache "<refsynopsisdiv><cmdsynopsis>
294 <command>apt-cache</command>
295 <arg><option>-agipns</option></arg>
296 &synopsis-arg-option;
297 &synopsis-arg-config;
299 <arg choice='plain'>gencaches</arg>
300 <arg choice='plain'>showpkg &synopsis-arg-pkg;</arg>
301 <arg choice='plain'>showsrc &synopsis-arg-pkg;</arg>
302 <arg choice='plain'>stats</arg>
303 <arg choice='plain'>dump</arg>
304 <arg choice='plain'>dumpavail</arg>
305 <arg choice='plain'>unmet</arg>
306 <arg choice='plain'>search <arg choice='plain' rep='repeat'><replaceable>&synopsis-regex;</replaceable></arg></arg>
307 <arg choice='plain'>show &synopsis-arg-pkgver;</arg>
308 <arg choice='plain'>depends &synopsis-arg-pkgver;</arg>
309 <arg choice='plain'>rdepends &synopsis-arg-pkgver;</arg>
310 <arg choice='plain'>pkgnames <arg><replaceable>&synopsis-prefix;</replaceable></arg></arg>
311 <arg choice='plain'>dotty &synopsis-arg-pkgver;</arg>
312 <arg choice='plain'>xvcg &synopsis-arg-pkgver;</arg>
313 <arg choice='plain'>policy <arg rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg></arg>
314 <arg choice='plain'>madison &synopsis-arg-pkg;</arg>
317 </cmdsynopsis></refsynopsisdiv>">
318 <!ENTITY synopsis-command-apt-cdrom "<refsynopsisdiv><cmdsynopsis>
319 <command>apt-cdrom</command>
320 <arg><option>-rmfan</option></arg>
321 <arg><option>-d=<replaceable>&synopsis-cdrom-mount;</replaceable></option></arg>
322 &synopsis-arg-option;
323 &synopsis-arg-config;
325 <arg choice='plain'>add</arg>
326 <arg choice='plain'>ident</arg>
329 </cmdsynopsis></refsynopsisdiv>">
330 <!--<arg><option>- -format '<replaceable>%f \"%v\";%n</replaceable>'</option></arg>-->
331 <!ENTITY synopsis-command-apt-config "<refsynopsisdiv><cmdsynopsis>
332 <command>apt-config</command>
333 <arg><option>--empty</option></arg>
334 <arg><option>--format '<replaceable>%f "%v";%n</replaceable>'</option></arg>
335 &synopsis-arg-option;
336 &synopsis-arg-config;
338 <arg choice='plain'>shell</arg>
339 <arg choice='plain'>dump</arg>
342 </cmdsynopsis></refsynopsisdiv>">
343 <!ENTITY synopsis-command-apt-extracttemplates "<refsynopsisdiv><cmdsynopsis>
344 <command>apt-extracttemplates</command>
345 <arg><option>-t=<replaceable>&synopsis-tmp-directory;</replaceable></option></arg>
346 <arg choice='plain' rep='repeat'>&synopsis-param-filename;</arg>
348 </cmdsynopsis></refsynopsisdiv>">
349 <!ENTITY synopsis-arg-ftparchive "<arg choice='plain' rep='repeat'><replaceable>&synopsis-path;</replaceable></arg><arg><filename><replaceable>&synopsis-override;</replaceable></filename><arg><replaceable>&synopsis-pathprefix;</replaceable></arg></arg>">
350 <!ENTITY synopsis-command-apt-ftparchive "<refsynopsisdiv><cmdsynopsis>
351 <command>apt-ftparchive</command>
352 <arg><option>-dsq</option></arg>
353 <arg><option>--md5</option></arg>
354 <arg><option>--delink</option></arg>
355 <arg><option>--readonly</option></arg>
356 <arg><option>--contents</option></arg>
357 <arg><option>--arch <replaceable>architecture</replaceable></option></arg>
358 &synopsis-arg-option;
359 &synopsis-arg-config;
361 <arg choice='plain'>packages &synopsis-arg-ftparchive;</arg>
362 <arg choice='plain'>sources &synopsis-arg-ftparchive;</arg>
363 <arg choice='plain'>contents <arg choice='plain'><replaceable>&synopsis-path;</replaceable></arg></arg>
364 <arg choice='plain'>release <arg choice='plain'><replaceable>&synopsis-path;</replaceable></arg></arg>
365 <arg choice='plain'>generate <arg choice='plain'><replaceable>&synopsis-config-file;</replaceable></arg> <arg choice='plain' rep='repeat'><replaceable>&synopsis-section;</replaceable></arg></arg>
366 <arg choice='plain'>clean <arg choice='plain'><replaceable>&synopsis-config-file;</replaceable></arg></arg>
369 </cmdsynopsis></refsynopsisdiv>">
370 <!ENTITY synopsis-param-keyid "<replaceable>&synopsis-keyid;</replaceable>">
371 <!ENTITY synopsis-command-apt-key "<refsynopsisdiv><cmdsynopsis>
372 <command>apt-key</command>
373 <arg><option>--keyring &synopsis-param-filename;</option></arg>
375 <arg choice='plain'>add &synopsis-param-filename;</arg>
376 <arg choice='plain'>del &synopsis-param-keyid;</arg>
377 <arg choice='plain'>export &synopsis-param-keyid;</arg>
378 <arg choice='plain'>exportall</arg>
379 <arg choice='plain'>list</arg>
380 <arg choice='plain'>finger</arg>
381 <arg choice='plain'>adv</arg>
382 <arg choice='plain'>update</arg>
383 <arg choice='plain'>net-update</arg>
386 </cmdsynopsis></refsynopsisdiv>">
387 <!ENTITY synopsis-command-apt-mark "<refsynopsisdiv><cmdsynopsis>
388 <command>apt-mark</command>
389 <arg><option>-f=&synopsis-param-filename;</option></arg>
390 <group choice='plain'>
393 <arg choice='plain'>auto</arg>
394 <arg choice='plain'>manual</arg>
395 <arg choice='plain'>showauto</arg>
396 <arg choice='plain'>showmanual</arg>
402 </cmdsynopsis></refsynopsisdiv>">
403 <!ENTITY synopsis-command-apt-sortpkgs "<refsynopsisdiv><cmdsynopsis>
404 <command>apt-sortpkgs</command>
405 <arg><option>-s</option></arg>
406 &synopsis-arg-option;
407 &synopsis-arg-config;
408 <arg choice='plain' rep='repeat'>&synopsis-param-filename;</arg>
410 </cmdsynopsis></refsynopsisdiv>">