You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
355 lines
10 KiB
355 lines
10 KiB
<!-- -*- 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 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>
|
|
|
|
</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</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</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</option></term>
|
|
<term><option>--help</option></term>
|
|
<listitem><para>Show a short usage summary.
|
|
</para>
|
|
</listitem>
|
|
</varlistentry>
|
|
|
|
<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.
|
|
</para>
|
|
</listitem>
|
|
</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
|
|
descriptions indicate the configuration option to set. For boolean
|
|
options you can override the config file by using something like
|
|
<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>
|
|
">
|
|
|