document the pkg:any specialcasing in FindPkg as well to make it clear

[apt.git] / doc / apt.ent

<!-- -*- mode: sgml; mode: fold -*- -->

<!-- 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-author.team "
   <author>
    <othername>APT team</othername>
    <contrib></contrib>
   </author>
">

<!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. 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>
     
     <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 &quot;pinning&quot;,
     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>
">

<!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.
">