doc/apt.ent

   1 <!ENTITY apt-author.team "
   2    <author>
   3     <othername>APT team</othername>
   4     <contrib></contrib>
   5    </author>
   6 ">
   7
   8 <!ENTITY apt-qapage "
   9         <para>
  10                 <ulink url='http://packages.qa.debian.org/a/apt.html'>QA Page</ulink>
  11         </para>
  12 ">
  13
  14 <!-- Boiler plate Bug reporting section -->
  15 <!ENTITY manbugs "
  16  <refsect1><title>Bugs</title>
  17    <para><ulink url='http://bugs.debian.org/src:apt'>APT bug page</ulink>.
  18    If you wish to report a bug in APT, please see
  19    <filename>/usr/share/doc/debian/bug-reporting.txt</filename> or the
  20    &reportbug; command.
  21    </para>
  22  </refsect1>
  23 ">
  24
  25 <!-- Boiler plate Author section -->
  26 <!ENTITY manauthor "
  27  <refsect1><title>Author</title>
  28    <para>APT was written by the APT team <email>apt@packages.debian.org</email>.
  29    </para>
  30  </refsect1>
  31 ">
  32
  33 <!-- Should be used within the option section of the text to
  34      put in the blurb about -h, -v, -c and -o -->
  35 <!ENTITY apt-commonoptions "
  36      <varlistentry><term><option>-h</option></term>
  37      <term><option>--help</option></term>
  38      <listitem><para>Show a short usage summary.
  39      </para>
  40      </listitem>
  41      </varlistentry>
  42
  43      <varlistentry>
  44       <term><option>-v</option></term>
  45       <term><option>--version</option></term>
  46       <listitem><para>Show the program version.
  47      </para>
  48      </listitem>
  49      </varlistentry>
  50
  51      <varlistentry>
  52       <term><option>-c</option></term>
  53       <term><option>--config-file</option></term>
  54      <listitem><para>Configuration File; Specify a configuration file to use.
  55      The program will read the default configuration file and then this
  56      configuration file. If configuration settings need to be set before the
  57      default configuration files are parsed specify a file with the <envar>APT_CONFIG</envar>
  58      environment variable. See &apt-conf; for syntax information.
  59      </para>
  60      </listitem>
  61      </varlistentry>
  62
  63      <varlistentry>
  64       <term><option>-o</option></term>
  65       <term><option>--option</option></term>
  66      <listitem><para>Set a Configuration Option; This will set an arbitrary
  67       configuration option. The syntax is <option>-o Foo::Bar=bar</option>.
  68       <option>-o</option> and <option>--option</option> can be used multiple
  69       times to set different options.
  70      </para>
  71      </listitem>
  72      </varlistentry>
  73 ">
  74
  75 <!-- Should be used within the option section of the text to
  76      put in the blurb about -h, -v, -c and -o -->
  77 <!ENTITY apt-cmdblurb "
  78    <para>All command line options may be set using the configuration file, the
  79    descriptions indicate the configuration option to set. For boolean
  80    options you can override the config file by using something like
  81    <option>-f-</option>,<option>--no-f</option>, <option>-f=no</option>
  82    or several other variations.
  83    </para>
  84 ">
  85
  86 <!ENTITY file-aptconf "
  87      <varlistentry><term><filename>/etc/apt/apt.conf</filename></term>
  88      <listitem><para>APT configuration file.
  89      Configuration Item: <literal>Dir::Etc::Main</literal>.</para></listitem>
  90      </varlistentry>
  91
  92      <varlistentry><term><filename>/etc/apt/apt.conf.d/</filename></term>
  93      <listitem><para>APT configuration file fragments.
  94      Configuration Item: <literal>Dir::Etc::Parts</literal>.</para></listitem>
  95      </varlistentry>
  96 ">
  97
  98 <!ENTITY file-cachearchives "
  99      <varlistentry><term><filename>&cachedir;/archives/</filename></term>
 100      <listitem><para>Storage area for retrieved package files.
 101      Configuration Item: <literal>Dir::Cache::Archives</literal>.</para></listitem>
 102      </varlistentry>
 103
 104      <varlistentry><term><filename>&cachedir;/archives/partial/</filename></term>
 105      <listitem><para>Storage area for package files in transit.
 106      Configuration Item: <literal>Dir::Cache::Archives</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>
 107      </varlistentry>
 108 ">
 109
 110 <!ENTITY file-preferences "
 111      <varlistentry><term><filename>/etc/apt/preferences</filename></term>
 112      <listitem><para>Version preferences file.
 113      This is where you would specify &quot;pinning&quot;,
 114      i.e. a preference to get certain packages
 115      from a separate source
 116      or from a different version of a distribution.
 117      Configuration Item: <literal>Dir::Etc::Preferences</literal>.</para></listitem>
 118      </varlistentry>
 119
 120      <varlistentry><term><filename>/etc/apt/preferences.d/</filename></term>
 121      <listitem><para>File fragments for the version preferences.
 122      Configuration Item: <literal>Dir::Etc::PreferencesParts</literal>.</para></listitem>
 123      </varlistentry>
 124 ">
 125
 126 <!ENTITY file-sourceslist "
 127      <varlistentry><term><filename>/etc/apt/sources.list</filename></term>
 128      <listitem><para>Locations to fetch packages from.
 129      Configuration Item: <literal>Dir::Etc::SourceList</literal>.</para></listitem>
 130      </varlistentry>
 131
 132      <varlistentry><term><filename>/etc/apt/sources.list.d/</filename></term>
 133      <listitem><para>File fragments for locations to fetch packages from.
 134      Configuration Item: <literal>Dir::Etc::SourceParts</literal>.</para></listitem>
 135      </varlistentry>
 136 ">
 137
 138 <!ENTITY file-statelists "
 139      <varlistentry><term><filename>&statedir;/lists/</filename></term>
 140      <listitem><para>Storage area for state information for each package resource specified in
 141      &sources-list;
 142      Configuration Item: <literal>Dir::State::Lists</literal>.</para></listitem>
 143      </varlistentry>
 144
 145      <varlistentry><term><filename>&statedir;/lists/partial/</filename></term>
 146      <listitem><para>Storage area for state information in transit.
 147      Configuration Item: <literal>Dir::State::Lists</literal> (<filename>partial</filename> will be implicitly appended)</para></listitem>
 148      </varlistentry>
 149 ">
 150
 151 <!ENTITY file-trustedgpg "
 152      <varlistentry><term><filename>/etc/apt/trusted.gpg</filename></term>
 153      <listitem><para>Keyring of local trusted keys, new keys will be added here.
 154      Configuration Item: <literal>Dir::Etc::Trusted</literal>.</para></listitem>
 155      </varlistentry>
 156
 157      <varlistentry><term><filename>/etc/apt/trusted.gpg.d/</filename></term>
 158      <listitem><para>File fragments for the trusted keys, additional keyrings can
 159      be stored here (by other packages or the administrator).
 160      Configuration Item <literal>Dir::Etc::TrustedParts</literal>.</para></listitem>
 161      </varlistentry>
 162 ">
 163
 164 <!ENTITY file-extended_states "
 165       <varlistentry><term><filename>/var/lib/apt/extended_states</filename></term>
 166       <listitem><para>Status list of auto-installed packages.
 167       Configuration Item: <literal>Dir::State::extended_states</literal>.
 168       </para></listitem>
 169       </varlistentry>
 170 ">
 171
 172 <!-- TRANSLATOR: This is the section header for the following paragraphs - comparable
 173      to the other headers like NAME and DESCRIPTION and should therefore be uppercase. -->
 174 <!ENTITY translation-title "TRANSLATION">
 175
 176 <!-- TRANSLATOR: This is a placeholder. You should write here who has contributed
 177      to the translation in the past, who is responsible now and maybe further information
 178      specially related to your translation. -->
 179 <!ENTITY translation-holder "
 180      The english translation was done by John Doe <email>john@doe.org</email> in 2009,
 181      2010 and Daniela Acme <email>daniela@acme.us</email> in 2010 together with the
 182      Debian Dummy l10n Team <email>debian-l10n-dummy@lists.debian.org</email>.
 183 ">
 184
 185 <!-- TRANSLATOR: As a translation is allowed to have 20% of untranslated/fuzzy strings
 186      in a shipped manpage newer/modified paragraphs will maybe appear in english in
 187      the generated manpage. This sentence is therefore here to tell the reader that this
 188      is not a mistake by the translator - obviously the target is that at least for stable
 189      releases this sentence is not needed. :) -->
 190 <!ENTITY translation-english "
 191      Note that this translated document may contain untranslated parts.
 192      This is done on purpose, to avoid losing content when the
 193      translation is lagging behind the original content.
 194 ">
 195
 196 <!-- TRANSLATOR: used as in -o=config_string  e.g. -o=Debug::pkgProblemResolver=1 -->
 197 <!ENTITY synopsis-config-string "config_string">
 198
 199 <!-- TRANSLATOR: used as in -c=config_file  e.g. -c=./apt.conf -->
 200 <!ENTITY synopsis-config-file "config_file">
 201
 202 <!-- TRANSLATOR: used as in -t=target_release or pkg/target_release  e.g. -t=squeeze apt/experimental -->
 203 <!ENTITY synopsis-target-release "target_release">
 204
 205 <!-- TRANSLATOR: used as in -a=architecture  e.g. -a=armel -->
 206 <!ENTITY synopsis-architecture "architecture">
 207
 208 <!-- TRANSLATOR: used as in apt-get install pkg  e.g. apt-get install awesome -->
 209 <!ENTITY synopsis-pkg "pkg">
 210
 211 <!-- TRANSLATOR: used as in pkg=pkg_version_number  e.g. apt=0.8.15 -->
 212 <!ENTITY synopsis-pkg-ver-number "pkg_version_number">
 213
 214 <!-- TRANSLATOR: used as in apt-cache pkgnames prefix  e.g. apt-cache pkgnames apt -->
 215 <!ENTITY synopsis-prefix "prefix">
 216
 217 <!-- TRANSLATOR: used as in apt-cache search regex  e.g. apt-cache search awesome -->
 218 <!ENTITY synopsis-regex "regex">
 219
 220 <!-- TRANSLATOR: used as in apt-cdrom -d=cdrom_mount_point  e.g. apt-cdrom -d=/media/cdrom -->
 221 <!ENTITY synopsis-cdrom-mount "cdrom_mount_point">
 222
 223 <!-- TRANSLATOR: used as in apt-extracttemplates -t=temporary_directory  e.g. apt-extracttemplates -t=/tmp -->
 224 <!ENTITY synopsis-tmp-directory "temporary_directory">
 225
 226 <!-- TRANSLATOR: used as in apt-extracttemplates filename -->
 227 <!ENTITY synopsis-filename "filename">
 228
 229 <!-- TRANSLATOR: used as parameter for apt-ftparchive  e.g. apt-ftparchive packages path override-file pathprefix -->
 230 <!ENTITY synopsis-path "path">
 231
 232 <!-- TRANSLATOR: used as parameter for apt-ftparchive  e.g. apt-ftparchive packages path override-file pathprefix -->
 233 <!ENTITY synopsis-override "override-file">
 234
 235 <!-- TRANSLATOR: used as parameter for apt-ftparchive  e.g. apt-ftparchive packages path override-file pathprefix -->
 236 <!ENTITY synopsis-pathprefix "pathprefix">
 237
 238 <!-- TRANSLATOR: used as parameter for apt-ftparchive  e.g. apt-ftparchive generate section -->
 239 <!ENTITY synopsis-section "section">
 240
 241 <!-- TRANSLATOR: used as in apt-key export keyid  e.g. apt-key export 473041FA -->
 242 <!ENTITY synopsis-keyid "keyid">
 243