Browse Source

in <term> mark all options with <option> and mark <term><option>

as untranslated for po4a removing ~200 unless "translateable" strings
tags/devuan/2.0.1+devuan1
David Kalnischkies 8 years ago
parent
commit
2b9b27c395
21 changed files with 1733 additions and 14244 deletions
  1. +2
    -0
      debian/changelog
  2. +16
    -16
      doc/apt-cache.8.xml
  3. +2
    -2
      doc/apt-cdrom.8.xml
  4. +2
    -2
      doc/apt-config.8.xml
  5. +3
    -2
      doc/apt-extracttemplates.1.xml
  6. +50
    -50
      doc/apt-ftparchive.1.xml
  7. +17
    -17
      doc/apt-get.8.xml
  8. +10
    -10
      doc/apt-key.8.xml
  9. +12
    -12
      doc/apt-mark.8.xml
  10. +69
    -69
      doc/apt.conf.5.xml
  11. +2
    -1
      doc/apt_preferences.5.xml
  12. +145
    -1333
      doc/po/apt-doc.pot
  13. +190
    -1371
      doc/po/de.po
  14. +174
    -1700
      doc/po/es.po
  15. +184
    -1668
      doc/po/fr.po
  16. +157
    -1353
      doc/po/it.po
  17. +179
    -1747
      doc/po/ja.po
  18. +171
    -1756
      doc/po/pl.po
  19. +172
    -1696
      doc/po/pt.po
  20. +158
    -1426
      doc/po/pt_BR.po
  21. +18
    -13
      doc/po4a.conf

+ 2
- 0
debian/changelog View File

