<!-- Some common paths.. -->
<!ENTITY docdir "/usr/share/doc/apt/">
-<!ENTITY configureindex "<filename>&docdir;/examples/configure-index</>">
-<!ENTITY aptconfdir "<filename>/etc/apt.conf</>">
+<!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/</RefEntryTitle>
- <ManVolNum/5/
- </CiteRefEntry>
-">
+<!ENTITY apt-conf "<citerefentry>
+ <refentrytitle><filename>apt.conf</filename></refentrytitle>
+ <manvolnum>5</manvolnum>
+ </citerefentry>"
+>
-<!ENTITY apt-get "
- <CiteRefEntry>
- <RefEntryTitle><command/apt-get/</RefEntryTitle>
- <ManVolNum/8/
- </CiteRefEntry>
-">
+<!ENTITY apt-get "<citerefentry>
+ <refentrytitle><command>apt-get</command></refentrytitle>
+ <manvolnum>8</manvolnum>
+ </citerefentry>"
+>
-<!ENTITY apt-cdrom "
- <CiteRefEntry>
- <RefEntryTitle><command/apt-cdrom/</RefEntryTitle>
- <ManVolNum/8/
- </CiteRefEntry>
-">
+<!ENTITY apt-config "<citerefentry>
+ <refentrytitle><command>apt-config</command></refentrytitle>
+ <manvolnum>8</manvolnum>
+ </citerefentry>"
+>
-<!ENTITY apt-cache "
- <CiteRefEntry>
- <RefEntryTitle><command/apt-cache/</RefEntryTitle>
- <ManVolNum/8/
- </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 gnome-apt "<citerefentry>
+ <refentrytitle><command>gnome-apt</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>
-<!ENTITY sources-list "
- <CiteRefEntry>
- <RefEntryTitle><filename/sources.list/</RefEntryTitle>
- <ManVolNum/5/
- </CiteRefEntry>
+ </refentryinfo>
+">
+
+<!ENTITY apt-email "
+ <address>
+ <email>apt@packages.debian.org</email>
+ </address>
">
-<!ENTITY bug "
- <CiteRefEntry>
- <RefEntryTitle><command/bug/</RefEntryTitle>
- <ManVolNum/1/
- </CiteRefEntry>
+<!ENTITY apt-author.jgunthorpe "
+ <author>
+ <firstname>Jason</firstname>
+ <surname>Gunthorpe</surname>
+ <contrib></contrib>
+ </author>
">
-<!ENTITY dpkg "
- <CiteRefEntry>
- <RefEntryTitle><command/dpkg/</RefEntryTitle>
- <ManVolNum/8/
- </CiteRefEntry>
+<!ENTITY apt-author.moconnor "
+ <author>
+ <firstname>Mike</firstname>
+ <surname>O'Connor</surname>
+ <contrib></contrib>
+ </author>
">
-<!ENTITY dpkg-buildpackage "
- <CiteRefEntry>
- <RefEntryTitle><command/dpkg-buildpackage/</RefEntryTitle>
- <ManVolNum/1/
- </CiteRefEntry>
+<!ENTITY apt-author.team "
+ <author>
+ <othername>APT team</othername>
+ <contrib></contrib>
+ </author>
">
-<!ENTITY gzip "
- <CiteRefEntry>
- <RefEntryTitle><command/gzip/</RefEntryTitle>
- <ManVolNum/1/
- </CiteRefEntry>
+<!ENTITY apt-product "
+ <productname>Linux</productname>
">
-<!ENTITY dpkg-scanpackages "
- <CiteRefEntry>
- <RefEntryTitle><command/dpkg-scanpackages/</RefEntryTitle>
- <ManVolNum/8/
- </CiteRefEntry>
+<!ENTITY apt-copyright "
+ <copyright>
+ <holder>Jason Gunthorpe</holder>
+ <year>1998-2001</year>
+ </copyright>
">
-<!ENTITY dpkg-scansources "
- <CiteRefEntry>
- <RefEntryTitle><command/dpkg-scansources/</RefEntryTitle>
- <ManVolNum/8/
- </CiteRefEntry>
+<!ENTITY apt-product "
+ <productname>Linux</productname>
">
-<!ENTITY dselect "
- <CiteRefEntry>
- <RefEntryTitle><command/dselect/</RefEntryTitle>
- <ManVolNum/8/
- </CiteRefEntry>
+<!ENTITY apt-qapage "
+ <para>
+ <ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>
+ </para>
">
-
-<!-- Boiler plate docinfo section -->
-<!ENTITY apt-docinfo "
- <docinfo>
- <address><email>apt@packages.debian.org</></address>
- <author><firstname>Jason</> <surname>Gunthorpe</></>
- <copyright><year>1998-2000</> <holder>Jason Gunthorpe</></>
- <date>20 September 2000</>
- </docinfo>
-">
<!-- Boiler plate Bug reporting section -->
<!ENTITY manbugs "
- <RefSect1><Title>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>
+ <refsect1><title>Bugs</title>
+ <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>.
+ If you wish to report a bug in APT, please see
+ <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the
+ &reportbug; command.
+ </para>
+ </refsect1>
">
<!-- Boiler plate Author section -->
<!ENTITY manauthor "
- <RefSect1><Title>Author</>
- <para>
- APT was written by the APT team <email>apt@packages.debian.org</>.
- </RefSect1>
+ <refsect1><title>Author</title>
+ <para>APT was written by the APT team <email>apt@packages.debian.org</email>.
+ </para>
+ </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>-h</option></term>
+ <term><option>--help</option></term>
+ <listitem><para>Show a short usage summary.
+ </para>
+ </listitem>
+ </varlistentry>
- <VarListEntry><term><option/-v/</><term><option/--version/</>
- <ListItem><Para>
- Show the program verison.
- </VarListEntry>
-
- <VarListEntry><term><option/-c/</><term><option/--config-file/</>
- <ListItem><Para>
- Configuration File; Specify a configuration file to use.
+ <varlistentry>
+ <term><option>-v</option></term>
+ <term><option>--version</option></term>
+ <listitem><para>Show the program version.
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
+ <term><option>-c</option></term>
+ <term><option>--config-file</option></term>
+ <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>
+ </para>
+ </listitem>
+ </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>
+ <varlistentry>
+ <term><option>-o</option></term>
+ <term><option>--option</option></term>
+ <listitem><para>Set a Configuration Option; This will set an arbitrary
+ configuration option. The syntax is <option>-o Foo::Bar=bar</option>.
+ <option>-o</option> and <option>--option</option> can be used multiple
+ times to set different options.
+ </para>
+ </listitem>
+ </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
+ <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.
+ <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
+ or several other variations.
</para>
">
+
+<!ENTITY file-aptconf "
+ <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
+ <listitem><para>APT configuration file.
+ Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
+ <listitem><para>APT configuration file fragments.
+ Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem>
+ </varlistentry>
+">
+
+<!ENTITY file-cachearchives "
+ <varlistentry><term><filename>&cachedir;/archives/</filename></term>
+ <listitem><para>Storage area for retrieved package files.
+ Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
+ <listitem><para>Storage area for package files in transit.
+ Configuration Item: <literal>Dir::Cache::Archives</literal> (implicit partial). </para></listitem>
+ </varlistentry>
+">
+
+<!ENTITY file-preferences "
+ <varlistentry><term><filename>/etc/apt/preferences</filename></term>
+ <listitem><para>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: <literal>Dir::Etc::Preferences</literal>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>
+ <listitem><para>File fragments for the version preferences.
+ Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>
+ </varlistentry>
+">
+
+<!ENTITY file-sourceslist "
+ <varlistentry><term><filename>/etc/apt/sources.list</filename></term>
+ <listitem><para>Locations to fetch packages from.
+ Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>
+ <listitem><para>File fragments for locations to fetch packages from.
+ Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem>
+ </varlistentry>
+">
+
+<!ENTITY file-statelists "
+ <varlistentry><term><filename>&statedir;/lists/</filename></term>
+ <listitem><para>Storage area for state information for each package resource specified in
+ &sources-list;
+ Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
+ <listitem><para>Storage area for state information in transit.
+ Configuration Item: <literal>Dir::State::Lists</literal> (implicit partial).</para></listitem>
+ </varlistentry>
+">
+
+<!ENTITY file-trustedgpg "
+ <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>
+ <listitem><para>Keyring of local trusted keys, new keys will be added here.
+ Configuration Item: <literal>Dir::Etc::Trusted</literal>.</para></listitem>
+ </varlistentry>
+
+ <varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term>
+ <listitem><para>File fragments for the trusted keys, additional keyrings can
+ be stored here (by other packages or the administrator).
+ Configuration Item <literal>Dir::Etc::TrustedParts</literal>.</para></listitem>
+ </varlistentry>
+">
projects / apt.git / blobdiff