X-Git-Url: https://git.hcoop.net/ntk/apt.git/blobdiff_plain/2d425135df32b7700762d65e0316351537e94c63..6dd8400ca787ef832d87121f304f98ad152dc3a6:/doc/apt.ent diff --git a/doc/apt.ent b/doc/apt.ent dissimilarity index 76% index c691f64c..494c6b02 100644 --- a/doc/apt.ent +++ b/doc/apt.ent @@ -1,145 +1,392 @@ - - - - -&docdir;examples/configure-index.gz"> -/etc/apt.conf"> - - - - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - - "> - - - -
apt@packages.debian.org
- Jason Gunthorpe - 1998-2001 Jason Gunthorpe - 12 March 2001 - -"> - - -Bugs</> - <para> - See the <ulink url='http://bugs.debian.org/apt'>APT bug page</>. - If you wish to report a bug in APT, please see - <filename>/usr/share/doc/debian/bug-reporting.txt</> or the &bug; command. - </RefSect1> -"> - -<!-- Boiler plate Author section --> -<!ENTITY manauthor " - <RefSect1><Title>Author</> - <para> - APT was written by the APT team <email>apt@packages.debian.org</>. - </RefSect1> -"> - -<!-- Should be used within the option section of the text to - put in the blurb about -h, -v, -c and -o --> -<!ENTITY apt-commonoptions " - <VarListEntry><term><option/-h/</><term><option/--help/</> - <ListItem><Para> - Show a short usage summary. - </VarListEntry> - - <VarListEntry><term><option/-v/</><term><option/--version/</> - <ListItem><Para> - Show the program version. - </VarListEntry> - - <VarListEntry><term><option/-c/</><term><option/--config-file/</> - <ListItem><Para> - Configuration File; Specify a configuration file to use. - The program will read the default configuration file and then this - configuration file. See &apt-conf; for syntax information. - </VarListEntry> - - <VarListEntry><term><option/-o/</><term><option/--option/</> - <ListItem><Para> - Set a Configuration Option; This will set an arbitary configuration - option. The syntax is <option>-o Foo::Bar=bar</>. - </VarListEntry> -"> - -<!-- Should be used within the option section of the text to - put in the blurb about -h, -v, -c and -o --> -<!ENTITY apt-cmdblurb " - <para> - All command line options may be set using the configuration file, the - descriptions indicate the configuration option to set. For boolean - options you can override the config file by using something like - <option/-f-/,<option/--no-f/, <option/-f=no/ or several other variations. - </para> -"> +<!-- -*- mode: sgml; mode: fold -*- --> + +<!-- Some common paths.. --> +<!ENTITY docdir "/usr/share/doc/apt/"> +<!ENTITY guidesdir "/usr/share/doc/apt-doc/"> +<!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</filename>"> +<!ENTITY aptconfdir "<filename>/etc/apt.conf</filename>"> +<!ENTITY statedir "/var/lib/apt"> +<!ENTITY cachedir "/var/cache/apt"> + +<!-- Cross references to other man pages --> +<!ENTITY apt-conf "<citerefentry> + <refentrytitle><filename>apt.conf</filename></refentrytitle> + <manvolnum>5</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-get "<citerefentry> + <refentrytitle><command>apt-get</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-config "<citerefentry> + <refentrytitle><command>apt-config</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-cdrom "<citerefentry> + <refentrytitle><command>apt-cdrom</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-cache "<citerefentry> + <refentrytitle><command>apt-cache</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-preferences "<citerefentry> + <refentrytitle><command>apt_preferences</command></refentrytitle> + <manvolnum>5</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-key "<citerefentry> + <refentrytitle><command>apt-key</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-secure "<citerefentry> + <refentrytitle>apt-secure</refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY apt-ftparchive "<citerefentry> + <refentrytitle><filename>apt-ftparchive</filename></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + + +<!ENTITY sources-list "<citerefentry> + <refentrytitle><filename>sources.list</filename></refentrytitle> + <manvolnum>5</manvolnum> + </citerefentry>" +> + +<!ENTITY reportbug "<citerefentry> + <refentrytitle><command>reportbug</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY dpkg "<citerefentry> + <refentrytitle><command>dpkg</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY dpkg-buildpackage "<citerefentry> + <refentrytitle><command>dpkg-buildpackage</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY gzip "<citerefentry> + <refentrytitle><command>gzip</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY dpkg-scanpackages "<citerefentry> + <refentrytitle><command>dpkg-scanpackages</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY dpkg-scansources "<citerefentry> + <refentrytitle><command>dpkg-scansources</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY dselect "<citerefentry> + <refentrytitle><command>dselect</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY aptitude "<citerefentry> + <refentrytitle><command>aptitude</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY synaptic "<citerefentry> + <refentrytitle><command>synaptic</command></refentrytitle> + <manvolnum>8</manvolnum> + </citerefentry>" +> + +<!ENTITY debsign "<citerefentry> + <refentrytitle><command>debsign</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY debsig-verify "<citerefentry> + <refentrytitle><command>debsig-verify</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY gpg "<citerefentry> + <refentrytitle><command>gpg</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!ENTITY wajig "<citerefentry> + <refentrytitle><command>wajig</command></refentrytitle> + <manvolnum>1</manvolnum> + </citerefentry>" +> + +<!-- Boiler plate docinfo section --> +<!ENTITY apt-docinfo " + <refentryinfo> + <address><email>apt@packages.debian.org</email></address> + <author> + <firstname>Jason</firstname> <surname>Gunthorpe</surname> + <contrib></contrib> + </author> + <copyright><year>1998-2001</year> <holder>Jason Gunthorpe</holder></copyright> + <date>28 October 2008</date> + <productname>Linux</productname> + + </refentryinfo> +"> + +<!ENTITY apt-email " + <address> + <email>apt@packages.debian.org</email> + </address> +"> + +<!ENTITY apt-author.jgunthorpe " + <author> + <firstname>Jason</firstname> + <surname>Gunthorpe</surname> + <contrib></contrib> + </author> +"> + +<!ENTITY apt-author.moconnor " + <author> + <firstname>Mike</firstname> + <surname>O'Connor</surname> + <contrib></contrib> + </author> +"> + +<!ENTITY apt-author.team " + <author> + <othername>APT team</othername> + <contrib></contrib> + </author> +"> + +<!ENTITY apt-product " + <productname>Linux</productname> +"> + +<!ENTITY apt-copyright " + <copyright> + <holder>Jason Gunthorpe</holder> + <year>1998-2001</year> + </copyright> +"> + +<!ENTITY apt-product " + <productname>Linux</productname> +"> + +<!ENTITY apt-qapage " + <para> + <ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink> + </para> +"> + +<!-- Boiler plate Bug reporting section --> +<!ENTITY manbugs " + <refsect1><title>Bugs + APT bug page. + If you wish to report a bug in APT, please see + /usr/share/doc/debian/bug-reporting.txt or the + &reportbug; command. + + +"> + + +Author + APT was written by the APT team apt@packages.debian.org. + + +"> + + + + + Show a short usage summary. + + + + + + + + Show the program version. + + + + + + + + Configuration File; Specify a configuration file to use. + The program will read the default configuration file and then this + configuration file. If configuration settings need to be set before the + default configuration files are parsed specify a file with the APT_CONFIG + environment variable. See &apt-conf; for syntax information. + + + + + + + + Set a Configuration Option; This will set an arbitrary + configuration option. The syntax is . + and can be used multiple + times to set different options. + + + +"> + + +All command line options may be set using the configuration file, the + descriptions indicate the configuration option to set. For boolean + options you can override the config file by using something like + ,, + or several other variations. + +"> + +/etc/apt/apt.conf + APT configuration file. + Configuration Item: Dir::Etc::Main. + + + /etc/apt/apt.conf.d/ + APT configuration file fragments. + Configuration Item: Dir::Etc::Parts. + +"> + +&cachedir;/archives/ + Storage area for retrieved package files. + Configuration Item: Dir::Cache::Archives. + + + &cachedir;/archives/partial/ + Storage area for package files in transit. + Configuration Item: Dir::Cache::Archives (implicit partial). + +"> + +/etc/apt/preferences + Version preferences file. + This is where you would specify "pinning", + i.e. a preference to get certain packages + from a separate source + or from a different version of a distribution. + Configuration Item: Dir::Etc::Preferences. + + + /etc/apt/preferences.d/ + File fragments for the version preferences. + Configuration Item: Dir::Etc::PreferencesParts. + +"> + +/etc/apt/sources.list + Locations to fetch packages from. + Configuration Item: Dir::Etc::SourceList. + + + /etc/apt/sources.list.d/ + File fragments for locations to fetch packages from. + Configuration Item: Dir::Etc::SourceParts. + +"> + +&statedir;/lists/ + Storage area for state information for each package resource specified in + &sources-list; + Configuration Item: Dir::State::Lists. + + + &statedir;/lists/partial/ + Storage area for state information in transit. + Configuration Item: Dir::State::Lists (implicit partial). + +"> + +/etc/apt/trusted.gpg + Keyring of local trusted keys, new keys will be added here. + Configuration Item: Dir::Etc::Trusted. + + + /etc/apt/trusted.gpg.d/ + File fragments for the trusted keys, additional keyrings can + be stored here (by other packages or the administrator). + Configuration Item Dir::Etc::TrustedParts. + +"> + + + + + +john@doe.org in 2009, + 2010 and Daniela Acme daniela@acme.us in 2010 together with the + Debian Dummy l10n Team debian-l10n-dummy@lists.debian.org. +"> + + + + + + +