summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorMichael Vogt <michael.vogt@ubuntu.com>2009-07-30 15:31:39 +0200
committerMichael Vogt <michael.vogt@ubuntu.com>2009-07-30 15:31:39 +0200
commit57722714255118560c98b3245413ff5f693b993c (patch)
tree48f4e1c25d7fd07bdbec6e7effa792739c157402 /doc
parent8dfb8a0ab2c2a06e319678701c144e5156d7e869 (diff)
parentd5752e18bed18c706c93f5c43c61016c72132ede (diff)
merged from debian-sid
Diffstat (limited to 'doc')
-rw-r--r--doc/.cvsignore14
-rw-r--r--doc/apt-get.8.xml17
-rw-r--r--doc/apt.conf.5.xml41
-rw-r--r--doc/apt.ent7
-rw-r--r--doc/apt_preferences.5.xml90
-rw-r--r--doc/es/.cvsignore14
-rw-r--r--doc/examples/configure-index11
-rw-r--r--doc/fr/.cvsignore13
-rw-r--r--doc/fr/apt-get.fr.8.xml2
-rw-r--r--doc/fr/apt.conf.fr.5.xml534
-rw-r--r--doc/pt_BR/.cvsignore3
11 files changed, 579 insertions, 167 deletions
diff --git a/doc/.cvsignore b/doc/.cvsignore
deleted file mode 100644
index 94d80ad54..000000000
--- a/doc/.cvsignore
+++ /dev/null
@@ -1,14 +0,0 @@
-apt-cache.8
-apt-get.8
-apt-cdrom.8
-apt.conf.5
-sources.list.5
-apt-config.8
-apt-sortpkgs.1
-apt-ftparchive.1
-manpage.links
-manpage.refs
-manpage.log
-apt_preferences.5
-apt-extracttemplates.1
-vendors.list.5
diff --git a/doc/apt-get.8.xml b/doc/apt-get.8.xml
index 64c3a35e4..920f6b36e 100644
--- a/doc/apt-get.8.xml
+++ b/doc/apt-get.8.xml
@@ -53,6 +53,9 @@
<arg choice='plain'>
<replaceable>target_release_number_expression</replaceable>
</arg>
+ <arg choice='plain'>
+ <replaceable>target_release_codename</replaceable>
+ </arg>
</group>
</arg>
@@ -71,6 +74,9 @@
<arg choice='plain'>
/<replaceable>target_release_name</replaceable>
</arg>
+ <arg choice='plain'>
+ /<replaceable>target_release_codename</replaceable>
+ </arg>
</group>
</arg>
</arg>
@@ -357,6 +363,12 @@
actually change the system.
Configuration Item: <literal>APT::Get::Simulate</literal>.</para>
+ <para>Simulation run as user will deactivate locking (<literal>Debug::NoLocking</literal>)
+ automatical. Also a notice will be displayed indicating that this is only a simulation,
+ if the option <literal>APT::Get::Show-User-Simulation-Note</literal> is set (Default: true)
+ Neigther NoLocking nor the notice will be triggered if run as root (root should know what
+ he is doing without further warnings by <literal>apt-get</literal>).</para>
+
<para>Simulate prints out
a series of lines each one representing a dpkg operation, Configure (Conf),
Remove (Remv), Unpack (Inst). Square brackets indicate broken packages with
@@ -463,7 +475,8 @@
of this option. In short, this option
lets you have simple control over which distribution packages will be
retrieved from. Some common examples might be
- <option>-t '2.1*'</option> or <option>-t unstable</option>.
+ <option>-t '2.1*'</option>, <option>-t unstable</option>
+ or <option>-t sid</option>.
Configuration Item: <literal>APT::Default-Release</literal>;
see also the &apt-preferences; manual page.</para></listitem>
</varlistentry>
@@ -589,8 +602,8 @@
<title>CURRENT AUTHORS</title>
<para>
&apt-author.team;
- &apt-qapage;
</para>
+ &apt-qapage;
</refsect1>
&manbugs;
</refentry>
diff --git a/doc/apt.conf.5.xml b/doc/apt.conf.5.xml
index 6590c9795..2b2430c83 100644
--- a/doc/apt.conf.5.xml
+++ b/doc/apt.conf.5.xml
@@ -21,7 +21,7 @@
&apt-email;
&apt-product;
<!-- The last update date -->
- <date>06 December 2008</date>
+ <date>10 December 2008</date>
</refentryinfo>
<refmeta>
@@ -53,8 +53,9 @@
parent groups.</para>
<para>Syntactically the configuration language is modeled after what the ISC tools
- such as bind and dhcp use. Lines starting with
- <literal>//</literal> are treated as comments (ignored).
+ such as bind and dhcp use. Lines starting with
+ <literal>//</literal> are treated as comments (ignored), as well as all text
+ between <literal>/*</literal> and <literal>*/</literal>, just like C/C++ comments.
Each line is of the form
<literal>APT::Get::Assume-Yes "true";</literal> The trailing
semicolon is required and the quotes are optional. A new scope can be
@@ -110,7 +111,7 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
<varlistentry><term>Default-Release</term>
<listitem><para>Default release to install packages from if more than one
- version available. Contains release name or release version. Examples: 'stable', 'testing', 'unstable', '4.0', '5.0*'. Release codenames ('etch', 'lenny' etc.) are not allowed now. See also &apt-preferences;.</para></listitem>
+ version available. Contains release name, codename or release version. Examples: 'stable', 'testing', 'unstable', 'lenny', 'squeeze', '4.0', '5.0*'. See also &apt-preferences;.</para></listitem>
</varlistentry>
<varlistentry><term>Ignore-Hold</term>
@@ -679,6 +680,27 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</listitem>
</varlistentry>
+ <varlistentry>
+ <term><literal>Debug::pkgDepCache::Marker</literal></term>
+ <listitem>
+ <para>
+ Generate debug messages describing which package is marked
+ as keep/install/remove while the ProblemResolver does his work.
+ Each addition or deletion may trigger additional actions;
+ they are shown indented two additional space under the original entry.
+ The format for each line is <literal>MarkKeep</literal>,
+ <literal>MarkDelete</literal> or <literal>MarkInstall</literal> followed by
+ <literal>package-name &lt;a.b.c -&gt; d.e.f | x.y.z&gt; (section)</literal>
+ where <literal>a.b.c</literal> is the current version of the package,
+ <literal>d.e.f</literal> is the version considered for installation and
+ <literal>x.y.z</literal> is a newer version, but not considered for installation
+ (because of a low pin score). The later two can be omitted if there is none or if
+ it is the same version as the installed.
+ <literal>section</literal> is the name of the section the package appears in.
+ </para>
+ </listitem>
+ </varlistentry>
+
<!-- Question: why doesn't this do anything? The code says it should. -->
<varlistentry>
<term><literal>Debug::pkgInitConfig</literal></term>
@@ -757,6 +779,17 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</varlistentry>
<varlistentry>
+ <term><literal>Debug::pkgProblemResolver::ShowScores</literal></term>
+ <listitem>
+ <para>
+ Display a list of all installed packages with their calculated score
+ used by the pkgProblemResolver. The description of the package
+ is the same as described in <literal>Debug::pkgDepCache::Marker</literal>
+ </para>
+ </listitem>
+ </varlistentry>
+
+ <varlistentry>
<term><literal>Debug::sourceList</literal></term>
<listitem>
diff --git a/doc/apt.ent b/doc/apt.ent
index 6594ba1b3..4cfc00069 100644
--- a/doc/apt.ent
+++ b/doc/apt.ent
@@ -179,6 +179,13 @@
</author>
">
+<!ENTITY apt-author.moconnor "
+ <author>
+ <firstname>Mike</firstname>
+ <surname>O'Connor</surname>
+ </author>
+">
+
<!ENTITY apt-author.team "
<author>
<othername>APT team</othername>
diff --git a/doc/apt_preferences.5.xml b/doc/apt_preferences.5.xml
index 162c2f00e..ff63f1dd3 100644
--- a/doc/apt_preferences.5.xml
+++ b/doc/apt_preferences.5.xml
@@ -14,7 +14,7 @@
&apt-email;
&apt-product;
<!-- The last update date -->
- <date>29 February 2004</date>
+ <date>04 May 2009</date>
</refentryinfo>
<refmeta>
@@ -191,6 +191,15 @@ Pin-Priority: 50
</programlisting>
<simpara>The following record assigns a high priority to all package versions
+belonging to any distribution whose Codename is "<literal>squeeze</literal>".</simpara>
+
+<programlisting>
+Package: *
+Pin: release n=squeeze
+Pin-Priority: 900
+</programlisting>
+
+<simpara>The following record assigns a high priority to all package versions
belonging to any release whose Archive name is "<literal>stable</literal>"
and whose release Version number is "<literal>3.0</literal>".</simpara>
@@ -327,10 +336,11 @@ file are relevant for setting APT priorities:
<variablelist>
<varlistentry>
-<term>the <literal>Archive:</literal> line</term>
+<term>the <literal>Archive:</literal> or <literal>Suite:</literal> line</term>
<listitem><simpara>names the archive to which all the packages
in the directory tree belong. For example, the line
-"Archive: stable"
+"Archive: stable" or
+"Suite: stable"
specifies that all of the packages in the directory
tree below the parent of the <filename>Release</filename> file are in a
<literal>stable</literal> archive. Specifying this value in the APT preferences file
@@ -343,6 +353,22 @@ Pin: release a=stable
</varlistentry>
<varlistentry>
+<term>the <literal>Codename:</literal> line</term>
+<listitem><simpara>names the codename to which all the packages
+in the directory tree belong. For example, the line
+"Codename: squeeze"
+specifies that all of the packages in the directory
+tree below the parent of the <filename>Release</filename> file belong to a version named
+<literal>squeeze</literal>. Specifying this value in the APT preferences file
+would require the line:
+</simpara>
+<programlisting>
+Pin: release n=squeeze
+</programlisting>
+</listitem>
+</varlistentry>
+
+<varlistentry>
<term>the <literal>Version:</literal> line</term>
<listitem><simpara>names the release version. For example, the
packages in the tree might belong to Debian GNU/Linux release
@@ -522,7 +548,64 @@ version.
apt-get install <replaceable>package</replaceable>/unstable
</programlisting>
</para>
+</refsect2>
+
+
+<refsect2>
+<title>Tracking the evolution of a codename release</title>
+
+<para>The following APT preferences file will cause APT to assign a
+priority higher than the default (500) to all package versions belonging
+to a specified codename of a distribution and a prohibitively low priority to
+package versions belonging to other <literal>Debian</literal> distributions,
+codenames and archives.
+Note that with this APT preference APT will follow the migration of a release
+from the archive <literal>testing</literal> to <literal>stable</literal> and
+later <literal>oldstable</literal>. If you want to follow for example the progress
+in <literal>testing</literal> notwithstanding the codename changes you should use
+the example configurations above.
+
+<programlisting>
+Explanation: Uninstall or do not install any Debian-originated package versions
+Explanation: other than those in the distribution codenamed with squeeze or sid
+Package: *
+Pin: release n=squeeze
+Pin-Priority: 900
+
+Explanation: Debian unstable is always codenamed with sid
+Package: *
+Pin: release a=sid
+Pin-Priority: 800
+
+Package: *
+Pin: release o=Debian
+Pin-Priority: -10
+</programlisting>
+</para>
+
+<para>With a suitable &sources-list; file and the above preferences file,
+any of the following commands will cause APT to upgrade to the
+latest version(s) in the release codenamed with <literal>squeeze</literal>.
+
+<programlisting>
+apt-get install <replaceable>package-name</replaceable>
+apt-get upgrade
+apt-get dist-upgrade
+</programlisting>
+</para>
+
+<para>The following command will cause APT to upgrade the specified
+package to the latest version from the <literal>sid</literal> distribution.
+Thereafter, <command>apt-get upgrade</command> will upgrade
+the package to the most recent <literal>squeeze</literal> version if that is
+more recent than the installed version, otherwise, to the most recent
+<literal>sid</literal> version if that is more recent than the installed
+version.
+<programlisting>
+apt-get install <replaceable>package</replaceable>/sid
+</programlisting>
+</para>
</refsect2>
</refsect1>
@@ -535,4 +618,3 @@ apt-get install <replaceable>package</replaceable>/unstable
&manbugs;
</refentry>
-
diff --git a/doc/es/.cvsignore b/doc/es/.cvsignore
deleted file mode 100644
index ce363466a..000000000
--- a/doc/es/.cvsignore
+++ /dev/null
@@ -1,14 +0,0 @@
-apt-cache.es.8
-apt-get.es.8
-apt-cdrom.es.8
-apt.conf.es.5
-sources.list.es.5
-apt-config.es.8
-apt-sortpkgs.es.1
-apt-ftparchive.es.1
-manpage.links
-manpage.refs
-manpage.log
-apt_preferences.es.5
-apt-extracttemplates.es.1
-vendors.list.es.5
diff --git a/doc/examples/configure-index b/doc/examples/configure-index
index a4167085b..5dc7b5246 100644
--- a/doc/examples/configure-index
+++ b/doc/examples/configure-index
@@ -55,6 +55,7 @@ APT
Diff-Only "false";
Tar-Only "false";
Build-Dep-Automatic "true";
+ Show-User-Simulation-Note "true";
};
Cache
@@ -271,10 +272,14 @@ Dir "/"
// Config files
Etc "etc/apt/" {
- SourceList "sources.list";
Main "apt.conf";
- Preferences "preferences";
Parts "apt.conf.d/";
+ Preferences "preferences";
+ PreferencesParts "preferences.d";
+ SourceList "sources.list";
+ SourceParts "sources.list.d";
+ VendorList "vendors.list";
+ VendorParts "vendors.list.d";
};
// Locations of binaries
@@ -340,7 +345,9 @@ DPkg
Debug
{
pkgProblemResolver "false";
+ pkgProblemResolver::ShowScores "false";
pkgDepCache::AutoInstall "false"; // what packages apt install to satify dependencies
+ pkgDepCache::Marker "false";
pkgAcquire "false";
pkgAcquire::Worker "false";
pkgAcquire::Auth "false";
diff --git a/doc/fr/.cvsignore b/doc/fr/.cvsignore
deleted file mode 100644
index cfa89623e..000000000
--- a/doc/fr/.cvsignore
+++ /dev/null
@@ -1,13 +0,0 @@
-apt-cdrom.fr.8
-apt-config.fr.8
-apt-extracttemplates.fr.1
-apt-ftparchive.fr.1
-apt-sortpkgs.fr.1
-apt.conf.fr.5
-apt_preferences.fr.5
-manpage.links
-manpage.refs
-sources.list.fr.5
-apt-cache.fr.8
-apt-get.fr.8
-vendors.list.fr.5
diff --git a/doc/fr/apt-get.fr.8.xml b/doc/fr/apt-get.fr.8.xml
index dccf415b1..c1b8552cb 100644
--- a/doc/fr/apt-get.fr.8.xml
+++ b/doc/fr/apt-get.fr.8.xml
@@ -201,7 +201,7 @@ semblables � des sources t�l�charg�s sous forme de tarball.
<listitem><para>
Avec la commande <literal>build-dep</literal>, apt-get installe ou supprime des paquets
dans le but de satisfaire les d�pendances de construction d'un paquet source.
-Pour l'instant, dans la cas d'un paquet virtuel, un paquet est choisi au
+Pour l'instant, dans le cas d'un paquet virtuel, un paquet est choisi au
hasard.
</para></listitem>
</varlistentry>
diff --git a/doc/fr/apt.conf.fr.5.xml b/doc/fr/apt.conf.fr.5.xml
index 88ce46134..f4d8eddb8 100644
--- a/doc/fr/apt.conf.fr.5.xml
+++ b/doc/fr/apt.conf.fr.5.xml
@@ -15,7 +15,7 @@
&apt-email;
&apt-product;
<!-- The last update date -->
- <date>29 F�vrier 2004</date>
+ <date>11 juillet 2008</date>
</refentryinfo>
<refmeta>
@@ -33,26 +33,30 @@ Le fichier <filename>apt.conf</filename> est le principal fichier de configurati
de la collection d'outils que constitue APT&nbsp;; tous les outils font appel � ce
fichier de configuration et utilisent un analyseur syntaxique en ligne de
commande commun afin de fournir un environnement uniforme. Quand un outil
-d'APT d�marre, il lit (si elle existe) la variable d'environnement
-<envar>APT_CONFIG</envar>&nbsp;; puis il lit les fichiers situ�s dans
+d'APT d�marre, il lit la configuration d�sign�e par variable d'environnement
+<envar>APT_CONFIG</envar> (si elle existe), puis il lit les fichiers situ�s dans
<literal>Dir::Etc::Parts</literal> ainsi que le principal fichier de configuration
indiqu� par <literal>Dir::Etc::main</literal>&nbsp;; enfin il applique les options de
-la ligne de commande qui annulent les directives de configuration, chargeant,
-si n�cessaire, d'autres fichiers de configuration.
+la ligne de commande qui pr�valent sur les directives de configuration, chargeant
+si n�cessaire d'autres fichiers de configuration.
</para>
<para>
Le fichier de configuration est construit comme un arbre d'options
organis�es en groupes fonctionnels. On se sert du double deux points (�&nbsp;::&nbsp;�)
pour indiquer une option&nbsp;; par exemple, <literal>APT::Get::Assume-Yes</literal> est
-une option pour le groupe d'outils APT, destin�e � l'outil Get. Les options
-n'h�ritent pas des groupes de leurs parents.
+une option pour le groupe d'outils APT, destin�e � l'outil Get. Il n'y a pas d'h�ritage
+des options des groupes parents.
</para>
<para>
Syntaxiquement, le langage de configuration est con�u sur le m�me mod�le
que les langages utilis�s par des outils ISC tels que bind et dhcp. Une ligne
-qui commence par <literal>//</literal> est un commentaire et elle est ignor�e.
+qui commence par <literal>//</literal> est trait�e comme un commentaire et ignor�e, de
+m�me que les sections de texte plac�es entre <literal>/*</literal> et
+<literal>*/</literal>, tout comme les commentaires C/C++.
Chaque ligne est de la forme&nbsp;:
- <literal>APT::Get::Assume-Yes "true";</literal>
+<informalexample><programlisting>
+<literal>APT::Get::Assume-Yes "true";</literal>
+ </programlisting></informalexample>
Le point-virgule final est obligatoire et les guillemets sont optionnels.
On peut d�clarer un nouveau champ d'action avec des accolades, comme
suit&nbsp;:
@@ -68,10 +72,9 @@ APT {
</programlisting></informalexample>
<para>
-avec des retours � la ligne pour faciliter la lecture. On peut cr�er des
-listes en ouvrant un champ d'action et en mettant un seul mot entre
-apostrophes suivi d'un point-virgule. On peut mettre plusieurs entr�es,
-s�par�es par un point-virgule.
+avec des retours � la ligne pour faciliter la lecture. On peut cr�er une liste
+en ouvrant un champ d'action et en y ins�rant une cha�ne entre guillemets suivie
+d'un point virgule pour chaque �l�ment de la liste.
</para>
<informalexample><programlisting>
@@ -79,14 +82,21 @@ DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
</programlisting></informalexample>
<para>
-Les mod�les <filename>&docdir;examples/apt.conf</filename> &configureindex;
+Les mod�les <filename>&docdir;examples/apt.conf</filename> et &configureindex;
montrent � quoi devrait ressembler le fichier de configuration.
</para>
<para>
+Les identifiants des options de configuration ne sont pas sensibles � la casse.
+Dans l'exemple pr�c�dent, on pourrait donc aussi bien utiliser
+<literal>dpkg::pre-install-pkgs</literal>.
+ </para>
+<para>
Deux �l�ments sp�ciaux sont autoris�s&nbsp;: <literal>#include</literal> et
-<literal>#clear</literal>. <literal>#include</literal> inclut le fichier donn� en argument,
-� moins que le nom ne se termine par une barre oblique. <literal>#clear</literal> sert �
-effacer une liste de noms.
+<literal>#clear</literal>. <literal>#include</literal> inclut le fichier donn� en
+argument, � moins que le nom ne se termine par une barre oblique auquel cas le
+r�pertoire entier est inclus. <literal>#clear</literal> sert �
+effacer une partie de l'arbre de configuration. L'�l�ment d�sign� et tout ses
+descendants sont supprim�s.
</para>
<para>
Tous les outils d'APT poss�dent une option <option>-o</option> qui permet de
@@ -95,20 +105,31 @@ syntaxe consiste en un nom complet d'option (par exemple
<literal>APT::Get::Assume-Yes</literal>) suivi par un signe �gal, puis par la nouvelle
valeur de l'option. On peut compl�ter une liste en ajoutant un �&nbsp;::&nbsp;� au nom
de la liste.
- </para>
+ </para>
</refsect1>
<refsect1><title>Le groupe APT</title>
-<para>
-Ce groupe d'options contr�le aussi bien le comportement global d'APT que
-la prise en compte des options pour chaque outil.
+<para>
+Ce groupe d'options contr�le le comportement global d'APT et contient �galement
+des options communes � tous les outils.
</para>
<variablelist>
<varlistentry><term>Architecture</term>
<listitem><para>
L'architecture du syst�me&nbsp;; cette option positionne l'architecture � utiliser
-pour r�cup�rer des fichiers et analyser des listes de paquets. L'architecture
-interne par d�faut est celle pour laquelle APT a �t� compil�.
+pour r�cup�rer des fichiers et analyser des listes de paquets. La valeur interne par
+d�faut est l'architecture pour laquelle APT a �t� compil�.
+ </para></listitem>
+</varlistentry>
+
+<varlistentry><term>Default-Release</term>
+<listitem><para>
+Indique la distribution � utiliser par d�faut lors de l'installation d'un
+paquet si plusieurs versions sont disponibles. La valeur peut �tre un nom de
+distribution ou un num�ro de version. Exemples&nbsp;: �&nbsp;stable&nbsp;�,
+�&nbsp;testing&nbsp;�, �&nbsp;4.0&nbsp;�, �&nbsp;5.0*&nbsp;�. Les noms de codes
+des distributions (�&nbsp;etch&nbsp;�, �&nbsp;lenny&nbsp;�, etc.) ne sont pas
+permis pour l'instant. Voir aussi &apt-preferences;.
</para></listitem>
</varlistentry>
@@ -123,7 +144,7 @@ dans sa prise de d�cision.
<varlistentry><term>Clean-Installed</term>
<listitem><para>
Avec cette option qui est activ�e par d�faut, la fonctionnalit� �&nbsp;autoclean&nbsp;�
-supprime tout paquet qui ne peut plus �tre r�cup�r� dans le cache.
+supprime du cache tout paquet qui ne peut plus �tre r�cup�r�.
Quand cette option est d�sactiv�e, les paquets qui sont install�s localement
sont aussi exclus du nettoyage - mais notez que APT ne fournit aucun moyen
direct pour les r�installer.
@@ -134,9 +155,9 @@ direct pour les r�installer.
<listitem><para>
D�sactive la configuration imm�diate&nbsp;; cette dangereuse option d�sactive
une partie du code de mise en ordre de APT pour que ce dernier effectue le
-moins d'appels possible � Dpkg. C'est peut-�tre n�cessaire sur des syst�mes
-lents � un seul utilisateur mais c'est extr�mement dangereux et cela peut
-faire �chouer les scripts d'installation, voire pire.
+moins d'appels possible � &dpkg;. �a peut �tre n�cessaire sur des syst�mes
+� un seul utilisateur extr�mement lents, mais cette option est tr�s dangereuse et
+peut faire �chouer les scripts d'installation, voire pire.
Utilisez-la � vos risques et p�rils.
</para></listitem>
</varlistentry>
@@ -155,39 +176,37 @@ ou tous les paquets dont ces paquets d�pendent.
<varlistentry><term>Cache-Limit</term>
<listitem><para>
-APT utilise un fichier cache d'une taille m�moire fixe pour ranger les
-informations du fichier �&nbsp;available&nbsp;�. Cette option fixe la taille
-de ce cache.
+APT utilise un fichier de cache charg� en m�moire avec mmap pour ranger les
+informations sur les paquets disponibles. Cette option fixe la taille m�moire
+allou�e pour le chargement de ce cache.
</para></listitem>
</varlistentry>
<varlistentry><term>Build-Essential</term>
<listitem><para>
Cette option d�finit les paquets qui sont consid�r�s comme faisant partie
-des d�pendances essentielles pour la construction des paquets.
+des d�pendances essentielles pour la construction de paquets.
</para></listitem>
</varlistentry>
<varlistentry><term>Get</term>
<listitem><para>La sous-section <literal>Get</literal> contr�le l'outil &apt-get;,
-veuillez consulter
-sa documentation pour avoir plus d'informations sur les options en question.
+veuillez consulter sa documentation pour avoir plus d'informations sur les options
+en question.
</para></listitem>
</varlistentry>
<varlistentry><term>Cache</term>
-<listitem><para>La sous-section <literal>Cache</literal> contr�le l'outil &apt-cache;,
-veuillez
-consulter sa documentation pour avoir plus d'informations sur les options en
-question.
+<listitem><para>La sous-section <literal>Cache</literal> contr�le l'outil
+&apt-cache;, veuillez consulter sa documentation pour avoir plus d'informations
+sur les options en question.
</para></listitem>
</varlistentry>
<varlistentry><term>CDROM</term>
-<listitem><para>La sous-section <literal>CDROM</literal> contr�le l'outil&apt-cdrom;,
-veuillez
-consulter sa documentation pour avoir plus d'informations sur les options en
-question.
+<listitem><para>La sous-section <literal>CDROM</literal> contr�le l'outil
+&apt-cdrom;, veuillez consulter sa documentation pour avoir plus d'informations
+sur les options en question.
</para></listitem>
</varlistentry>
</variablelist>
@@ -199,13 +218,20 @@ Le groupe d'options <literal>Acquire</literal> contr�le le t�l�chargement des pa
les gestionnaires d'URI.
<variablelist>
+<varlistentry><term>PDiffs</term>
+<listitem><para>Essayer de t�l�charger les fichiers diff�rentiels appel�s
+<literal>PDiffs</literal> pour les paquets ou les fichiers sources, plut�t que
+de les t�l�charger enti�rement. Par d�faut � �&nbsp;true&nbsp;�.
+ </para></listitem>
+</varlistentry>
+
<varlistentry><term>Queue-Mode</term>
<listitem><para>
-Le mode file d'attente&nbsp;; <literal>Queue-Mode</literal> peut prendre une valeur
-parmi <literal>host</literal> ou <literal>access</literal> et cela d�termine comment APT
-parall�lise les connexions sortantes. <literal>Host</literal> signifie qu'une
-connexion par cible sera initi�e, tandis que <literal>access</literal> signifie qu'une
-connexion par type d'URI sera initi�e.
+Le mode de file d'attente&nbsp;; <literal>Queue-Mode</literal> peut prendre les
+valeurs <literal>host</literal> ou <literal>access</literal> et cela d�termine
+comment APT parall�lise les connexions sortantes. <literal>Host</literal> signifie
+qu'une connexion par cible sera initi�e, tandis que <literal>access</literal> signifie
+qu'une connexion par type d'URI sera initi�e.
</para></listitem>
</varlistentry>
@@ -227,30 +253,32 @@ Par d�faut � �&nbsp;true&nbsp;�.
<varlistentry><term>http</term>
<listitem><para>
-URI HTTP ; http::Proxy est le mandataire (proxy) http � utiliser par d�faut.
+URI HTTP&nbsp;; http::Proxy est le mandataire (proxy) HTTP � utiliser par d�faut.
Il se pr�sente sous la forme standard&nbsp;:
-<literal>http://[[user][:pass]@]host[:port]/</literal>. En utilisant la syntaxe&nbsp;:
-<literal>http::Proxy::&lt;host&gt;</literal>, o� le mot-cl� sp�cial <literal>DIRECT</literal>
-indique de n'utiliser aucun mandataire, on peut sp�cifier un mandataire
-pour chaque machine distante. La variable d'environnement <envar>http_proxy</envar>
-remplace tous ces param�tres.
+<literal>http://[[user][:pass]@]host[:port]/</literal>. On peut sp�cifier un
+mandataire particulier par h�te distant en utilisant la syntaxe&nbsp;:
+<literal>http::Proxy::&lt;h�te&gt;</literal>. Le mot-cl� sp�cial
+<literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour
+l'h�te.
+Lorsqu'elle est d�finie, la variable d'environnement <envar>http_proxy</envar>
+annule et remplace toutes les options de mandataire HTTP.
</para>
<para>
-Trois options de configuration sont fournies pour le contr�le des caches qui
-sont compatibles avec HTTP/1.1. <literal>No-Cache</literal> signifie que le mandataire
-ne doit pas du tout utiliser les r�ponses qu'il a stock�es&nbsp;; <literal>Max-Age</literal>
+Trois options de configuration sont fournies pour le contr�le des caches compatibles
+avec HTTP/1.1. <literal>No-Cache</literal> signifie que le mandataire ne doit jamais
+utiliser les r�ponses qu'il a stock�es&nbsp;; <literal>Max-Age</literal>
sert uniquement pour les fichiers d'index&nbsp;: cela demande au cache de les
mettre � jour quand leur anciennet� est sup�rieure au nombre de secondes
-donn�. Debian met � jour son fichier d'index de mani�re journali�re, la
+donn�. Debian met � jour ses fichiers d'index de mani�re quotidienne&nbsp;; la
valeur par d�faut est donc de 1 jour. <literal>No-Store</literal> sert uniquement
-pour les fichiers d'archive&nbsp;: cela demande au cache de ne jamais garder
+pour les fichiers d'archive&nbsp; et demande au cache de ne jamais garder
la requ�te. Cela peut �viter de polluer un cache mandataire avec des
fichiers .deb tr�s grands. Note&nbsp;: Squid 2.0.2 ne prend en compte aucune de
ces options.
</para>
<para>
L'option <literal>timeout</literal> positionne le compteur de temps mort (timeout)
-utilis� par la m�thode&nbsp;: cela vaut pour tout (connexion, donn�es).
+utilis� par la m�thode. Cela vaut pour tout, connexion et donn�es.
</para>
<para>
Une option de configuration est fournie pour contr�ler la profondeur du tube
@@ -264,27 +292,62 @@ ne respectent pas la RFC 2068.
</para></listitem>
</varlistentry>
+<varlistentry><term>https</term>
+<listitem><para>
+URI HTTPS. Les options de contr�le de cache et de mandataire (proxy) sont les
+m�mes que pour la m�thode <literal>http</literal>. L'option
+<literal>Pipeline-Depth</literal> n'est pas encore support�e.
+ </para>
+
+<para>La sous-option <literal>CaInfo</literal> sp�cifie le fichier contenant
+les informations sur les certificats de confiance.
+La sous-option bool�enne <literal>Verify-Peer</literal> pr�cise si le
+certificat d'h�te du serveur doit �tre confront� aux certificats de confiance
+ou pas. La sous-option bool�enne <literal>Verify-Host</literal> pr�cise s'il
+faut v�rifier ou pas le nom d'h�te du serveur. <literal>SslCert</literal>
+d�termine le certificat � utiliser pour l'authentification du client.
+<literal>SslKey</literal> d�termine quelle clef priv�e doit �tre utilis�e pour
+l'authentification du client. <literal>SslForceVersion</literal> surcharge la
+valeur par d�faut pour la version de SSL � utiliser et peut contenir l'une des
+cha�nes 'TLSv1' ou 'SSLv3'.
+ </para>
+<para>Chacune de ces options peut �tre sp�cifi�e pour un h�te particulier en
+utilisant <literal>&lt;h�te&gt;::CaInfo</literal>,
+<literal>&lt;h�te&gt;::Verify-Peer</literal>,
+<literal>&lt;h�te&gt;::Verify-Host</literal>,
+<literal>&lt;h�te&gt;::SslCert</literal>,
+<literal>&lt;h�te&gt;::SslKey</literal> et
+<literal>&lt;h�te&gt;::SslForceVersion</literal> respectivement.
+ </para></listitem>
+</varlistentry>
+
<varlistentry><term>ftp</term>
<listitem><para>
-URI FTP ; ftp::Proxy est le serveur mandataire par d�faut � utiliser. Il se
-pr�sente sous la forme standard&nbsp;:
-<literal>ftp://[[user][:pass]@]host[:port]/</literal>&nbsp;; il est remplac� par la
-variable d'environnement <envar>ftp_proxy</envar>. Pour utiliser un mandataire ftp,
-vous devez renseigner l'entr�e <literal>ftp::ProxyLogin</literal> dans le fichier de
-configuration. Cette entr�e sp�cifie les commandes qui disent au serveur
-mandataire comment se connecter. Voyez &configureindex; pour savoir
-comment faire. Les variables de substitution disponibles sont&nbsp;:
-<literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>, <literal>$(SITE_USER)</literal>,
-<literal>$(SITE_PASS)</literal>, <literal>$(SITE)</literal>, et <literal>$(SITE_PORT)</literal>.
-Chacune correspond � un �l�ment de l'URI.
+URI FTP&nbsp;; ftp::Proxy est le mandataire (proxy) FTP � utiliser par d�faut.
+Il se pr�sente sous la forme standard&nbsp;:
+<literal>ftp://[[user][:pass]@]host[:port]/</literal>. On peut sp�cifier un
+mandataire particulier par h�te distant en utilisant la syntaxe&nbsp;:
+<literal>ftp::Proxy::&lt;h�te&gt;</literal>. Le mot-cl� sp�cial
+<literal>DIRECT</literal> indique alors de n'utiliser aucun mandataire pour
+l'h�te. Lorsqu'elle est d�finie, la variable d'environnement
+<envar>ftp_proxy</envar> annule et replace toutes les options de mandataire
+FTP. Pour utiliser un mandataire FTP, vous devrez renseigner l'entr�e
+<literal>ftp::ProxyLogin</literal> dans le fichier de configuration. Cette
+entr�e sp�cifie les commandes � envoyer au mandataire pour lui pr�ciser � quoi
+il doit se connecter. Voyez &configureindex; pour savoir comment faire. Les
+variables de substitution disponibles sont&nbsp;:
+<literal>$(PROXY_USER)</literal>, <literal>$(PROXY_PASS)</literal>,
+<literal>$(SITE_USER)</literal>, <literal>$(SITE_PASS)</literal>,
+<literal>$(SITE)</literal> et <literal>$(SITE_PORT)</literal>. Chacune
+correspond � l'�l�ment respectif de l'URI.
</para>
<para>
-L'option <literal>timeout</literal> positionne le compteur de temps mort (timeout)
-utilis� par la m�thode&nbsp;: cela vaut pour tout (connexion, donn�es).
+L'option <literal>timeout</literal> positionne le compteur de temps mort
+(timeout) utilis� par la m�thode. Cela vaut pour tout, connexion et donn�es.
</para>
<para>
Plusieurs options de configuration sont fournies pour contr�ler le mode
-passif. G�n�ralement, c'est plus s�r d'activer le mode passif&nbsp;; cela
+passif. Il est g�n�ralement plus s�r d'activer le mode passif et cela
marche dans presque tous les environnements. Cependant, certaines situations
n�cessitent que le mode passif soit d�sactiv� et que le mode
�&nbsp;port&nbsp;� de ftp
@@ -293,16 +356,18 @@ connexions qui passent par un mandataire ou pour une machine
sp�cifique (examinez le mod�le de fichier de configuration).
</para>
<para>
-On peut utiliser un mandataire FTP pour atteindre une cible HTTP en
-positionnant la variable d'environnement <envar>ftp_proxy</envar> � une url http --
-consultez la m�thode http ci-dessus pour la syntaxe. On ne peut pas fixer
-cette variable dans le fichier de configuration et il n'est pas recommand�
-d'utiliser HTTP par FTP � cause de son peu d'efficacit�.
+Il est possible de faire transiter le trafic FTP par un mandataire HTTP en
+positionnant la variable d'environnement <envar>ftp_proxy</envar> � une URL
+HTTP --
+consultez la m�thode http ci-dessus pour la syntaxe. On ne peut pas le faire
+dans le fichier de configuration et il n'est de toute fa�on pas recommand�
+d'utiliser FTP au travers de HTTP en raison la faible efficacit� de cette
+m�thode.
</para>
<para>
L'option <literal>ForceExtended</literal> contr�le l'utilisation des commandes li�es
� la RFC 2428, <literal>EPSV</literal> et <literal>EPRT</literal>. Par d�faut, elle vaut
-�&nbsp;false&nbsp;�&nbsp;; ce qui signifie que ces commandes ne sont
+�&nbsp;false&nbsp;� ce qui signifie que ces commandes ne sont
utilis�es que pour une connexion de type IPv6. Quand elle vaut
�&nbsp;true&nbsp;�, on les utilise m�me si la connexion est de type IPv4. La
plupart des serveurs FTP ne suivent pas la RFC 2428.
@@ -311,7 +376,7 @@ plupart des serveurs FTP ne suivent pas la RFC 2428.
<varlistentry><term>cdrom</term>
<listitem><para>
-URI CDROM&nbsp;; la seule option de configuration pour les URI de CDROM
+URI c�d�rom&nbsp;; la seule option de configuration pour les URI de c�d�rom
est le point de montage&nbsp;: <literal>cdrom::Mount</literal>&nbsp;; il doit
repr�senter le point de montage du lecteur de c�d�rom indiqu� dans
<filename>/etc/fstab</filename>.
@@ -326,9 +391,9 @@ peuvent �tre sp�cifi�es en utilisant <literal>UMount</literal>.
<varlistentry><term>gpgv</term>
<listitem><para>
-URI GPGV ; la seule option pour les URI GPGV est celle qui permet de
+URI GPGV&nbsp;; la seule option pour les URI GPGV est celle qui permet de
passer des param�tres � gpgv.
- <literal>gpgv::Options</literal> Options suppl�mentaires pass�es �
+ <literal>gpgv::Options</literal>&nbsp;: options suppl�mentaires pass�es �
gpgv.
</para>
</listitem>
@@ -341,7 +406,8 @@ URI GPGV ; la seule option pour les URI GPGV est celle qui permet de
<para>
Les r�pertoires de la section <literal>Dir::State</literal> concernent le syst�me
local. <literal>lists</literal> est le r�pertoire o� placer les listes de paquets
-t�l�charg�s et <literal>status</literal> est le nom du fichier d'�tat de Dpkg.
+t�l�charg�s et <literal>status</literal> est le nom du fichier d'�tat de
+&dpkg;.
<literal>preferences</literal> concerne APT&nbsp;: c'est le nom du fichier des
pr�f�rences.
<literal>Dir::State</literal> contient le r�pertoire par d�faut pr�fix� � tous les
@@ -353,8 +419,8 @@ ou <filename>./</filename>.
cache local&nbsp;: par exemple, les deux caches de paquets
<literal>srcpkgcache</literal> et <literal>pkgcache</literal>, et aussi l'endroit o� sont
plac�es les archives t�l�charg�es, <literal>Dir::Cache::archives</literal>. On peut
-emp�cher la cr�ation des caches en laissant leur nom en blanc. Cela ralentit
-le d�marrage mais cela sauve de l'espace disque. Il vaut mieux se passer du
+emp�cher la cr�ation des caches en saisissant un nom vide. Cela ralentit
+le d�marrage mais sauve de l'espace disque. Il vaut mieux se passer du
cache <literal>pkgcache</literal> plut�t que se passer du cache <literal>srcpkgcache</literal>.
Comme pour <literal>Dir::State</literal>, le r�pertoire par d�faut est contenu dans
<literal>Dir::Cache</literal>.
@@ -375,11 +441,22 @@ de configuration est charg�.
Les programmes binaires sont point�s par <literal>Dir::Bin</literal>.
L'emplacement des gestionnaires de m�thodes est indiqu� par
<literal>Dir::Bin::Methods</literal>&nbsp;; <literal>gzip</literal>,
-<literal>Dpkg</literal>, <literal>apt-get</literal>,
+<literal>dpkg</literal>, <literal>apt-get</literal>,
<literal>dpkg-source</literal>, <literal>dpkg-buildpackage</literal>
et <literal>apt-cache</literal>
indiquent l'emplacement des programmes correspondants.
- </para>
+ </para>
+<para>
+L'option de configuration <literal>RootDir</literal> a une signification
+particuli�re. Lorsqu'elle est d�finie, tous les chemins d�clar�s dans
+<literal>Dir::</literal> sont consid�r�s relativement �
+<literal>RootDir</literal>, <emphasis>m�me les chemins sp�cifi�s de mani�re
+absolue</emphasis>. Ainsi par exemple si <literal>RootDir</literal> est
+d�fini comme <filename>/tmp/staging</filename>, et que chemin du fichier d'�tat
+<literal>Dir::State::status</literal> est d�clar� comme
+<filename>/var/lib/dpkg/status</filename> alors ce fichier sera cherch�
+dans <filename>/tmp/staging/var/lib/dpkg/status</filename>.
+ </para>
</refsect1>
<refsect1><title>APT et DSelect</title>
@@ -406,14 +483,14 @@ de nouveaux paquets.
<varlistentry><term>Options</term>
<listitem><para>
-Le contenu de cette variable est pass� � &apt-get; avec les options de la ligne
-de commande quand ce programme est utilis� dans la phase d'installation.
+Le contenu de cette variable est pass� comme options de ligne de commande �
+&apt-get; lors de la phase d'installation.
</para></listitem>
</varlistentry>
<varlistentry><term>UpdateOptions</term>
<listitem><para>
-Le contenu de cette variable est pass� � &apt-get; avec les options de la
-ligne de commande quand ce programme est utilis� dans la phase de mise � jour.
+Le contenu de cette variable est pass� comme options de ligne de commande �
+&apt-get; lors de la phase de mise � jour.
</para></listitem>
</varlistentry>
@@ -427,7 +504,7 @@ qu'en cas d'erreur que l'on propose � l'utilisateur d'intervenir.
</variablelist>
</refsect1>
-<refsect1><title>Comment APT appelle Dpkg</title>
+<refsect1><title>Comment APT appelle &dpkg;</title>
<para>
Plusieurs directives de configuration contr�lent la mani�re dont APT
invoque &dpkg;&nbsp;: elles figurent dans la section <literal>DPkg</literal>.
@@ -435,8 +512,8 @@ invoque &dpkg;&nbsp;: elles figurent dans la section <literal>DPkg</literal>.
<variablelist>
<varlistentry><term>Options</term>
<listitem><para>
-Il s'agit d'une liste d'options � passer � dpkg. Les options doivent �tre
-d�clar�es en utilisant la notation de liste et chaque �l�ment de liste est
+Il s'agit d'une liste d'options � passer � &dpkg;. Les options doivent �tre
+d�clar�es en utilisant la notation de liste et chaque �l�ment de la liste est
pass� comme un seul argument � &dpkg;.
</para></listitem>
</varlistentry>
@@ -450,7 +527,7 @@ liste. Les commandes sont appel�es dans l'ordre, en utilisant
</varlistentry>
<varlistentry><term>Pre-Install-Pkgs</term>
<listitem><para>
-Il s'agit d'une liste de commandes shell � ex�cuter avant d'appeler Dpkg.
+Il s'agit d'une liste de commandes shell � ex�cuter avant d'appeler &dpkg;.
Tout comme pour <literal>Options</literal>, on doit utiliser la notation de liste.
Les commandes sont appel�es dans l'ordre, en utilisant
<filename>/bin/sh</filename>&nbsp;: APT s'arr�te d�s que l'une d'elles �choue. Sur
@@ -467,7 +544,7 @@ commande pass�e � <literal>Pre-Install-Pkgs</literal>.
</varlistentry>
<varlistentry><term>Run-Directory</term>
<listitem><para>
-APT se place dans ce r�pertoire avant d'appeler Dpkg&nbsp;; par d�faut c'est
+APT se place dans ce r�pertoire avant d'appeler &dpkg;&nbsp;; par d�faut c'est
le r�pertoire <filename>/</filename>.
</para></listitem>
</varlistentry>
@@ -481,25 +558,262 @@ cr��s.
</variablelist>
</refsect1>
+<refsect1>
+<title>Options �&nbsp;Periodic&nbsp;� et �&nbsp;Archive&nbsp;�</title>
+<para>
+Les groupes d'options <literal>APT::Periodic</literal> et
+<literal>APT::Archive</literal> configurent les comportements p�riodiques
+r�alis�s par le script <literal>/etc/cron.daily/apt</literal>, lanc�
+quotidiennement.
+ </para>
+<variablelist>
+<varlistentry><term>APT::Periodic</term>
+<para>Les options de cette section permettent de configurer la fr�quence
+d'ex�cution des t�ches APT lanc�es automatiquement. Ces param�tre prennent
+comme valeurs des p�riodicit�s d'ex�cution en nombre de jours.
+ </para>
+<listitem><para>
+<literal>Update-Package-List</literal>&nbsp;: p�riodicit� de mise � jour de la
+liste des paquets disponibles. (0 = d�sactiv�)
+ </para></listitem>
+<listitem><para>
+<literal>Download-Upgradable-Packages</literal>&nbsp;: p�riodicit� de
+t�l�chargement dans le cache des paquets pour lesquels une mise � jour est
+disponible. (0 = d�sactiv�)
+ </para></listitem>
+<listitem><para>
+<literal>AutocleanInterval</literal>&nbsp;: p�riodicit� des
+�&nbsp;autoclean&nbsp;�, c'est � dire de la suppression du cache des paquets
+qui ne peuvent plus �tre t�l�charg�s. (0 = d�sactiv�)
+ </para></listitem>
+<listitem><para>
+<literal>Unattended-Upgrade</literal>&nbsp;: p�riodicit� de mise � jour
+automatique du syst�me sans intervention humaine. Le paquet
+<literal>unattended-upgrades</literal> doit �tre install� pour que cette t�che
+s'ex�cute. Le cas �ch�ant un fichier journal est �crit dans
+<literal>/var/log/unattended-upgrades</literal>. (0 = d�sactiv�)
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>APT::Archive</term>
+<para>Les options de la section APT::Archive permettent de contr�ler la taille
+du cache de paquets.
+ </para>
+<listitem><para>
+<literal>MaxAge</literal>&nbsp;: anciennet� maximale d'un paquet dans le cache,
+en nombre de jours. Les paquets plus anciens sont supprim�s. (0 = d�sactiv�)
+ </para></listitem>
+<listitem><para>
+<literal>MaxSize</literal>&nbsp;: taille maximale du cache en Mo. (0 =
+d�sactive) Si ce maximum est d�pass�, des paquets sont supprim�s jusqu'� ce
+que la taille du cache repasse sous la limite. Les paquets les plus volumineux
+sont supprim�s en premier.
+ </para></listitem>
+<listitem><para>
+<literal>MinAge</literal>&nbsp;: age minimum d'un paquet du cache, en nombre de
+jours (0 = d�sactiv�). Un paquet plus r�cent ne sera pas supprim�. Cette option
+est utile pour garder � disposition une version des paquets en cas de probl�me
+grave.
+ </para></listitem>
+</varlistentry>
+</variablelist>
+</refsect1>
+
<refsect1><title>Les options de d�bogage</title>
-<para>
-La plupart des options de la section <literal>debug</literal> n'ont aucun int�r�t
-pour le simple utilisateur&nbsp;; cependant,
-<literal>Debug::pkgProblemResolver</literal> affiche d'int�ressantes informations sur
-les d�cisions que prend la commande dist-upgrade. <literal>Debug::NoLocking</literal>
-d�sactive le verrouillage de fichier de mani�re � ce que APT puisse effectuer
-quelques op�rations sans �tre �&nbsp;root&nbsp;� et
-<literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande � chaque appel de
-Dpkg. <literal>Debug::IdentCdrom</literal> d�sactive l'inclusion de
-donn�es de type statfs dans les ID de CDROM.
-<literal>Debug::Acquire::gpgv</literal> D�bogage de la m�thode gpgv.
- </para>
+<para>
+Les options de la section <literal>Debug::</literal> servent soit � provoquer
+l'affichage d'informations de d�bogage sur la sortie d'erreur standard du
+programme qui utilise les librairies APT, soit � activer des modes de
+fonctionnement sp�ciaux qui sont principalement utiles pour d�boguer le
+comportement de <literal>APT</literal>. La plupart de ces options n'ont pas
+d'int�r�t pour un utilisateur normal, mais certaines peuvent tout de m�me �tre
+utiles&nbsp;:
+ </para>
+<itemizedlist>
+<listitem><para>
+<literal>Debug::pkgProblemResolver</literal> affiche d'int�ressantes
+informations sur les d�cisions prises par les commandes <literal>dist-upgrade,
+upgrade, install, remove et purge</literal>.
+ </para></listitem>
+<listitem><para>
+<literal>Debug::NoLocking</literal> d�sactive le verrouillage de fichier de
+mani�re � ce que APT puisse effectuer quelques op�rations (telles que
+<literal>apt-get -s install</literal>) sans �tre �&nbsp;root&nbsp;�.
+ </para></listitem>
+<listitem><para>
+<literal>Debug::pkgDPkgPM</literal> affiche la ligne de commande � chaque appel
+de &dpkg;.
+ </para></listitem>
+<listitem><para>
+<literal>Debug::IdentCdrom</literal> d�sactive l'inclusion de donn�es de type
+statfs dans les ID de c�d�rom.
+ </para></listitem>
+</itemizedlist>
+
+<para>Voici une liste compl�te des options de d�bogage de APT.</para>
+<variablelist>
+<varlistentry><term>Debug::Acquire::cdrom</term>
+<listitem><para>
+Affiche les informations concernant les sources de type cdrom://
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::Acquire::ftp</term>
+<listitem><para>
+Affiche les informations concernant le t�l�chargement de paquets par FTP.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::Acquire::http</term>
+<listitem><para>
+Affiche les informations concernant le t�l�chargement de paquets par HTTP.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::Acquire::https</term>
+<listitem><para>
+Affiche les informations concernant le t�l�chargement de paquets par HTTPS.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::Acquire::gpgv</term>
+<listitem><para>
+Affiche les informations relatives � la v�rification de signatures
+cryptographiques avec <literal>gpg</literal>.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::aptcdrom</term>
+<listitem><para>
+Affiche des informations concernant l'acc�s aux collections de paquets
+stock�es sur c�d�rom.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::BuildDeps</term>
+<listitem><para>
+D�crit le processus de r�solution des d�pendances pour la construction de
+paquets source (&nbsp;�&nbsp;build-dependencies&nbsp;�&nbsp;) par &apt-get;.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::Hashes</term>
+<listitem><para>
+Affiche toutes les clefs de hachage cryptographiques g�n�r�es par les
+librairies APT.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::IdentCdrom</term>
+<listitem><para>D�sactive l'inclusion des donn�es de type
+<literal>statfs</literal> pour la g�n�ration des ID de c�d�rom, � savoir le
+nombre de blocs libres et utilis�s sur le syst�me de fichier du c�d�rom.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::NoLocking</term>
+<listitem><para>
+D�sactive le verrouillage de fichiers. Cela permet par exemple de lancer deux
+instances de �&nbsp;apt-get update&nbsp;� en m�me temps.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire</term>
+<listitem><para>
+Trace les ajouts et suppressions d'�l�ments de la queue globale de
+t�l�chargement.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::Auth</term>
+<listitem><para>
+Affiche les d�tails de la v�rification des sommes de contr�le et des signatures
+cryptographiques des fichiers t�l�charg�s, ainsi que les erreurs �ventuelles.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::Diffs</term>
+<listitem><para>
+Affiche les informations de t�l�chargement et de prise en compte des fichiers
+diff�rentiels des indexes de paquets, ainsi que les erreurs �ventuelles.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::RRed</term>
+<listitem><para>
+Affiche les d�tails de la v�rification des sommes de contr�le et des signatures
+cryptographiques des fichiers t�l�charg�s, ainsi que les erreurs �ventuelles.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::Worker</term>
+<listitem><para>
+Affiche toutes les interactions avec les processus enfants qui se chargent
+effectivement des t�l�chargements.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgAcquire::pkgAutoRemove</term>
+<listitem><para>
+Affiche les changements concernant le marquage des paquets comme install�s
+automatiquement, et la suppression des paquets inutiles.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgDepCache::AutoInstall</term>
+<listitem><para>
+G�n�re les informations de d�bogage d�crivant quels paquets sont install�s
+automatiquement pour satisfaire les d�pendances. Cela concerne la passe
+initiale d'installation automatique effectu�e par exemple par
+<literal>apt-get install</literal> et pas le syst�me de r�solution de
+d�pendances complet de APT&nbsp;; voir
+<literal>Debug::pkgProblemResolver</literal> pour ce dernier.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgInitConfig</term>
+<listitem><para>
+Au lancement, affiche l'ensemble de la configuration sur la sortie d'erreur
+standard.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgDPkgPM</term>
+<listitem><para>
+Affiche la commande exacte d'invocation de &dpkg; � chaque appel&nbsp;; les
+arguments sont s�par�s par des espaces.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgDPkgProgressReporting</term>
+<listitem><para> Affiche l'ensemble des informations re�ues de &dpkg; par
+l'interm�diaire du descripteur de fichier d'�tat, et les �ventuelles erreurs
+d'analyse de ce fichier.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgOrderList</term>
+<listitem><para>
+Affiche les �tapes de l'algorithme utilis� pour choisir l'ordre dans lequel APT
+passe les paquets � &dpkg;.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgPackageManager</term>
+<listitem><para>
+Affiche le d�tail des op�rations li�es � l'invocation de &dpkg;.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgPolicy</term>
+<listitem><para>
+Au lancement, affiche la priorit� de chaque liste de paquets.
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::pkgProblemResolver</term>
+<listitem><para>
+Affiche la trace d'ex�cution du syst�me de r�solution de d�pendances (ne
+concerne que les cas o� un probl�me de d�pendances complexe se pr�sente).
+ </para></listitem>
+</varlistentry>
+<varlistentry><term>Debug::sourceList</term>
+<listitem><para>
+Affiche les fournisseurs d�clar�s dans le fichier
+<filename>/etc/apt/vendors.list</filename>.
+ </para></listitem>
+</varlistentry>
+<!-- 2009/07/11 Utilis� nulle part actuellement, le code est comment�.
+<varlistentry><term>Debug::Vendor</term>
+<listitem><para>
+Affiche les informations sur la recherche de fournisseurs.
+ </para></listitem>
+</varlistentry>
+-->
+</variablelist>
+
</refsect1>
<refsect1><title>Exemples</title>
<para>
-Le fichier &configureindex; contient un mod�le de fichier montrant les valeurs par
-d�faut de toutes les options possibles.
+Le fichier &configureindex; contient un mod�le de fichier montrant des exemples
+pour toutes les options existantes.
</para>
</refsect1>
@@ -514,4 +828,4 @@ d�faut de toutes les options possibles.
&manbugs;
&deux-traducteurs;
-</refentry> \ No newline at end of file
+</refentry>
diff --git a/doc/pt_BR/.cvsignore b/doc/pt_BR/.cvsignore
deleted file mode 100644
index 8d11bcc88..000000000
--- a/doc/pt_BR/.cvsignore
+++ /dev/null
@@ -1,3 +0,0 @@
-apt_preferences.pt_BR.5
-manpage.links
-manpage.refs