X-Git-Url: https://git.saurik.com/apt.git/blobdiff_plain/e3a1f08d41bf6ef6a42bbc6e5f8e20f7b4aa37a0..766761fd836d9e247daea924809965c21cc65dc7:/doc/apt.ent diff --git a/doc/apt.ent b/doc/apt.ent index 44e303495..6a3837b95 100644 --- a/doc/apt.ent +++ b/doc/apt.ent @@ -1,216 +1,20 @@ -<!-- -*- 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-archive "<citerefentry> - <refentrytitle><filename>apt-archive</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>8</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>8</manvolnum> - </citerefentry>" -> - -<!ENTITY dpkg-scansources "<citerefentry> - <refentrytitle><command>dpkg-scansources</command></refentrytitle> - <manvolnum>8</manvolnum> - </citerefentry>" -> - -<!ENTITY dselect "<citerefentry> - <refentrytitle><command>dselect</command></refentrytitle> - <manvolnum>8</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>" -> - -<!-- Boiler plate docinfo section --> -<!ENTITY apt-docinfo " - <refentryinfo> - <address><email>apt@packages.debian.org</email></address> - <author><firstname>Jason</firstname> <surname>Gunthorpe</surname></author> - <copyright><year>1998-2001</year> <holder>Jason Gunthorpe</holder></copyright> - <date>14 December 2003</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> - </author> -"> - <!ENTITY apt-author.team " <author> <othername>APT team</othername> + <contrib></contrib> </author> "> -<!ENTITY apt-product " - <productname>Linux</productname> -"> - -<!ENTITY apt-email " - <address> - <email>apt@packages.debian.org</email> - </address> -"> - -<!ENTITY apt-author.jgunthorpe " - <author> - <firstname>Jason</firstname> - <surname>Gunthorpe</surname> - </author> -"> - -<!ENTITY apt-author.team " - <author> - <othername>APT team</othername> - </author> -"> - -<!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>. + <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. @@ -249,7 +53,9 @@ <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. + configuration file. If configuration settings need to be set before the + default configuration files are parsed specify a file with the <envar>APT_CONFIG</envar> + environment variable. See &apt-conf; for syntax information. </para> </listitem> </varlistentry> @@ -259,6 +65,8 @@ <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> @@ -275,3 +83,161 @@ </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> (<filename>partial</filename> will be implicitly appended)</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> (<filename>partial</filename> will be implicitly appended)</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> +"> + +<!ENTITY file-extended_states " + <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term> + <listitem><para>Status list of auto-installed packages. + Configuration Item: <literal>Dir::State::extended_states</literal>. + </para></listitem> + </varlistentry> +"> + +<!-- TRANSLATOR: This is the section header for the following paragraphs - comparable + to the other headers like NAME and DESCRIPTION and should therefore be uppercase. --> +<!ENTITY translation-title "TRANSLATION"> + +<!-- TRANSLATOR: This is a placeholder. You should write here who has contributed + to the translation in the past, who is responsible now and maybe further information + specially related to your translation. --> +<!ENTITY translation-holder " + The english translation was done by John Doe <email>john@doe.org</email> in 2009, + 2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together with the + Debian Dummy l10n Team <email>debian-l10n-dummy@lists.debian.org</email>. +"> + +<!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings + in a shipped manpage newer/modified paragraphs will maybe appear in english in + the generated manpage. This sentence is therefore here to tell the reader that this + is not a mistake by the translator - obviously the target is that at least for stable + releases this sentence is not needed. :) --> +<!ENTITY translation-english " + Note that this translated document may contain untranslated parts. + This is done on purpose, to avoid losing content when the + translation is lagging behind the original content. +"> + +<!-- TRANSLATOR: used as in -o=config_string e.g. -o=Debug::pkgProblemResolver=1 --> +<!ENTITY synopsis-config-string "config_string"> + +<!-- TRANSLATOR: used as in -c=config_file e.g. -c=./apt.conf --> +<!ENTITY synopsis-config-file "config_file"> + +<!-- TRANSLATOR: used as in -t=target_release or pkg/target_release e.g. -t=squeeze apt/experimental --> +<!ENTITY synopsis-target-release "target_release"> + +<!-- TRANSLATOR: used as in -a=architecture e.g. -a=armel --> +<!ENTITY synopsis-architecture "architecture"> + +<!-- TRANSLATOR: used as in apt-get install pkg e.g. apt-get install awesome --> +<!ENTITY synopsis-pkg "pkg"> + +<!-- TRANSLATOR: used as in pkg=pkg_version_number e.g. apt=0.8.15 --> +<!ENTITY synopsis-pkg-ver-number "pkg_version_number"> + +<!-- TRANSLATOR: used as in apt-cache pkgnames prefix e.g. apt-cache pkgnames apt --> +<!ENTITY synopsis-prefix "prefix"> + +<!-- TRANSLATOR: used as in apt-cache search regex e.g. apt-cache search awesome --> +<!ENTITY synopsis-regex "regex"> + +<!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point e.g. apt-cdrom -d=/media/cdrom --> +<!ENTITY synopsis-cdrom-mount "cdrom_mount_point"> + +<!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory e.g. apt-extracttemplates -t=/tmp --> +<!ENTITY synopsis-tmp-directory "temporary_directory"> + +<!-- TRANSLATOR: used as in apt-extracttemplates filename --> +<!ENTITY synopsis-filename "filename"> + +<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> +<!ENTITY synopsis-path "path"> + +<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> +<!ENTITY synopsis-override "override-file"> + +<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive packages path override-file pathprefix --> +<!ENTITY synopsis-pathprefix "pathprefix"> + +<!-- TRANSLATOR: used as parameter for apt-ftparchive e.g. apt-ftparchive generate section --> +<!ENTITY synopsis-section "section"> + +<!-- TRANSLATOR: used as in apt-key export keyid e.g. apt-key export 473041FA --> +<!ENTITY synopsis-keyid "keyid"> +