as untranslated for po4a removing ~200 unless "translateable" stringstags/devuan/2.0.1+devuan1
@@ -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 | |||
@@ -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 | |||
@@ -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> | |||
@@ -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> | |||
@@ -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> | |||
@@ -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. | |||
@@ -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 | |||
@@ -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 | |||
@@ -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> | |||
@@ -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><host>::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> | |||
@@ -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> | |||
@@ -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 | |||