"Fossies" - the Fresh Open Source Software Archive

Member "apt-2.2.4/doc/apt-verbatim.ent" (10 Jun 2021, 16808 Bytes) of package /linux/misc/apt-2.2.4.tar.gz:


As a special service "Fossies" has tried to format the requested source page into HTML format using (guessed) XML source code syntax highlighting (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 <!-- -*- mode: xml; mode: fold -*- -->
    2 
    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">
   10 
   11 <!-- Cross references to other man pages -->
   12 <!ENTITY apt-conf "<citerefentry>
   13     <refentrytitle><filename>apt.conf</filename></refentrytitle>
   14     <manvolnum>5</manvolnum>
   15   </citerefentry>"
   16 >
   17 
   18 <!ENTITY apt-authconf "<citerefentry>
   19     <refentrytitle><filename>apt_auth.conf</filename></refentrytitle>
   20     <manvolnum>5</manvolnum>
   21   </citerefentry>"
   22 >
   23 
   24 <!ENTITY apt-get "<citerefentry>
   25     <refentrytitle><command>apt-get</command></refentrytitle>
   26     <manvolnum>8</manvolnum>
   27   </citerefentry>"
   28 >
   29 
   30 <!ENTITY apt-config "<citerefentry>
   31     <refentrytitle><command>apt-config</command></refentrytitle>
   32     <manvolnum>8</manvolnum>
   33   </citerefentry>"
   34 >
   35 
   36 <!ENTITY apt-cdrom "<citerefentry>
   37     <refentrytitle><command>apt-cdrom</command></refentrytitle>
   38     <manvolnum>8</manvolnum>
   39   </citerefentry>"
   40 >
   41 
   42 <!ENTITY apt-cache "<citerefentry>
   43     <refentrytitle><command>apt-cache</command></refentrytitle>
   44     <manvolnum>8</manvolnum>
   45   </citerefentry>"
   46 >
   47 
   48 <!ENTITY apt-mark "<citerefentry>
   49     <refentrytitle><command>apt-mark</command></refentrytitle>
   50     <manvolnum>8</manvolnum>
   51   </citerefentry>"
   52 >
   53 
   54 <!ENTITY apt "<citerefentry>
   55     <refentrytitle><command>apt</command></refentrytitle>
   56     <manvolnum>8</manvolnum>
   57   </citerefentry>"
   58 >
   59 
   60 <!ENTITY apt-patterns "<citerefentry>
   61     <refentrytitle><abbrev>apt-patterns</abbrev></refentrytitle>
   62     <manvolnum>5</manvolnum>
   63   </citerefentry>"
   64 >
   65 
   66 <!ENTITY apt-preferences "<citerefentry>
   67     <refentrytitle><filename>apt_preferences</filename></refentrytitle>
   68     <manvolnum>5</manvolnum>
   69   </citerefentry>"
   70 >
   71 
   72 <!ENTITY apt-key "<citerefentry>
   73     <refentrytitle><command>apt-key</command></refentrytitle>
   74     <manvolnum>8</manvolnum>
   75   </citerefentry>"
   76 >
   77 
   78 <!ENTITY apt-secure "<citerefentry>
   79     <refentrytitle>apt-secure</refentrytitle>
   80     <manvolnum>8</manvolnum>
   81   </citerefentry>"
   82 >
   83 
   84 <!ENTITY apt-ftparchive "<citerefentry>
   85     <refentrytitle><command>apt-ftparchive</command></refentrytitle>
   86     <manvolnum>1</manvolnum>
   87   </citerefentry>"
   88 >
   89 
   90 <!ENTITY apt-transport-http "<citerefentry>
   91     <refentrytitle><command>apt-transport-http</command></refentrytitle>
   92     <manvolnum>1</manvolnum>
   93   </citerefentry>"
   94 >
   95 
   96 <!ENTITY apt-transport-https "<citerefentry>
   97     <refentrytitle><command>apt-transport-https</command></refentrytitle>
   98     <manvolnum>1</manvolnum>
   99   </citerefentry>"
  100 >
  101 
  102 <!ENTITY apt-transport-mirror "<citerefentry>
  103     <refentrytitle><command>apt-transport-mirror</command></refentrytitle>
  104     <manvolnum>1</manvolnum>
  105   </citerefentry>"
  106 >
  107 
  108 <!ENTITY sources-list "<citerefentry>
  109     <refentrytitle><filename>sources.list</filename></refentrytitle>
  110     <manvolnum>5</manvolnum>
  111   </citerefentry>"
  112 >
  113 
  114 <!ENTITY reportbug "<citerefentry>
  115     <refentrytitle><command>reportbug</command></refentrytitle>
  116     <manvolnum>1</manvolnum>
  117   </citerefentry>"
  118 >
  119 
  120 <!ENTITY dpkg "<citerefentry>
  121     <refentrytitle><command>dpkg</command></refentrytitle>
  122     <manvolnum>1</manvolnum>
  123   </citerefentry>"
  124 >
  125 
  126 <!ENTITY dpkg-buildpackage "<citerefentry>
  127     <refentrytitle><command>dpkg-buildpackage</command></refentrytitle>
  128     <manvolnum>1</manvolnum>
  129   </citerefentry>"
  130 >
  131 
  132 <!ENTITY gzip "<citerefentry>
  133     <refentrytitle><command>gzip</command></refentrytitle>
  134     <manvolnum>1</manvolnum>
  135   </citerefentry>"
  136 >
  137 
  138 <!ENTITY dpkg-scanpackages "<citerefentry>
  139     <refentrytitle><command>dpkg-scanpackages</command></refentrytitle>
  140     <manvolnum>1</manvolnum>
  141   </citerefentry>"
  142 >
  143 
  144 <!ENTITY dpkg-scansources "<citerefentry>
  145     <refentrytitle><command>dpkg-scansources</command></refentrytitle>
  146     <manvolnum>1</manvolnum>
  147   </citerefentry>"
  148 >
  149 
  150 <!ENTITY dselect "<citerefentry>
  151     <refentrytitle><command>dselect</command></refentrytitle>
  152     <manvolnum>1</manvolnum>
  153   </citerefentry>"
  154 >
  155 
  156 <!ENTITY aptitude "<citerefentry>
  157     <refentrytitle><command>aptitude</command></refentrytitle>
  158     <manvolnum>8</manvolnum>
  159   </citerefentry>"
  160 >
  161 
  162 <!ENTITY synaptic "<citerefentry>
  163     <refentrytitle><command>synaptic</command></refentrytitle>
  164     <manvolnum>8</manvolnum>
  165   </citerefentry>"
  166 >
  167 
  168 <!ENTITY squid-deb-proxy-client "<citerefentry>
  169     <refentrytitle><command>squid-deb-proxy-client</command></refentrytitle>
  170     <manvolnum>1</manvolnum>
  171   </citerefentry>"
  172 >
  173 
  174 <!ENTITY auto-apt-proxy "<citerefentry>
  175     <refentrytitle><command>auto-apt-proxy</command></refentrytitle>
  176     <manvolnum>1</manvolnum>
  177   </citerefentry>"
  178 >
  179 
  180 <!ENTITY debsign "<citerefentry>
  181     <refentrytitle><command>debsign</command></refentrytitle>
  182     <manvolnum>1</manvolnum>
  183   </citerefentry>"
  184 >
  185 
  186 <!ENTITY debsig-verify "<citerefentry>
  187     <refentrytitle><command>debsig-verify</command></refentrytitle>
  188     <manvolnum>1</manvolnum>
  189   </citerefentry>"
  190 >
  191 
  192 <!ENTITY gpg "<citerefentry>
  193     <refentrytitle><command>gpg</command></refentrytitle>
  194     <manvolnum>1</manvolnum>
  195   </citerefentry>"
  196 >
  197 
  198 <!ENTITY wajig "<citerefentry>
  199     <refentrytitle><command>wajig</command></refentrytitle>
  200     <manvolnum>1</manvolnum>
  201   </citerefentry>"
  202 >
  203 
  204 <!ENTITY wget "<citerefentry>
  205     <refentrytitle><command>wget</command></refentrytitle>
  206     <manvolnum>1</manvolnum>
  207   </citerefentry>"
  208 >
  209 
  210 <!ENTITY apt-transport-debtorrent "<citerefentry>
  211     <refentrytitle><package>apt-transport-debtorrent</package></refentrytitle>
  212     <manvolnum>1</manvolnum>
  213   </citerefentry>"
  214 >
  215 
  216 <!ENTITY regex "<citerefentry>
  217      <refentrytitle><abbrev>regex</abbrev></refentrytitle>
  218      <manvolnum>7</manvolnum>
  219   </citerefentry>"
  220 >
  221 
  222 <!ENTITY glob "<citerefentry>
  223      <refentrytitle><abbrev>glob</abbrev></refentrytitle>
  224      <manvolnum>7</manvolnum>
  225   </citerefentry>"
  226 >
  227 
  228 <!ENTITY apt-file "<citerefentry>
  229      <refentrytitle><command>apt-file</command></refentrytitle>
  230      <manvolnum>1</manvolnum>
  231   </citerefentry>"
  232 >
  233 
  234 <!ENTITY apt-acquire-additional-files "<literal><filename>/usr/share/doc/apt/acquire-additional-files.md.gz</filename></literal>">
  235 
  236 <!-- Boiler plate docinfo section -->
  237 <!ENTITY apt-email "
  238    <address>
  239     <email>apt@packages.debian.org</email>
  240    </address>
  241 ">
  242 
  243 <!ENTITY apt-author.jgunthorpe "
  244    <author>
  245     <firstname>Jason</firstname>
  246     <surname>Gunthorpe</surname>
  247     <contrib></contrib>
  248    </author>
  249 ">
  250 
  251 <!ENTITY apt-author.moconnor "
  252    <author>
  253     <firstname>Mike</firstname>
  254     <surname>O'Connor</surname>
  255     <contrib></contrib>
  256    </author>
  257 ">
  258 
  259 <!ENTITY apt-name.dburrows "
  260      <firstname>Daniel</firstname>
  261      <surname>Burrows</surname>
  262 ">
  263 
  264 <!ENTITY apt-copyright "
  265     <copyright>
  266      <holder>Jason Gunthorpe</holder>
  267      <year>1998-2001</year>
  268     </copyright>
  269 ">
  270 
  271 <!ENTITY apt-product "
  272    <productname>APT</productname>
  273    <releaseinfo role='version'>&apt-product-version;</releaseinfo>
  274 ">
  275 
  276 <!-- this will be updated by 'prepare-release' -->
  277 <!ENTITY apt-product-version "2.2.4">
  278 
  279 <!-- (Code)names for various things used all over the place -->
  280 <!ENTITY debian-oldstable-codename "buster">
  281 <!ENTITY debian-stable-codename "bullseye">
  282 <!ENTITY debian-testing-codename "bookworm">
  283 <!ENTITY debian-stable-version "11">
  284 <!ENTITY ubuntu-codename "hirsute">
  285 
  286 <!-- good and bad just refers to matching and not matching a pattern…
  287      It is not a remark about the specific perl version.
  288      There is no way perl could be classified "good" (or "bad") in any version… -->
  289 <!ENTITY good-perl "5.20">
  290 <!ENTITY bad-perl "5.24">
  291 
  292 <!-- Arguments -->
  293 <!ENTITY synopsis-arg-option "<arg><option>-o=<replaceable>&synopsis-config-string;</replaceable></option></arg>">
  294 <!ENTITY synopsis-arg-config "<arg><option>-c=<filename><replaceable>&synopsis-config-file;</replaceable></filename></option></arg>">
  295 <!ENTITY synopsis-arg-target-release "<arg><option>-t=<replaceable>&synopsis-target-release;</replaceable></option></arg>">
  296 <!ENTITY synopsis-arg-architecture "<arg><option>-a=<replaceable>&synopsis-architecture;</replaceable></option></arg>">
  297 <!ENTITY synopsis-arg-pkgver "<arg choice='plain' rep='repeat'><replaceable>&synopsis-pkg;</replaceable><arg><group choice='req'>
  298     <arg choice='plain'>=<replaceable>&synopsis-pkg-ver-number;</replaceable></arg>
  299     <arg choice='plain'>/<replaceable>&synopsis-target-release;</replaceable></arg>
  300 </group></arg></arg>">
  301 <!ENTITY synopsis-arg-pkg "<arg choice='plain' rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg>">
  302 <!ENTITY synopsis-param-filename "<filename><replaceable>&synopsis-filename;</replaceable></filename>">
  303 <!ENTITY synopsis-help "<arg choice='plain'><group choice='req'><arg choice='plain'>-v</arg><arg choice='plain'>--version</arg></group></arg>
  304     <arg choice='plain'><group choice='req'><arg choice='plain'>-h</arg><arg choice='plain'>--help</arg></group></arg>">
  305 <!ENTITY synopsis-command-apt "<refsynopsisdiv><cmdsynopsis>
  306     <command>apt</command>
  307     <arg><option>-h</option></arg>
  308     &synopsis-arg-option;
  309     &synopsis-arg-config;
  310     &synopsis-arg-target-release;
  311     &synopsis-arg-architecture;
  312     <group choice='req'>
  313         <arg choice='plain'>list</arg>
  314         <arg choice='plain'>search</arg>
  315         <arg choice='plain'>show</arg>
  316         <arg choice='plain'>update</arg>
  317         <arg choice='plain'>install &synopsis-arg-pkgver;</arg>
  318         <arg choice='plain'>remove &synopsis-arg-pkg;</arg>
  319         <arg choice='plain'>upgrade</arg>
  320         <arg choice='plain'>full-upgrade</arg>
  321         <arg choice='plain'>edit-sources</arg>
  322         &synopsis-help;
  323     </group>
  324 </cmdsynopsis></refsynopsisdiv>">
  325 <!ENTITY synopsis-command-apt-get "<refsynopsisdiv><cmdsynopsis>
  326     <command>apt-get</command>
  327     <arg><option>-asqdyfmubV</option></arg>
  328     &synopsis-arg-option;
  329     &synopsis-arg-config;
  330     &synopsis-arg-target-release;
  331     &synopsis-arg-architecture;
  332     <group choice='req'>
  333         <arg choice='plain'>update</arg>
  334         <arg choice='plain'>upgrade</arg>
  335         <arg choice='plain'>dselect-upgrade</arg>
  336         <arg choice='plain'>dist-upgrade</arg>
  337         <arg choice='plain'>install &synopsis-arg-pkgver;</arg>
  338         <arg choice='plain'>remove &synopsis-arg-pkg;</arg>
  339         <arg choice='plain'>purge &synopsis-arg-pkg;</arg>
  340         <arg choice='plain'>source &synopsis-arg-pkgver;</arg>
  341         <arg choice='plain'>build-dep &synopsis-arg-pkgver;</arg>
  342         <arg choice='plain'>download &synopsis-arg-pkgver;</arg>
  343         <arg choice='plain'>check</arg>
  344         <arg choice='plain'>clean</arg>
  345         <arg choice='plain'>autoclean</arg>
  346         <arg choice='plain'>autoremove</arg>
  347         &synopsis-help;
  348     </group>
  349 </cmdsynopsis></refsynopsisdiv>">
  350 <!ENTITY synopsis-command-apt-cache "<refsynopsisdiv><cmdsynopsis>
  351     <command>apt-cache</command>
  352     <arg><option>-agipns</option></arg>
  353     &synopsis-arg-option;
  354     &synopsis-arg-config;
  355     <group choice='req'>
  356         <arg choice='plain'>gencaches</arg>
  357         <arg choice='plain'>showpkg &synopsis-arg-pkg;</arg>
  358         <arg choice='plain'>showsrc &synopsis-arg-pkg;</arg>
  359         <arg choice='plain'>stats</arg>
  360         <arg choice='plain'>dump</arg>
  361         <arg choice='plain'>dumpavail</arg>
  362         <arg choice='plain'>unmet</arg>
  363         <arg choice='plain'>search <arg choice='plain' rep='repeat'><replaceable>&synopsis-regex;</replaceable></arg></arg>
  364         <arg choice='plain'>show &synopsis-arg-pkgver;</arg>
  365         <arg choice='plain'>depends &synopsis-arg-pkgver;</arg>
  366         <arg choice='plain'>rdepends &synopsis-arg-pkgver;</arg>
  367         <arg choice='plain'>pkgnames <arg><replaceable>&synopsis-prefix;</replaceable></arg></arg>
  368         <arg choice='plain'>dotty &synopsis-arg-pkgver;</arg>
  369         <arg choice='plain'>xvcg &synopsis-arg-pkgver;</arg>
  370         <arg choice='plain'>policy <arg rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg></arg>
  371         <arg choice='plain'>madison &synopsis-arg-pkg;</arg>
  372         &synopsis-help;
  373     </group>
  374 </cmdsynopsis></refsynopsisdiv>">
  375 <!ENTITY synopsis-command-apt-cdrom "<refsynopsisdiv><cmdsynopsis>
  376     <command>apt-cdrom</command>
  377     <arg><option>-rmfan</option></arg>
  378     <arg><option>-d=<replaceable>&synopsis-cdrom-mount;</replaceable></option></arg>
  379     &synopsis-arg-option;
  380     &synopsis-arg-config;
  381     <group choice='req'>
  382         <arg choice='plain'>add</arg>
  383         <arg choice='plain'>ident</arg>
  384         &synopsis-help;
  385     </group>
  386 </cmdsynopsis></refsynopsisdiv>">
  387 <!--<arg><option>- -format '<replaceable>&#37;f \"&#37;v\";&#37;n</replaceable>'</option></arg>-->
  388 <!ENTITY synopsis-command-apt-config "<refsynopsisdiv><cmdsynopsis>
  389     <command>apt-config</command>
  390     <arg><option>--empty</option></arg>
  391     <arg><option>--format '<replaceable>&percnt;f &#x0022;&percnt;v&#x0022;;&percnt;n</replaceable>'</option></arg>
  392     &synopsis-arg-option;
  393     &synopsis-arg-config;
  394     <group choice='req'>
  395         <arg choice='plain'>shell</arg>
  396         <arg choice='plain'>dump</arg>
  397         &synopsis-help;
  398     </group>
  399 </cmdsynopsis></refsynopsisdiv>">
  400 <!ENTITY synopsis-command-apt-extracttemplates "<refsynopsisdiv><cmdsynopsis>
  401     <command>apt-extracttemplates</command>
  402     <arg><option>-t=<replaceable>&synopsis-tmp-directory;</replaceable></option></arg>
  403     <arg choice='plain' rep='repeat'>&synopsis-param-filename;</arg>
  404     &synopsis-help;
  405 </cmdsynopsis></refsynopsisdiv>">
  406 <!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>">
  407 <!ENTITY synopsis-command-apt-ftparchive "<refsynopsisdiv><cmdsynopsis>
  408     <command>apt-ftparchive</command>
  409     <arg><option>-dsq</option></arg>
  410     <arg><option>--md5</option></arg>
  411     <arg><option>--delink</option></arg>
  412     <arg><option>--readonly</option></arg>
  413     <arg><option>--contents</option></arg>
  414     <arg><option>--arch <replaceable>architecture</replaceable></option></arg>
  415     &synopsis-arg-option;
  416     &synopsis-arg-config;
  417     <group choice='req'>
  418         <arg choice='plain'>packages &synopsis-arg-ftparchive;</arg>
  419         <arg choice='plain'>sources &synopsis-arg-ftparchive;</arg>
  420         <arg choice='plain'>contents <arg choice='plain'><replaceable>&synopsis-path;</replaceable></arg></arg>
  421         <arg choice='plain'>release <arg choice='plain'><replaceable>&synopsis-path;</replaceable></arg></arg>
  422         <arg choice='plain'>generate <arg choice='plain'><replaceable>&synopsis-config-file;</replaceable></arg> <arg choice='plain' rep='repeat'><replaceable>&synopsis-section;</replaceable></arg></arg>
  423         <arg choice='plain'>clean <arg choice='plain'><replaceable>&synopsis-config-file;</replaceable></arg></arg>
  424         &synopsis-help;
  425     </group>
  426 </cmdsynopsis></refsynopsisdiv>">
  427 <!ENTITY synopsis-param-keyid "<replaceable>&synopsis-keyid;</replaceable>">
  428 <!ENTITY synopsis-command-apt-key "<refsynopsisdiv><cmdsynopsis>
  429     <command>apt-key</command>
  430     <arg><option>--keyring &synopsis-param-filename;</option></arg>
  431     <group choice='req'>
  432         <arg choice='plain'>add &synopsis-param-filename;</arg>
  433         <arg choice='plain'>del &synopsis-param-keyid;</arg>
  434         <arg choice='plain'>export &synopsis-param-keyid;</arg>
  435         <arg choice='plain'>exportall</arg>
  436         <arg choice='plain'>list</arg>
  437         <arg choice='plain'>finger</arg>
  438         <arg choice='plain'>adv</arg>
  439         <arg choice='plain'>update</arg>
  440         <arg choice='plain'>net-update</arg>
  441         &synopsis-help;
  442     </group>
  443 </cmdsynopsis></refsynopsisdiv>">
  444 <!ENTITY synopsis-command-apt-mark "<refsynopsisdiv><cmdsynopsis>
  445     <command>apt-mark</command>
  446     <group choice='plain'>
  447         <group choice='req'>
  448             <arg choice='plain'><option>-f=&synopsis-param-filename;</option></arg>
  449             <arg choice='plain'>
  450                 <group choice='req'>
  451                     <arg choice='plain'>auto</arg>
  452                     <arg choice='plain'>manual</arg>
  453                 </group>
  454                 &synopsis-arg-pkg;
  455             </arg>
  456             <arg choice='plain'>
  457                 <group choice='req'>
  458                     <arg choice='plain'>showauto</arg>
  459                     <arg choice='plain'>showmanual</arg>
  460                 </group>
  461                 <arg choice='opt' rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg>
  462             </arg>
  463         </group>
  464         &synopsis-help;
  465     </group>
  466 </cmdsynopsis><cmdsynopsis><command>apt-mark</command>
  467     <group choice='plain'>
  468         <arg choice='plain'>
  469             <group choice='req'>
  470                 <arg choice='plain'>hold</arg>
  471                 <arg choice='plain'>unhold</arg>
  472                 <arg choice='plain'>install</arg>
  473                 <arg choice='plain'>remove</arg>
  474                 <arg choice='plain'>purge</arg>
  475             </group>
  476             &synopsis-arg-pkg;
  477         </arg>
  478         <arg choice='plain'>
  479             <group choice='req'>
  480                 <arg choice='plain'>showhold</arg>
  481                 <arg choice='plain'>showinstall</arg>
  482                 <arg choice='plain'>showremove</arg>
  483                 <arg choice='plain'>showpurge</arg>
  484             </group>
  485             <arg choice='opt' rep='repeat'><replaceable>&synopsis-pkg;</replaceable></arg>
  486         </arg>
  487     </group>
  488 </cmdsynopsis></refsynopsisdiv>">
  489 <!ENTITY synopsis-command-apt-sortpkgs "<refsynopsisdiv><cmdsynopsis>
  490     <command>apt-sortpkgs</command>
  491     <arg><option>-s</option></arg>
  492     &synopsis-arg-option;
  493     &synopsis-arg-config;
  494     <arg choice='plain' rep='repeat'>&synopsis-param-filename;</arg>
  495     &synopsis-help;
  496 </cmdsynopsis></refsynopsisdiv>">