@@ -38,6 +38,8 @@ apt (0.9.4) UNRELEASED; urgency=low
* doc/*.xml:
- add a few translator notes and reword some paragraphs to ensure that
translators and users alike can better understand them (Closes: #669409)
- in <term> mark all options with <option> and mark <term><option>
as untranslated for po4a removing ~200 unless "translateable" strings
* apt-pkg/aptconfiguration.cc:
- longcode Translation files are saved with encoded underscore,
so make sure to pick these files up as well for Acquire::Languages


+ 16
- 16
doc/apt-cache.8.xml View File

@@ -45,12 +45,12 @@
commands below must be present.</para>

<variablelist>
<varlistentry><term>gencaches</term>
<varlistentry><term><option>gencaches</option></term>
<listitem><para><literal>gencaches</literal> creates APT's package cache. This is done
implicitly by all commands needing this cache if it is missing or outdated.</para></listitem>
</varlistentry>

<varlistentry><term>showpkg <replaceable>&synopsis-pkg;</replaceable>…</term>
<varlistentry><term><option>showpkg</option> <option><replaceable>&synopsis-pkg;</replaceable>…</option></term>
<listitem><para><literal>showpkg</literal> displays information about the packages listed on the
command line. Remaining arguments are package names. The available
versions and reverse dependencies of each package listed are listed, as
@@ -84,7 +84,7 @@ Reverse Provides:
is best to consult the apt source code.</para></listitem>
</varlistentry>

<varlistentry><term>stats</term><listitem><para><literal>stats</literal> displays some statistics about the cache.
<varlistentry><term><option>stats</option></term><listitem><para><literal>stats</literal> displays some statistics about the cache.
No further arguments are expected. Statistics reported are:
<itemizedlist>
<listitem><para><literal>Total package names</literal> is the number of package names found
@@ -139,34 +139,34 @@ Reverse Provides:
</para></listitem>
</varlistentry>
<varlistentry><term>showsrc <replaceable>&synopsis-pkg;</replaceable>…</term>
<varlistentry><term><option>showsrc</option> <option><replaceable>&synopsis-pkg;</replaceable>…</option></term>
<listitem><para><literal>showsrc</literal> displays all the source package records that match
the given package names. All versions are shown, as well as all
records that declare the name to be a Binary.</para></listitem>
</varlistentry>
<varlistentry><term>dump</term>
<varlistentry><term><option>dump</option></term>
<listitem><para><literal>dump</literal> shows a short listing of every package in the cache. It is
primarily for debugging.</para></listitem>
</varlistentry>

<varlistentry><term>dumpavail</term>
<varlistentry><term><option>dumpavail</option></term>
<listitem><para><literal>dumpavail</literal> prints out an available list to stdout. This is
suitable for use with &dpkg; and is used by the &dselect; method.</para></listitem>
</varlistentry>

<varlistentry><term>unmet</term>
<varlistentry><term><option>unmet</option></term>
<listitem><para><literal>unmet</literal> displays a summary of all unmet dependencies in the
package cache.</para></listitem>
</varlistentry>

<varlistentry><term>show <replaceable>&synopsis-pkg;</replaceable>…</term>
<varlistentry><term><option>show</option> <option><replaceable>&synopsis-pkg;</replaceable>…</option></term>
<listitem><para><literal>show</literal> performs a function similar to
<command>dpkg --print-avail</command>; it displays the package records for the
named packages.</para></listitem>
</varlistentry>

<varlistentry><term>search <replaceable>&synopsis-regex;</replaceable>…</term>
<varlistentry><term><option>search</option> <option><replaceable>&synopsis-regex;</replaceable>…</option></term>
<listitem><para><literal>search</literal> performs a full text search on all available package
lists for the POSIX regex pattern given, see
<citerefentry><refentrytitle><command>regex</command></refentrytitle>
@@ -184,17 +184,17 @@ Reverse Provides:
are and'ed together.</para></listitem>
</varlistentry>

<varlistentry><term>depends <replaceable>&synopsis-pkg;</replaceable>…</term>
<varlistentry><term><option>depends</option> <option><replaceable>&synopsis-pkg;</replaceable>…</option></term>
<listitem><para><literal>depends</literal> shows a listing of each dependency a package has
and all the possible other packages that can fulfill that dependency.</para></listitem>
</varlistentry>

<varlistentry><term>rdepends <replaceable>&synopsis-pkg;</replaceable>…</term>
<varlistentry><term><option>rdepends</option> <option><replaceable>&synopsis-pkg;</replaceable>…</option></term>
<listitem><para><literal>rdepends</literal> shows a listing of each reverse dependency a
package has.</para></listitem>
</varlistentry>

<varlistentry><term>pkgnames [ <replaceable>&synopsis-prefix;</replaceable> ]</term>
<varlistentry><term><option>pkgnames</option> <optional><replaceable>&synopsis-prefix;</replaceable></optional></term>
<listitem><para>This command prints the name of each package APT knows. The optional
argument is a prefix match to filter the name list. The output is suitable
for use in a shell tab complete function and the output is generated
@@ -205,7 +205,7 @@ Reverse Provides:
</para></listitem>
</varlistentry>
<varlistentry><term>dotty <replaceable>&synopsis-pkg;</replaceable>…</term>
<varlistentry><term><option>dotty</option> <option><replaceable>&synopsis-pkg;</replaceable>…</option></term>
<listitem><para><literal>dotty</literal> takes a list of packages on the command line and
generates output suitable for use by dotty from the
<ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</ulink>
@@ -223,19 +223,19 @@ Reverse Provides:
<para>Caution, dotty cannot graph larger sets of packages.</para></listitem>
</varlistentry>
<varlistentry><term>xvcg <replaceable>&synopsis-pkg;</replaceable></term>
<varlistentry><term><option>xvcg</option> <option><replaceable>&synopsis-pkg;</replaceable>…</option></term>
<listitem><para>The same as <literal>dotty</literal>, only for xvcg from the
<ulink url="http://rw4.cs.uni-sb.de/users/sander/html/gsvcg1.html">VCG tool</ulink>.
</para></listitem></varlistentry>

<varlistentry><term>policy [ <replaceable>&synopsis-pkg;</replaceable>… ]</term>
<varlistentry><term><option>policy</option> <optional><replaceable>&synopsis-pkg;</replaceable>…</optional></term>
<listitem><para><literal>policy</literal> is meant to help debug issues relating to the
preferences file. With no arguments it will print out the
priorities of each source. Otherwise it prints out detailed information
about the priority selection of the named package.</para></listitem>
</varlistentry>

<varlistentry><term>madison <replaceable>&synopsis-pkg;</replaceable>…</term>
<varlistentry><term><option>madison</option> <option><replaceable>&synopsis-pkg;</replaceable>…</option></term>
<listitem><para><literal>apt-cache</literal>'s <literal>madison</literal> command attempts to mimic
the output format and a subset of the functionality of the Debian
archive management tool, <literal>madison</literal>. It displays


+ 2
- 2
doc/apt-cdrom.8.xml View File

@@ -52,7 +52,7 @@
given one of the commands below must be present.
<variablelist>
<varlistentry><term>add</term>
<varlistentry><term><option>add</option></term>
<listitem><para><literal>add</literal> is used to add a new disc to the
source list. It will unmount the
CDROM device, prompt for a disk to be inserted and then proceed to
@@ -68,7 +68,7 @@
</listitem>
</varlistentry>
<varlistentry><term>ident</term>
<varlistentry><term><option>ident</option></term>
<listitem><para>A debugging tool to report the identity of the current
disc as well as the stored file name
</para>


+ 2
- 2
doc/apt-config.8.xml View File

@@ -46,7 +46,7 @@
</para>
<variablelist>
<varlistentry><term>shell</term>
<varlistentry><term><option>shell</option></term>
<listitem><para>
shell is used to access the configuration information from a shell
script. It is given pairs of arguments, the first being a shell
@@ -72,7 +72,7 @@ eval $RES
</listitem>
</varlistentry>

<varlistentry><term>dump</term>
<varlistentry><term><option>dump</option></term>
<listitem><para>
Just show the contents of the configuration space.</para>
</listitem>


+ 3
- 2
doc/apt-extracttemplates.1.xml View File

@@ -43,8 +43,9 @@
in the format:</para>
<para>package version template-file config-script</para>
<para>template-file and config-script are written to the temporary directory
specified by the -t or --tempdir (<literal>APT::ExtractTemplates::TempDir</literal>)
directory, with filenames of the form <filename>package.template.XXXX</filename> and
specified by the <option>-t</option> or <option>--tempdir</option>
(<literal>APT::ExtractTemplates::TempDir</literal>) directory,
with filenames of the form <filename>package.template.XXXX</filename> and
<filename>package.config.XXXX</filename></para>
</refsect1>


+ 50
- 50
doc/apt-ftparchive.1.xml View File

@@ -55,7 +55,7 @@
commands below must be present.</para>
<variablelist>
<varlistentry><term>packages</term>
<varlistentry><term><option>packages</option></term>
<listitem><para>
The packages command generates a package file from a directory tree. It
takes the given directory and recursively searches it for .deb files,
@@ -65,7 +65,7 @@
<para>The option <option>--db</option> can be used to specify a binary caching DB.</para></listitem>
</varlistentry>
<varlistentry><term>sources</term>
<varlistentry><term><option>sources</option></term>
<listitem><para>
The <literal>sources</literal> command generates a source index file from a directory tree.
It takes the given directory and recursively searches it for .dsc files,
@@ -77,7 +77,7 @@
used to change the source override file that will be used.</para></listitem>
</varlistentry>

<varlistentry><term>contents</term>
<varlistentry><term><option>contents</option></term>
<listitem><para>
The <literal>contents</literal> command generates a contents file from a directory tree. It
takes the given directory and recursively searches it for .deb files,
@@ -89,7 +89,7 @@
The option <option>--db</option> can be used to specify a binary caching DB.</para></listitem>
</varlistentry>

<varlistentry><term>release</term>
<varlistentry><term><option>release</option></term>
<listitem><para>
The <literal>release</literal> command generates a Release file from a
directory tree. It recursively searches the given directory for uncompressed
@@ -112,7 +112,7 @@

</varlistentry>

<varlistentry><term>generate</term>
<varlistentry><term><option>generate</option></term>
<listitem><para>
The <literal>generate</literal> command is designed to be runnable from a cron script and
builds indexes according to the given config file. The config language
@@ -121,7 +121,7 @@
required settings.</para></listitem>
</varlistentry>

<varlistentry><term>clean</term>
<varlistentry><term><option>clean</option></term>
<listitem><para>
The <literal>clean</literal> command tidies the databases used by the given
configuration file by removing any records that are no longer necessary.</para></listitem>
@@ -148,24 +148,24 @@
directories are prepended certain relative paths defined in later
sections to produce a complete an absolute path.</para>
<variablelist>
<varlistentry><term>ArchiveDir</term>
<varlistentry><term><option>ArchiveDir</option></term>
<listitem><para>
Specifies the root of the FTP archive, in a standard
Debian configuration this is the directory that contains the
<filename>ls-LR</filename> and dist nodes.</para></listitem>
</varlistentry>

<varlistentry><term>OverrideDir</term>
<varlistentry><term><option>OverrideDir</option></term>
<listitem><para>
Specifies the location of the override files.</para></listitem>
</varlistentry>
<varlistentry><term>CacheDir</term>
<varlistentry><term><option>CacheDir</option></term>
<listitem><para>
Specifies the location of the cache files</para></listitem>
</varlistentry>
<varlistentry><term>FileListDir</term>
<varlistentry><term><option>FileListDir</option></term>
<listitem><para>
Specifies the location of the file list files,
if the <literal>FileList</literal> setting is used below.</para></listitem>
@@ -179,7 +179,7 @@
that control the operation of the generator. Other sections may override
these defaults with a per-section setting.</para>
<variablelist>
<varlistentry><term>Packages::Compress</term>
<varlistentry><term><option>Packages::Compress</option></term>
<listitem><para>
Sets the default compression schemes to use
for the Package index files. It is a string that contains a space
@@ -187,51 +187,51 @@
'bzip2'. The default for all compression schemes is '. gzip'.</para></listitem>
</varlistentry>

<varlistentry><term>Packages::Extensions</term>
<varlistentry><term><option>Packages::Extensions</option></term>
<listitem><para>
Sets the default list of file extensions that are package files.
This defaults to '.deb'.</para></listitem>
</varlistentry>
<varlistentry><term>Sources::Compress</term>
<varlistentry><term><option>Sources::Compress</option></term>
<listitem><para>
This is similar to <literal>Packages::Compress</literal>
except that it controls the compression for the Sources files.</para></listitem>
</varlistentry>
<varlistentry><term>Sources::Extensions</term>
<varlistentry><term><option>Sources::Extensions</option></term>
<listitem><para>
Sets the default list of file extensions that are source files.
This defaults to '.dsc'.</para></listitem>
</varlistentry>
<varlistentry><term>Contents::Compress</term>
<varlistentry><term><option>Contents::Compress</option></term>
<listitem><para>
This is similar to <literal>Packages::Compress</literal>
except that it controls the compression for the Contents files.</para></listitem>
</varlistentry>

<varlistentry><term>Translation::Compress</term>
<varlistentry><term><option>Translation::Compress</option></term>
<listitem><para>
This is similar to <literal>Packages::Compress</literal>
except that it controls the compression for the Translation-en master file.</para></listitem>
</varlistentry>

<varlistentry><term>DeLinkLimit</term>
<varlistentry><term><option>DeLinkLimit</option></term>
<listitem><para>
Specifies the number of kilobytes to delink (and
replace with hard links) per run. This is used in conjunction with the
per-section <literal>External-Links</literal> setting.</para></listitem>
</varlistentry>
<varlistentry><term>FileMode</term>
<varlistentry><term><option>FileMode</option></term>
<listitem><para>
Specifies the mode of all created index files. It
defaults to 0644. All index files are set to this mode with no regard
to the umask.</para></listitem>
</varlistentry>

<varlistentry><term>LongDescription</term>
<varlistentry><term><option>LongDescription</option></term>
<listitem><para>
Sets if long descriptions should be included in the Packages file or split
out into a master Translation-en file.</para></listitem>
@@ -246,14 +246,14 @@
$(SECTION) and $(ARCH) replaced with their respective values.</para>
<variablelist>
<varlistentry><term>MaxContentsChange</term>
<varlistentry><term><option>MaxContentsChange</option></term>
<listitem><para>
Sets the number of kilobytes of contents
files that are generated each day. The contents files are round-robined
so that over several days they will all be rebuilt.</para></listitem>
</varlistentry>
<varlistentry><term>ContentsAge</term>
<varlistentry><term><option>ContentsAge</option></term>
<listitem><para>
Controls the number of days a contents file is allowed
to be checked without changing. If this limit is passed the mtime of the
@@ -264,45 +264,45 @@
the units are in days.</para></listitem>
</varlistentry>
<varlistentry><term>Directory</term>
<varlistentry><term><option>Directory</option></term>
<listitem><para>
Sets the top of the .deb directory tree. Defaults to
<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/</filename></para></listitem>
</varlistentry>
<varlistentry><term>SrcDirectory</term>
<varlistentry><term><option>SrcDirectory</option></term>
<listitem><para>
Sets the top of the source package directory tree. Defaults to
<filename>$(DIST)/$(SECTION)/source/</filename></para></listitem>
</varlistentry>
<varlistentry><term>Packages</term>
<varlistentry><term><option>Packages</option></term>
<listitem><para>
Sets the output Packages file. Defaults to
<filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</filename></para></listitem>
</varlistentry>
<varlistentry><term>Sources</term>
<varlistentry><term><option>Sources</option></term>
<listitem><para>
Sets the output Sources file. Defaults to
<filename>$(DIST)/$(SECTION)/source/Sources</filename></para></listitem>
</varlistentry>

<varlistentry><term>Translation</term>
<varlistentry><term><option>Translation</option></term>
<listitem><para>
Set the output Translation-en master file with the long descriptions if they
should be not included in the Packages file. Defaults to
<filename>$(DIST)/$(SECTION)/i18n/Translation-en</filename></para></listitem>
</varlistentry>

<varlistentry><term>InternalPrefix</term>
<varlistentry><term><option>InternalPrefix</option></term>
<listitem><para>
Sets the path prefix that causes a symlink to be
considered an internal link instead of an external link. Defaults to
<filename>$(DIST)/$(SECTION)/</filename></para></listitem>
</varlistentry>
<varlistentry><term>Contents</term>
<varlistentry><term><option>Contents</option></term>
<listitem><para>
Sets the output Contents file. Defaults to
<filename>$(DIST)/Contents-$(ARCH)</filename>. If this setting causes multiple
@@ -311,25 +311,25 @@
together automatically.</para></listitem>
</varlistentry>
<varlistentry><term>Contents::Header</term>
<varlistentry><term><option>Contents::Header</option></term>
<listitem><para>
Sets header file to prepend to the contents output.</para></listitem>
</varlistentry>

<varlistentry><term>BinCacheDB</term>
<varlistentry><term><option>BinCacheDB</option></term>
<listitem><para>
Sets the binary cache database to use for this
section. Multiple sections can share the same database.</para></listitem>
</varlistentry>
<varlistentry><term>FileList</term>
<varlistentry><term><option>FileList</option></term>
<listitem><para>
Specifies that instead of walking the directory tree,
<command>apt-ftparchive</command> should read the list of files from the given
file. Relative files names are prefixed with the archive directory.</para></listitem>
</varlistentry>
<varlistentry><term>SourceFileList</term>
<varlistentry><term><option>SourceFileList</option></term>
<listitem><para>
Specifies that instead of walking the directory tree,
<command>apt-ftparchive</command> should read the list of files from the given
@@ -363,44 +363,44 @@ for i in Sections do
</programlisting></para>

<variablelist>
<varlistentry><term>Sections</term>
<varlistentry><term><option>Sections</option></term>
<listitem><para>
This is a space separated list of sections which appear
under the distribution, typically this is something like
<literal>main contrib non-free</literal></para></listitem>
</varlistentry>
<varlistentry><term>Architectures</term>
<varlistentry><term><option>Architectures</option></term>
<listitem><para>
This is a space separated list of all the
architectures that appear under search section. The special architecture
'source' is used to indicate that this tree has a source archive.</para></listitem>
</varlistentry>

<varlistentry><term>LongDescription</term>
<varlistentry><term><option>LongDescription</option></term>
<listitem><para>
Sets if long descriptions should be included in the Packages file or split
out into a master Translation-en file.</para></listitem>
</varlistentry>

<varlistentry><term>BinOverride</term>
<varlistentry><term><option>BinOverride</option></term>
<listitem><para>
Sets the binary override file. The override file
contains section, priority and maintainer address information.</para></listitem>
</varlistentry>

<varlistentry><term>SrcOverride</term>
<varlistentry><term><option>SrcOverride</option></term>
<listitem><para>
Sets the source override file. The override file
contains section information.</para></listitem>
</varlistentry>
<varlistentry><term>ExtraOverride</term>
<varlistentry><term><option>ExtraOverride</option></term>
<listitem><para>
Sets the binary extra override file.</para></listitem>
</varlistentry>
<varlistentry><term>SrcExtraOverride</term>
<varlistentry><term><option>SrcExtraOverride</option></term>
<listitem><para>
Sets the source extra override file.</para></listitem>
</varlistentry>
@@ -415,53 +415,53 @@ for i in Sections do
section with no substitution variables or
<literal>Section</literal><literal>Architecture</literal> settings.</para>
<variablelist>
<varlistentry><term>Packages</term>
<varlistentry><term><option>Packages</option></term>
<listitem><para>
Sets the Packages file output.</para></listitem>
</varlistentry>
<varlistentry><term>Sources</term>
<varlistentry><term><option>Sources</option></term>
<listitem><para>
Sets the Sources file output. At least one of
<literal>Packages</literal> or <literal>Sources</literal> is required.</para></listitem>
</varlistentry>
<varlistentry><term>Contents</term>
<varlistentry><term><option>Contents</option></term>
<listitem><para>
Sets the Contents file output. (optional)</para></listitem>
</varlistentry>
<varlistentry><term>BinOverride</term>
<varlistentry><term><option>BinOverride</option></term>
<listitem><para>
Sets the binary override file.</para></listitem>
</varlistentry>
<varlistentry><term>SrcOverride</term>
<varlistentry><term><option>SrcOverride</option></term>
<listitem><para>
Sets the source override file.</para></listitem>
</varlistentry>
<varlistentry><term>ExtraOverride</term>
<varlistentry><term><option>ExtraOverride</option></term>
<listitem><para>
Sets the binary extra override file.</para></listitem>
</varlistentry>
<varlistentry><term>SrcExtraOverride</term>
<varlistentry><term><option>SrcExtraOverride</option></term>
<listitem><para>
Sets the source extra override file.</para></listitem>
</varlistentry>
<varlistentry><term>BinCacheDB</term>
<varlistentry><term><option>BinCacheDB</option></term>
<listitem><para>
Sets the cache DB.</para></listitem>
</varlistentry>
<varlistentry><term>PathPrefix</term>
<varlistentry><term><option>PathPrefix</option></term>
<listitem><para>
Appends a path to all the output paths.</para></listitem>
</varlistentry>
<varlistentry><term>FileList, SourceFileList</term>
<varlistentry><term><option>FileList</option></term><term><option>SourceFileList</option></term>
<listitem><para>
Specifies the file list file.</para></listitem>
</varlistentry>
@@ -505,7 +505,7 @@ for i in Sections do
&apt-cmdblurb;
<variablelist>
<varlistentry><term><option>--md5</option>, <option>--sha1</option>, <option>--sha256</option></term>
<varlistentry><term><option>--md5</option></term><term><option>--sha1</option></term><term><option>--sha256</option></term>
<listitem><para>
Generate the given checksum. These options default to on, when turned off the generated
index files will not have the checksum fields where possible.


+ 17
- 17
doc/apt-get.8.xml View File

@@ -45,7 +45,7 @@
commands below must be present.</para>
<variablelist>
<varlistentry><term>update</term>
<varlistentry><term><option>update</option></term>
<listitem><para><literal>update</literal> is used to resynchronize the package index files from
their sources. The indexes of available packages are fetched from the
location(s) specified in <filename>/etc/apt/sources.list</filename>.
@@ -57,7 +57,7 @@
of the package files cannot be known in advance.</para></listitem>
</varlistentry>
<varlistentry><term>upgrade</term>
<varlistentry><term><option>upgrade</option></term>
<listitem><para><literal>upgrade</literal> is used to install the newest versions of all packages
currently installed on the system from the sources enumerated in
<filename>/etc/apt/sources.list</filename>. Packages currently installed with
@@ -70,7 +70,7 @@
available.</para></listitem>
</varlistentry>

<varlistentry><term>dselect-upgrade</term>
<varlistentry><term><option>dselect-upgrade</option></term>
<listitem><para><literal>dselect-upgrade</literal>
is used in conjunction with the traditional Debian packaging
front-end, &dselect;. <literal>dselect-upgrade</literal>
@@ -80,7 +80,7 @@
packages).</para></listitem>
</varlistentry>

<varlistentry><term>dist-upgrade</term>
<varlistentry><term><option>dist-upgrade</option></term>
<listitem><para><literal>dist-upgrade</literal> in addition to performing the function of
<literal>upgrade</literal>, also intelligently handles changing dependencies
with new versions of packages; <command>apt-get</command> has a "smart" conflict
@@ -93,7 +93,7 @@
overriding the general settings for individual packages.</para></listitem>
</varlistentry>

<varlistentry><term>install</term>
<varlistentry><term><option>install</option></term>
<listitem>
<para><literal>install</literal> is followed by one or more
packages desired for installation or upgrading.
@@ -147,7 +147,7 @@
with a '^' or '$' character, or create a more specific regular expression.</para></listitem>
</varlistentry>

<varlistentry><term>remove</term>
<varlistentry><term><option>remove</option></term>
<listitem><para><literal>remove</literal> is identical to <literal>install</literal> except that packages are
removed instead of installed. Note the removing a package leaves its
configuration files in system. If a plus sign is appended to the package
@@ -155,12 +155,12 @@
installed instead of removed.</para></listitem>
</varlistentry>

<varlistentry><term>purge</term>
<varlistentry><term><option>purge</option></term>
<listitem><para><literal>purge</literal> is identical to <literal>remove</literal> except that packages are
removed and purged (any configuration files are deleted too).</para></listitem>
</varlistentry>

<varlistentry><term>source</term>
<varlistentry><term><option>source</option></term>
<listitem><para><literal>source</literal> causes <command>apt-get</command> to fetch source packages. APT
will examine the available packages to decide which source package to
fetch. It will then find and download into the current directory the
@@ -194,25 +194,25 @@
tar balls.</para></listitem>
</varlistentry>

<varlistentry><term>build-dep</term>
<varlistentry><term><option>build-dep</option></term>
<listitem><para><literal>build-dep</literal> causes apt-get to install/remove packages in an
attempt to satisfy the build dependencies for a source package. By default the dependencies are
satisfied to build the package natively. If desired a host-architecture can be specified
with the <option>--host-architecture</option> option instead.</para></listitem>
</varlistentry>

<varlistentry><term>check</term>
<varlistentry><term><option>check</option></term>
<listitem><para><literal>check</literal> is a diagnostic tool; it updates the package cache and checks
for broken dependencies.</para></listitem>
</varlistentry>

<varlistentry><term>download</term>
<varlistentry><term><option>download</option></term>
<listitem><para><literal>download</literal> will download the given
binary package into the current directory.
</para></listitem>
</varlistentry>

<varlistentry><term>clean</term>
<varlistentry><term><option>clean</option></term>
<listitem><para><literal>clean</literal> clears out the local repository of retrieved package
files. It removes everything but the lock file from
<filename>&cachedir;/archives/</filename> and
@@ -222,7 +222,7 @@
from time to time to free up disk space.</para></listitem>
</varlistentry>

<varlistentry><term>autoclean</term>
<varlistentry><term><option>autoclean</option></term>
<listitem><para>Like <literal>clean</literal>, <literal>autoclean</literal> clears out the local
repository of retrieved package files. The difference is that it only
removes package files that can no longer be downloaded, and are largely
@@ -232,17 +232,17 @@
erased if it is set to off.</para></listitem>
</varlistentry>

<varlistentry><term>autoremove</term>
<varlistentry><term><option>autoremove</option></term>
<listitem><para><literal>autoremove</literal> is used to remove packages that were automatically
installed to satisfy dependencies for other packages and are now no longer needed.</para></listitem>
</varlistentry>

<varlistentry><term>changelog</term>
<varlistentry><term><option>changelog</option></term>
<listitem><para><literal>changelog</literal> downloads a package changelog and displays
it through <command>sensible-pager</command>. The server name and base
directory is defined in the <literal>APT::Changelogs::Server</literal>
variable (e. g. <ulink>http://packages.debian.org/changelogs</ulink> for
Debian or <ulink>http://changelogs.ubuntu.com/changelogs</ulink> for
variable (e. g. <ulink url="http://packages.debian.org/changelogs">packages.debian.org/changelogs</ulink> for
Debian or <ulink url="http://changelogs.ubuntu.com/changelogs">changelogs.ubuntu.com/changelogs</ulink> for
Ubuntu).
By default it displays the changelog for the version that is
installed. However, you can specify the same options as for


+ 10
- 10
doc/apt-key.8.xml View File

@@ -37,7 +37,7 @@

<refsect1><title>Commands</title>
<variablelist>
<varlistentry><term>add &synopsis-param-filename;</term>
<varlistentry><term><option>add</option> <option>&synopsis-param-filename;</option></term>
<listitem>
<para>
Add a new key to the list of trusted keys.
@@ -49,7 +49,7 @@
</listitem>
</varlistentry>

<varlistentry><term>del &synopsis-param-keyid;</term>
<varlistentry><term><option>del</option> <option>&synopsis-param-keyid;</option></term>
<listitem>
<para>

@@ -60,7 +60,7 @@
</listitem>
</varlistentry>

<varlistentry><term>export &synopsis-param-keyid;</term>
<varlistentry><term><option>export</option> <option>&synopsis-param-keyid;</option></term>
<listitem>
<para>

@@ -71,7 +71,7 @@
</listitem>
</varlistentry>

<varlistentry><term>exportall</term>
<varlistentry><term><option>exportall</option></term>
<listitem>
<para>

@@ -82,7 +82,7 @@
</listitem>
</varlistentry>

<varlistentry><term>list</term>
<varlistentry><term><option>list</option></term>
<listitem>
<para>

@@ -93,7 +93,7 @@
</listitem>
</varlistentry>
<varlistentry><term>finger</term>
<varlistentry><term><option>finger</option></term>
<listitem>
<para>

@@ -104,7 +104,7 @@
</listitem>
</varlistentry>
<varlistentry><term>adv</term>
<varlistentry><term><option>adv</option></term>
<listitem>
<para>

@@ -116,7 +116,7 @@
</listitem>
</varlistentry>

<varlistentry><term>update</term>
<varlistentry><term><option>update</option></term>
<listitem>
<para>

@@ -130,7 +130,7 @@
</listitem>
</varlistentry>
<varlistentry><term>net-update</term>
<varlistentry><term><option>net-update</option></term>
<listitem>
<para>

@@ -153,7 +153,7 @@
<refsect1><title>Options</title>
<para>Note that options need to be defined before the commands described in the previous section.</para>
<variablelist>
<varlistentry><term>--keyring &synopsis-param-filename;</term>
<varlistentry><term><option>--keyring</option> <option>&synopsis-param-filename;</option></term>
<listitem><para>With this option it is possible to specify a specific keyring
file the command should operate on. The default is that a command is executed
on the <filename>trusted.gpg</filename> file as well as on all parts in the


+ 12
- 12
doc/apt-mark.8.xml View File

@@ -48,7 +48,7 @@
<command>apt-get</command> or <command>aptitude</command>.
</para>
<variablelist>
<varlistentry><term>auto</term>
<varlistentry><term><option>auto</option></term>
<listitem><para><literal>auto</literal> is used to mark a
package as being automatically installed, which will cause the
package to be removed when no more manually installed packages
@@ -56,7 +56,7 @@
</para></listitem>
</varlistentry>

<varlistentry><term>manual</term>
<varlistentry><term><option>manual</option></term>
<listitem><para><literal>manual</literal> is used to mark a
package as being manually installed, which will prevent the
package from being automatically removed if no other packages
@@ -64,7 +64,7 @@
</para></listitem>
</varlistentry>

<varlistentry><term>hold</term>
<varlistentry><term><option>hold</option></term>
<listitem><para><literal>hold</literal> is used to mark a
package as hold back, which will prevent the package from being
automatically installed, upgraded or removed.
@@ -74,13 +74,13 @@
</para></listitem>
</varlistentry>

<varlistentry><term>unhold</term>
<varlistentry><term><option>unhold</option></term>
<listitem><para><literal>unhold</literal> is used to cancel a
previously set hold on a package to allow all actions again.
</para></listitem>
</varlistentry>

<varlistentry><term>showauto</term>
<varlistentry><term><option>showauto</option></term>
<listitem><para><literal>showauto</literal> is used to print a
list of automatically installed packages with each package on a new line.
All automatically installed packages will be listed if no package is given.
@@ -88,14 +88,14 @@
</para></listitem>
</varlistentry>

<varlistentry><term>showmanual</term>
<varlistentry><term><option>showmanual</option></term>
<listitem><para><literal>showmanual</literal> can be used in
the same way as <literal>showauto</literal> except that it will print
a list of manually installed packages instead.
</para></listitem>
</varlistentry>

<varlistentry><term>showhold</term>
<varlistentry><term><option>showhold</option></term>
<listitem><para><literal>showhold</literal> is used to print a list
of packages on hold in the same way as for the other show commands.
</para></listitem>
@@ -109,12 +109,12 @@
<variablelist>
<varlistentry>
<term><option>-f=<filename><replaceable>FILENAME</replaceable></filename></option></term>
<term><option>--file=<filename><replaceable>FILENAME</replaceable></filename></option></term>
<term><option>-f=<filename><replaceable>&synopsis-filename;</replaceable></filename></option></term>
<term><option>--file=<filename><replaceable>&synopsis-filename;</replaceable></filename></option></term>
<listitem><para>
Read/Write package stats from <filename><replaceable>FILENAME</replaceable></filename>
instead of the default location, which
Read/Write package stats from the filename given with the parameter
<filename><replaceable>&synopsis-filename;</replaceable></filename>
instead of from the default location, which
is <filename>extended_status</filename> in the directory defined
by the Configuration Item: <literal>Dir::State</literal>.</para></listitem>
</varlistentry>


+ 69
- 69
doc/apt.conf.5.xml View File

@@ -148,13 +148,13 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
options for all of the tools.</para>

<variablelist>
<varlistentry><term>Architecture</term>
<varlistentry><term><option>Architecture</option></term>
<listitem><para>System Architecture; sets the architecture to use when fetching files and
parsing package lists. The internal default is the architecture apt was
compiled for.</para></listitem>
</varlistentry>

<varlistentry><term>Architectures</term>
<varlistentry><term><option>Architectures</option></term>
<listitem><para>All Architectures the system supports. Processors implementing the
<literal>amd64</literal> (also called <literal>x86-64</literal>) instruction set are
e.g. also able to execute binaries compiled for the <literal>i386</literal>
@@ -164,25 +164,25 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</para></listitem>
</varlistentry>

<varlistentry><term>Default-Release</term>
<varlistentry><term><option>Default-Release</option></term>
<listitem><para>Default release to install packages from if more than one
version available. Contains release name, codename or release version. Examples: 'stable', 'testing',
'unstable', '&stable-codename;', '&testing-codename;', '4.0', '5.0*'. See also &apt-preferences;.</para></listitem>
</varlistentry>

<varlistentry><term>Ignore-Hold</term>
<varlistentry><term><option>Ignore-Hold</option></term>
<listitem><para>Ignore Held packages; This global option causes the problem resolver to
ignore held packages in its decision making.</para></listitem>
</varlistentry>

<varlistentry><term>Clean-Installed</term>
<varlistentry><term><option>Clean-Installed</option></term>
<listitem><para>Defaults to on. When turned on the autoclean feature will remove any packages
which can no longer be downloaded from the cache. If turned off then
packages that are locally installed are also excluded from cleaning - but
note that APT provides no direct means to reinstall them.</para></listitem>
</varlistentry>

<varlistentry><term>Immediate-Configure</term>
<varlistentry><term><option>Immediate-Configure</option></term>
<listitem><para>Defaults to on which will cause APT to install essential and important packages
as fast as possible in the install/upgrade operation. This is done to limit the effect of a failing
&dpkg; call: If this option is disabled APT does treat an important package in the same way as
@@ -205,7 +205,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
improving or correcting the upgrade process.</para></listitem>
</varlistentry>

<varlistentry><term>Force-LoopBreak</term>
<varlistentry><term><option>Force-LoopBreak</option></term>
<listitem><para>Never Enable this option unless you -really- know what you are doing. It
permits APT to temporarily remove an essential package to break a
Conflicts/Conflicts or Conflicts/Pre-Depend loop between two essential
@@ -214,7 +214,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
anything that those packages depend on.</para></listitem>
</varlistentry>

<varlistentry><term>Cache-Start, Cache-Grow and Cache-Limit</term>
<varlistentry><term><option>Cache-Start</option></term><term><option>Cache-Grow</option></term><term><option>Cache-Limit</option></term>
<listitem><para>APT uses since version 0.7.26 a resizable memory mapped cache file to store the 'available'
information. <literal>Cache-Start</literal> acts as a hint to which size the Cache will grow
and is therefore the amount of memory APT will request at startup. The default value is
@@ -230,21 +230,21 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</para></listitem>
</varlistentry>

<varlistentry><term>Build-Essential</term>
<varlistentry><term><option>Build-Essential</option></term>
<listitem><para>Defines which package(s) are considered essential build dependencies.</para></listitem>
</varlistentry>

<varlistentry><term>Get</term>
<varlistentry><term><option>Get</option></term>
<listitem><para>The Get subsection controls the &apt-get; tool, please see its
documentation for more information about the options here.</para></listitem>
</varlistentry>

<varlistentry><term>Cache</term>
<varlistentry><term><option>Cache</option></term>
<listitem><para>The Cache subsection controls the &apt-cache; tool, please see its
documentation for more information about the options here.</para></listitem>
</varlistentry>

<varlistentry><term>CDROM</term>
<varlistentry><term><option>CDROM</option></term>
<listitem><para>The CDROM subsection controls the &apt-cdrom; tool, please see its
documentation for more information about the options here.</para></listitem>
</varlistentry>
@@ -256,7 +256,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
and the URI handlers.

<variablelist>
<varlistentry><term>Check-Valid-Until</term>
<varlistentry><term><option>Check-Valid-Until</option></term>
<listitem><para>Security related option defaulting to true as an
expiring validation for a Release file prevents longtime replay attacks
and can e.g. also help users to identify no longer updated mirrors -
@@ -267,7 +267,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</para></listitem>
</varlistentry>

<varlistentry><term>Max-ValidTime</term>
<varlistentry><term><option>Max-ValidTime</option></term>
<listitem><para>Seconds the Release file should be considered valid after
it was created (indicated by the <literal>Date</literal> header).
If the Release file itself includes a <literal>Valid-Until</literal> header
@@ -278,7 +278,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</para></listitem>
</varlistentry>

<varlistentry><term>Min-ValidTime</term>
<varlistentry><term><option>Min-ValidTime</option></term>
<listitem><para>Minimum of seconds the Release file should be considered
valid after it was created (indicated by the <literal>Date</literal> header).
Use this if you need to use a seldomly updated (local) mirror of a more
@@ -289,7 +289,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</para></listitem>
</varlistentry>

<varlistentry><term>PDiffs</term>
<varlistentry><term><option>PDiffs</option></term>
<listitem><para>Try to download deltas called <literal>PDiffs</literal> for
Packages or Sources files instead of downloading whole ones. True
by default.</para>
@@ -302,7 +302,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</para></listitem>
</varlistentry>

<varlistentry><term>Queue-Mode</term>
<varlistentry><term><option>Queue-Mode</option></term>
<listitem><para>Queuing mode; <literal>Queue-Mode</literal> can be one of <literal>host</literal> or
<literal>access</literal> which determines how APT parallelizes outgoing
connections. <literal>host</literal> means that one connection per target host
@@ -310,17 +310,17 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
will be opened.</para></listitem>
</varlistentry>

<varlistentry><term>Retries</term>
<varlistentry><term><option>Retries</option></term>
<listitem><para>Number of retries to perform. If this is non-zero APT will retry failed
files the given number of times.</para></listitem>
</varlistentry>

<varlistentry><term>Source-Symlinks</term>
<varlistentry><term><option>Source-Symlinks</option></term>
<listitem><para>Use symlinks for source archives. If set to true then source archives will
be symlinked when possible instead of copying. True is the default.</para></listitem>
</varlistentry>

<varlistentry><term>http</term>
<varlistentry><term><option>http</option></term>
<listitem><para>HTTP URIs; http::Proxy is the default http proxy to use. It is in the
standard form of <literal>http://[[user][:pass]@]host[:port]/</literal>. Per
host proxies can also be specified by using the form
@@ -363,7 +363,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</listitem>
</varlistentry>

<varlistentry><term>https</term>
<varlistentry><term><option>https</option></term>
<listitem><para>HTTPS URIs. Cache-control, Timeout, AllowRedirect, Dl-Limit and
proxy options are the same as for <literal>http</literal> method and will also
default to the options from the <literal>http</literal> method if they are not
@@ -388,7 +388,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
<literal>&lt;host&gt;::SslForceVersion</literal> is corresponding per-host option.
</para></listitem></varlistentry>

<varlistentry><term>ftp</term>
<varlistentry><term><option>ftp</option></term>
<listitem><para>FTP URIs; ftp::Proxy is the default ftp proxy to use. It is in the
standard form of <literal>ftp://[[user][:pass]@]host[:port]/</literal>. Per
host proxies can also be specified by using the form
@@ -427,7 +427,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
do not support RFC2428.</para></listitem>
</varlistentry>

<varlistentry><term>cdrom</term>
<varlistentry><term><option>cdrom</option></term>
<listitem><para>CDROM URIs; the only setting for CDROM URIs is the mount point,
<literal>cdrom::Mount</literal> which must be the mount point for the CDROM drive
as specified in <filename>/etc/fstab</filename>. It is possible to provide
@@ -438,13 +438,13 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
commands can be specified using UMount.</para></listitem>
</varlistentry>

<varlistentry><term>gpgv</term>
<varlistentry><term><option>gpgv</option></term>
<listitem><para>GPGV URIs; the only option for GPGV URIs is the option to pass additional parameters to gpgv.
<literal>gpgv::Options</literal> Additional options passed to gpgv.
</para></listitem>
</varlistentry>

<varlistentry><term>CompressionTypes</term>
<varlistentry><term><option>CompressionTypes</option></term>
<listitem><para>List of compression types which are understood by the acquire methods.
Files like <filename>Packages</filename> can be available in various compression formats.
Per default the acquire methods can decompress <command>bzip2</command>, <command>lzma</command>
@@ -472,7 +472,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
useable for local mirrors.</para></listitem>
</varlistentry>

<varlistentry><term>GzipIndexes</term>
<varlistentry><term><option>GzipIndexes</option></term>
<listitem><para>
When downloading <literal>gzip</literal> compressed indexes (Packages, Sources, or
Translations), keep them gzip compressed locally instead of unpacking
@@ -481,7 +481,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</para></listitem>
</varlistentry>

<varlistentry><term>Languages</term>
<varlistentry><term><option>Languages</option></term>
<listitem><para>The Languages subsection controls which <filename>Translation</filename> files are downloaded
and in which order APT tries to display the Description-Translations. APT will try to display the first
available Description in the Language which is listed at first. Languages can be defined with their
@@ -574,7 +574,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
control the default behaviour. These are in the <literal>DSelect</literal> section.</para>
<variablelist>
<varlistentry><term>Clean</term>
<varlistentry><term><option>Clean</option></term>
<listitem><para>Cache Clean mode; this value may be one of always, prompt, auto,
pre-auto and never. always and prompt will remove all packages from
the cache after upgrading, prompt (the default) does so conditionally.
@@ -583,17 +583,17 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
action before downloading new packages.</para></listitem>
</varlistentry>

<varlistentry><term>options</term>
<varlistentry><term><option>options</option></term>
<listitem><para>The contents of this variable is passed to &apt-get; as command line
options when it is run for the install phase.</para></listitem>
</varlistentry>

<varlistentry><term>Updateoptions</term>
<varlistentry><term><option>Updateoptions</option></term>
<listitem><para>The contents of this variable is passed to &apt-get; as command line
options when it is run for the update phase.</para></listitem>
</varlistentry>

<varlistentry><term>PromptAfterUpdate</term>
<varlistentry><term><option>PromptAfterUpdate</option></term>
<listitem><para>If true the [U]pdate operation in &dselect; will always prompt to continue.
The default is to prompt only on error.</para></listitem>
</varlistentry>
@@ -605,20 +605,20 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
in the <literal>DPkg</literal> section.</para>

<variablelist>
<varlistentry><term>options</term>
<varlistentry><term><option>options</option></term>
<listitem><para>This is a list of options to pass to dpkg. The options must be specified
using the list notation and each list item is passed as a single argument
to &dpkg;.</para></listitem>
</varlistentry>
<varlistentry><term>Pre-Invoke</term><term>Post-Invoke</term>
<varlistentry><term><option>Pre-Invoke</option></term><term><option>Post-Invoke</option></term>
<listitem><para>This is a list of shell commands to run before/after invoking &dpkg;.
Like <literal>options</literal> this must be specified in list notation. The
commands are invoked in order using <filename>/bin/sh</filename>, should any
fail APT will abort.</para></listitem>
</varlistentry>

<varlistentry><term>Pre-Install-Pkgs</term>
<varlistentry><term><option>Pre-Install-Pkgs</option></term>
<listitem><para>This is a list of shell commands to run before invoking dpkg. Like
<literal>options</literal> this must be specified in list notation. The commands
are invoked in order using <filename>/bin/sh</filename>, should any fail APT
@@ -632,12 +632,12 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
command given to <literal>Pre-Install-Pkgs</literal>.</para></listitem>
</varlistentry>

<varlistentry><term>Run-Directory</term>
<varlistentry><term><option>Run-Directory</option></term>
<listitem><para>APT chdirs to this directory before invoking dpkg, the default is
<filename>/</filename>.</para></listitem>
</varlistentry>

<varlistentry><term>Build-options</term>
<varlistentry><term><option>Build-options</option></term>
<listitem><para>These options are passed to &dpkg-buildpackage; when compiling packages,
the default is to disable signing and produce all binaries.</para></listitem>
</varlistentry>
@@ -665,7 +665,7 @@ DPkg::ConfigurePending "true";
DPkg::TriggersPending "true";</literallayout></para>

<variablelist>
<varlistentry><term>DPkg::NoTriggers</term>
<varlistentry><term><option>DPkg::NoTriggers</option></term>
<listitem><para>Add the no triggers flag to all dpkg calls (except the ConfigurePending call).
See &dpkg; if you are interested in what this actually means. In short: dpkg will not run the
triggers when this flag is present unless it is explicitly called to do so in an extra call.
@@ -673,7 +673,7 @@ DPkg::TriggersPending "true";</literallayout></para>
meaning: Previously these option only append --no-triggers to the configure calls to dpkg -
now apt will add these flag also to the unpack and remove calls.</para></listitem>
</varlistentry>
<varlistentry><term>PackageManager::Configure</term>
<varlistentry><term><option>PackageManager::Configure</option></term>
<listitem><para>Valid values are "<literal>all</literal>", "<literal>smart</literal>" and "<literal>no</literal>".
"<literal>all</literal>" is the default value and causes APT to configure all packages explicit.
The "<literal>smart</literal>" way is it to configure only packages which need to be configured before
@@ -684,20 +684,20 @@ DPkg::TriggersPending "true";</literallayout></para>
default as otherwise the system could end in an unconfigured status which could be unbootable!
</para></listitem>
</varlistentry>
<varlistentry><term>DPkg::ConfigurePending</term>
<varlistentry><term><option>DPkg::ConfigurePending</option></term>
<listitem><para>If this option is set apt will call <command>dpkg --configure --pending</command>
to let dpkg handle all required configurations and triggers. This option is activated automatic
per default if the previous option is not set to <literal>all</literal>, but deactivating could be useful
if you want to run APT multiple times in a row - e.g. in an installer. In these sceneries you could
deactivate this option in all but the last run.</para></listitem>
</varlistentry>
<varlistentry><term>DPkg::TriggersPending</term>
<varlistentry><term><option>DPkg::TriggersPending</option></term>
<listitem><para>Useful for <literal>smart</literal> configuration as a package which has pending
triggers is not considered as <literal>installed</literal> and dpkg treats them as <literal>unpacked</literal>
currently which is a dealbreaker for Pre-Dependencies (see debbugs #526774). Note that this will
process all triggers, not only the triggers needed to configure this package.</para></listitem>
</varlistentry>
<varlistentry><term>PackageManager::UnpackAll</term>
<varlistentry><term><option>PackageManager::UnpackAll</option></term>
<listitem><para>As the configuration can be deferred to be done at the end by dpkg it can be
tried to order the unpack series only by critical needs, e.g. by Pre-Depends. Default is true
and therefore the "old" method of ordering in various steps by everything. While both method
@@ -705,7 +705,7 @@ DPkg::TriggersPending "true";</literallayout></para>
this method is very experimental and needs further improvements before becoming really useful.
</para></listitem>
</varlistentry>
<varlistentry><term>OrderList::Score::Immediate</term>
<varlistentry><term><option>OrderList::Score::Immediate</option></term>
<listitem><para>Essential packages (and there dependencies) should be configured immediately
after unpacking. It will be a good idea to do this quite early in the upgrade process as these
these configure calls require currently also <literal>DPkg::TriggersPending</literal> which
@@ -788,7 +788,7 @@ DPkg::TriggersPending "true";</literallayout></para>

<variablelist>
<varlistentry>
<term><literal>Debug::Acquire::cdrom</literal></term>
<term><option>Debug::Acquire::cdrom</option></term>

<listitem>
<para>
@@ -799,7 +799,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::Acquire::ftp</literal></term>
<term><option>Debug::Acquire::ftp</option></term>

<listitem>
<para>
@@ -810,7 +810,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::Acquire::http</literal></term>
<term><option>Debug::Acquire::http</option></term>

<listitem>
<para>
@@ -821,7 +821,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::Acquire::https</literal></term>
<term><option>Debug::Acquire::https</option></term>

<listitem>
<para>
@@ -832,7 +832,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::Acquire::gpgv</literal></term>
<term><option>Debug::Acquire::gpgv</option></term>

<listitem>
<para>
@@ -843,7 +843,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::aptcdrom</literal></term>
<term><option>Debug::aptcdrom</option></term>

<listitem>
<para>
@@ -854,7 +854,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::BuildDeps</literal></term>
<term><option>Debug::BuildDeps</option></term>
<listitem>
<para>
Describes the process of resolving build-dependencies in
@@ -864,7 +864,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::Hashes</literal></term>
<term><option>Debug::Hashes</option></term>
<listitem>
<para>
Output each cryptographic hash that is generated by the
@@ -874,7 +874,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::IdentCDROM</literal></term>
<term><option>Debug::IdentCDROM</option></term>
<listitem>
<para>
Do not include information from <literal>statfs</literal>,
@@ -885,7 +885,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::NoLocking</literal></term>
<term><option>Debug::NoLocking</option></term>
<listitem>
<para>
Disable all file locking. For instance, this will allow
@@ -896,7 +896,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgAcquire</literal></term>
<term><option>Debug::pkgAcquire</option></term>

<listitem>
<para>
@@ -907,7 +907,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgAcquire::Auth</literal></term>
<term><option>Debug::pkgAcquire::Auth</option></term>
<listitem>
<para>
Output status messages and errors related to verifying
@@ -917,7 +917,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgAcquire::Diffs</literal></term>
<term><option>Debug::pkgAcquire::Diffs</option></term>
<listitem>
<para>
Output information about downloading and applying package
@@ -928,7 +928,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgAcquire::RRed</literal></term>
<term><option>Debug::pkgAcquire::RRed</option></term>

<listitem>
<para>
@@ -939,7 +939,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgAcquire::Worker</literal></term>
<term><option>Debug::pkgAcquire::Worker</option></term>

<listitem>
<para>
@@ -950,7 +950,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgAutoRemove</literal></term>
<term><option>Debug::pkgAutoRemove</option></term>

<listitem>
<para>
@@ -961,7 +961,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgDepCache::AutoInstall</literal></term>
<term><option>Debug::pkgDepCache::AutoInstall</option></term>
<listitem>
<para>
Generate debug messages describing which packages are being
@@ -975,7 +975,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgDepCache::Marker</literal></term>
<term><option>Debug::pkgDepCache::Marker</option></term>
<listitem>
<para>
Generate debug messages describing which package is marked
@@ -997,7 +997,7 @@ DPkg::TriggersPending "true";</literallayout></para>

<!-- Question: why doesn't this do anything? The code says it should. -->
<varlistentry>
<term><literal>Debug::pkgInitConfig</literal></term>
<term><option>Debug::pkgInitConfig</option></term>
<listitem>
<para>
Dump the default configuration to standard error on
@@ -1007,7 +1007,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgDPkgPM</literal></term>
<term><option>Debug::pkgDPkgPM</option></term>
<listitem>
<para>
When invoking &dpkg;, output the precise command line with
@@ -1018,7 +1018,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgDPkgProgressReporting</literal></term>
<term><option>Debug::pkgDPkgProgressReporting</option></term>
<listitem>
<para>
Output all the data received from &dpkg; on the status file
@@ -1028,7 +1028,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgOrderList</literal></term>
<term><option>Debug::pkgOrderList</option></term>

<listitem>
<para>
@@ -1040,7 +1040,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgPackageManager</literal></term>
<term><option>Debug::pkgPackageManager</option></term>

<listitem>
<para>
@@ -1051,7 +1051,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgPolicy</literal></term>
<term><option>Debug::pkgPolicy</option></term>

<listitem>
<para>
@@ -1061,7 +1061,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgProblemResolver</literal></term>
<term><option>Debug::pkgProblemResolver</option></term>

<listitem>
<para>
@@ -1073,7 +1073,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::pkgProblemResolver::ShowScores</literal></term>
<term><option>Debug::pkgProblemResolver::ShowScores</option></term>
<listitem>
<para>
Display a list of all installed packages with their calculated score
@@ -1084,7 +1084,7 @@ DPkg::TriggersPending "true";</literallayout></para>
</varlistentry>

<varlistentry>
<term><literal>Debug::sourceList</literal></term>
<term><option>Debug::sourceList</option></term>

<listitem>
<para>


+ 2
- 1
doc/apt_preferences.5.xml View File

@@ -287,6 +287,7 @@ Pin: release n=karmic*
Pin-Priority: 990
</programlisting>

<para>
If a regular expression occurs in a <literal>Package</literal> field,
the behavior is the same as if this regular expression were replaced
with a list of all package names it matches. It is undecided whether
@@ -295,7 +296,7 @@ pins first, so later specific pins override it.

The pattern "<literal>*</literal>" in a Package field is not considered
a glob() expression in itself.
</para>
</refsect2>




+ 145
- 1333
doc/po/apt-doc.pot
File diff suppressed because it is too large
View File


+ 190
- 1371
doc/po/de.po
File diff suppressed because it is too large
View File


+ 174
- 1700
doc/po/es.po
File diff suppressed because it is too large
View File


+ 184
- 1668
doc/po/fr.po
File diff suppressed because it is too large
View File


+ 157
- 1353
doc/po/it.po
File diff suppressed because it is too large
View File


+ 179
- 1747
doc/po/ja.po
File diff suppressed because it is too large
View File


+ 171
- 1756
doc/po/pl.po
File diff suppressed because it is too large
View File


+ 172
- 1696
doc/po/pt.po
File diff suppressed because it is too large
View File


+ 158
- 1426
doc/po/pt_BR.po
File diff suppressed because it is too large
View File


+ 18
- 13
doc/po4a.conf View File

@@ -3,23 +3,28 @@

# Entities need to be present, even if not translated
[po4a_alias:entity] text opt:"-k 0"
[po4a_alias:manpage] docbook opt:"\
-o untranslated='<term><option>' \
-o break='<term><option>' \
-o nodefault='<option>' \
-o inline='<para><option>'"

# define source file and translated file (one file per line)
[type: man] apt.8 $lang:$lang/apt.$lang.8
[type: entity] apt.ent $lang:$lang/apt.ent
[type: docbook] apt-cache.8.xml $lang:$lang/apt-cache.$lang.8.xml add_$lang:xml.add
[type: docbook] apt-cdrom.8.xml $lang:$lang/apt-cdrom.$lang.8.xml add_$lang:xml.add
[type: docbook] apt-config.8.xml $lang:$lang/apt-config.$lang.8.xml add_$lang:xml.add
[type: docbook] apt-extracttemplates.1.xml $lang:$lang/apt-extracttemplates.$lang.1.xml add_$lang:xml.add
[type: docbook] apt-ftparchive.1.xml $lang:$lang/apt-ftparchive.$lang.1.xml add_$lang:xml.add
[type: docbook] apt-get.8.xml $lang:$lang/apt-get.$lang.8.xml add_$lang:xml.add
[type: docbook] apt-key.8.xml $lang:$lang/apt-key.$lang.8.xml add_$lang:xml.add
[type: docbook] apt-mark.8.xml $lang:$lang/apt-mark.$lang.8.xml add_$lang:xml.add
[type: docbook] apt-secure.8.xml $lang:$lang/apt-secure.$lang.8.xml add_$lang:xml.add
[type: docbook] apt-sortpkgs.1.xml $lang:$lang/apt-sortpkgs.$lang.1.xml add_$lang:xml.add
[type: docbook] apt.conf.5.xml $lang:$lang/apt.conf.$lang.5.xml add_$lang:xml.add
[type: docbook] apt_preferences.5.xml $lang:$lang/apt_preferences.$lang.5.xml add_$lang:xml.add
[type: docbook] sources.list.5.xml $lang:$lang/sources.list.$lang.5.xml add_$lang:xml.add
[type: manpage] apt-cache.8.xml $lang:$lang/apt-cache.$lang.8.xml add_$lang:xml.add
[type: manpage] apt-cdrom.8.xml $lang:$lang/apt-cdrom.$lang.8.xml add_$lang:xml.add
[type: manpage] apt-config.8.xml $lang:$lang/apt-config.$lang.8.xml add_$lang:xml.add
[type: manpage] apt-extracttemplates.1.xml $lang:$lang/apt-extracttemplates.$lang.1.xml add_$lang:xml.add
[type: manpage] apt-ftparchive.1.xml $lang:$lang/apt-ftparchive.$lang.1.xml add_$lang:xml.add
[type: manpage] apt-get.8.xml $lang:$lang/apt-get.$lang.8.xml add_$lang:xml.add
[type: manpage] apt-key.8.xml $lang:$lang/apt-key.$lang.8.xml add_$lang:xml.add
[type: manpage] apt-mark.8.xml $lang:$lang/apt-mark.$lang.8.xml add_$lang:xml.add
[type: manpage] apt-secure.8.xml $lang:$lang/apt-secure.$lang.8.xml add_$lang:xml.add
[type: manpage] apt-sortpkgs.1.xml $lang:$lang/apt-sortpkgs.$lang.1.xml add_$lang:xml.add
[type: manpage] apt.conf.5.xml $lang:$lang/apt.conf.$lang.5.xml add_$lang:xml.add
[type: manpage] apt_preferences.5.xml $lang:$lang/apt_preferences.$lang.5.xml add_$lang:xml.add
[type: manpage] sources.list.5.xml $lang:$lang/sources.list.$lang.5.xml add_$lang:xml.add

[type: sgml] guide.sgml $lang:$lang/guide.$lang.sgml
# add_$lang::$lang/addendum/debiandoc_$lang.add


Loading…
Cancel
Save