Add pt_BR translation of apt_preferences(5). Also, bui...

Author: doogie
Date: 2003-04-27 00:25:57 GMT
Add pt_BR translation of apt_preferences(5).  Also, build fr manpages.

1 files changed, 436 insertions, 0 deletions

diff --git a/doc/fr/apt.conf.fr.5.sgml b/doc/fr/apt.conf.fr.5.sgml
new file mode 100644
index 000000000..3e104203e
--- /dev/null
+++ b/doc/fr/apt.conf.fr.5.sgml
@@ -0,0 +1,436 @@
+<!-- -*- mode: sgml; mode: fold -*- -->
+<!-- translation of version 1.5 -->
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+
+<!ENTITY % aptent SYSTEM "apt.ent.fr">
+%aptent;
+
+]>
+
+<refentry lang=fr>
+ &apt-docinfo;
+ 
+ <refmeta>
+   <refentrytitle>apt.conf</>
+   <manvolnum>5</>
+ </refmeta>
+ 
+ <!-- Man page title -->
+ <refnamediv>
+    <refname>apt.conf</>
+    <refpurpose>Fichier de configuration pour APT</>
+ </refnamediv>
+ 
+ <RefSect1><Title>Description</>
+   <para>   
+   <filename/apt.conf/ est le principal fichier de configuration de la 
+collection d'outils que constitue APT&thinsp;; tous les outils font appel à ce 
+fichier de configuration et utilisent un analyseur syntaxique de 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/&thinsp;; puis il lit les fichiers situés dans 
+<literal/Dir::Etc::Parts/ ainsi que le principal fichier de configuration
+indiqué par <literal/Dir::Etc::main/&thinsp;; 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.
+   <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&thinsp;; par exemple, <literal/APT::Get::Assume-Yes/ 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.
+   <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. Chaque 
+ligne est de la forme&nbsp;:
+   <literallayout>APT::Get::Assume-Yes "true";</literallayout> 
+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;:
+<informalexample><programlisting>   
+APT {
+  Get {
+    Assume-Yes "true";
+    Fix-Broken "true";
+  };
+};
+</programlisting></informalexample>
+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.
+<informalexample><programlisting>   
+DPkg::Pre-Install-Pkgs {"/usr/sbin/dpkg-preconfigure --apt";};
+</programlisting></informalexample>
+   <para>
+Les modèles <filename>&docdir;examples/apt.conf</> &configureindex;
+montrent à quoi devrait ressembler le fichier de configuration.
+   <para>
+Deux éléments spéciaux sont autorisés&nbsp;: <literal/#include/ et 
+<literal/#clear/. <literal/#include/ inclut le fichier donné en argument, à 
+moins que le nom se termine par une barre oblique. <literal/#clear/ sert à 
+effacer une liste de noms.
+   <para>
+Tous les outils d'APT possèdent une option <option>-o</> qui permet de 
+spécifier une configuration arbitraire depuis la ligne de commande. La 
+syntaxe consiste en un nom complet d'option (par exemple 
+<literal/APT::Get::Assume-Yes/) 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.
+ </RefSect1>
+
+ <RefSect1><Title>Le groupe APT</>
+   <para>   
+Ce groupe d'options contrôle aussi bien le comportement global d' APT que
+la prise en compte des options pour chaque outil.
+
+   <VariableList>
+     <VarListEntry><Term>Architecture</Term>
+     <ListItem><Para>
+L'architecture du système&thinsp;; 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é.
+     </VarListEntry>
+     
+     <VarListEntry><Term>Ignore-Hold</Term>
+     <ListItem><Para>
+Ignore les paquets «&nbsp;suspendus&nbsp;»&thinsp;; cette option globale indique au système de
+résolution de ne pas tenir compte des paquets «&nbsp;suspendus&nbsp;» dans sa prise de
+décision.
+     </VarListEntry>
+
+     <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.
+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.
+     </VarListEntry>
+
+     <VarListEntry><Term>Immediate-Configure</Term>
+     <ListItem><Para>
+Désactive la configuration immédiate&thinsp;; 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.
+Utilisez-la à vos risques et périls.
+     </VarListEntry>
+
+     <VarListEntry><Term>Force-LoopBreak</Term>
+     <ListItem><Para>
+Ne jamais activer cette option à moins que vous ne sachiez -réellement- ce que
+vous faites. Elle autorise APT à supprimer temporairement un paquet
+essentiel pour mettre fin à une boucle Conflicts / Conflicts ou
+Conflicts / Pre-Depends entre deux paquets essentiels. UNE TELLE BOUCLE
+NE DOIT JAMAIS SE PRODUIRE&nbsp;: C'EST UN BOGUE SÉRIEUX. Cette option fonctionne
+si les paquets essentiels ne sont pas tar, gzip, libc, dpkg, bash ou tous
+les paquets dont ces paquets dépendent.
+     </VarListEntry>
+
+     <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.
+     </VarListEntry>
+
+     <VarListEntry><Term>Get</Term>
+     <ListItem><Para>
+La sous-section <literal/Get/ contrôle l'outil &apt-get;, veuillez consulter
+sa documentation pour avoir plus d'informations sur les options en question.
+     </VarListEntry>
+
+     <VarListEntry><Term>Cache</Term>
+     <ListItem><Para>
+La sous-section <literal/Cache/ contrôle l'outil &apt-cache;, veuillez 
+consulter sa documentation pour avoir plus d'informations sur les options en 
+question.
+     </VarListEntry>
+
+     <VarListEntry><Term>CDROM</Term>
+     <ListItem><Para>
+La sous-section <literal/CDROM/ contrôle l'outil &apt-cdrom;, veuillez 
+consulter sa documentation pour avoir plus d'informations sur les options en 
+question.
+     </VarListEntry>
+   </VariableList>
+ </RefSect1>
+
+ <RefSect1><Title>Le groupe Acquire</>
+   <para>   
+Le groupe d'options <literal/Acquire/ contrôle le téléchargement des paquets et
+les gestionnaires d'URI.
+
+   <VariableList>
+     <VarListEntry><Term>Queue-Mode</Term>
+     <ListItem><Para>
+Le mode file d'attente&thinsp;; <literal/Queue-Mode/ peut prendre une valeur parmi
+<literal/host/ ou <literal/access/ et cela détermine comment APT parallélise 
+les connexions sortantes. <literal/host/ signifie qu'une connexion par cible 
+sera initiée, tandis que <literal/access/ signifie qu'une connexion par type 
+d'URI sera initiée.
+     </VarListEntry>
+
+     <VarListEntry><Term>Retries</Term>
+     <ListItem><Para>
+Nombre d'essais à effectuer. Si ce nombre n'est pas nul, APT essaie de
+récupérer, le nombre donné de fois, les fichiers dont le rapatriement a échoué.
+     </VarListEntry>
+
+     <VarListEntry><Term>Source-Symlinks</Term>
+     <ListItem><Para>
+Utilise des liens symboliques pour les archives de sources. Positionnée à 
+«&nbsp;true&nbsp;»,  cette option crée si possible des liens symboliques vers les 
+archives de sources au lieu de les copier. 
+Par défaut à «&nbsp;true&nbsp;».
+     </VarListEntry>
+
+     <VarListEntry><Term>http</Term>
+     <ListItem><Para>
+HTTP URIs; 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]/</>. En utilisant la syntaxe&nbsp;:
+<literal/http::Proxy::&lt;host&gt;/, où le mot-clé spécial <literal/DIRECT/
+indique de n'utiliser aucun mandataire, on peut spécifier un mandataire
+pour chaque machine distante. La variable d'environnement <envar/http_proxy/
+remplace tous ces paramètres.
+     <para>
+Trois options de configuration sont fournies pour le contrôle des caches qui
+sont compatibles avec HTTP/1.1. <literal/No-Cache/ signifie que le mandataire
+ne doit pas du tout utiliser les réponses qu'il a stockées&thinsp;; <literal/Max-Age/
+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
+valeur par défaut est donc de 1 jour. <literal/No-Store/ sert uniquement
+pour les fichiers d'archive&nbsp;: cela 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>
+L'option <literal/timeout/ positionne le compteur de temps mort (timeout)
+utilisé par la méthode&nbsp;: cela vaut pour tout (connexion, données).
+     <para>
+Une option de configuration est fournie pour contrôler la profondeur du tube
+pour le cas où un serveur distant n'est pas conforme à la RFC ou est bogué
+(comme Squid 2.0.2). Acquire::http::Pipeline-Depth a une valeur
+comprise entre 0 et 5&nbsp;: elle indique le nombre de requêtes en attente qui 
+peuvent être émises. Quand la machine distante ne conserve pas correctement
+les connexions TCP, on DOIT donner une valeur égale à 0 -- sinon des
+données seront corrompues. Les machines qui ont besoin de cette option
+ne respectent pas la RFC 2068.
+     </VarListEntry>
+
+     <VarListEntry><Term>ftp</Term>
+     <ListItem><Para>
+FTP URIs&nbsp;; 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]/</>&thinsp;; il est remplacé par la 
+variable d'environnement <envar/ftp_proxy/. Pour utiliser un mandataire ftp,
+vous devez renseigner l'entrée <literal/ftp::ProxyLogin/ 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/$(PROXY_PASS)/, <literal/$(SITE_USER)/,
+<literal/$(SITE_PASS)/, <literal/$(SITE)/, et <literal/$(SITE_PORT)/.
+Chacune correspond à un élément de l'URI.
+     <para>
+L'option <literal/timeout/ positionne le compteur de temps mort (timeout)
+utilisé par la méthode&nbsp;: cela vaut pour tout (connexion, données).
+     <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&thinsp;; 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
+soit utilisé à la place. On peut le faire globalement, pour des
+connexions qui passent par un mandataire ou pour une machine
+spécifique (examinez le modèle de fichier de configuration).
+     <para>
+On peut utiliser un mandataire FTP pour atteindre une cible HTTP en
+positionnant la variable d'environnement <envar/ftp_proxy/ à 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é.
+     <para>
+L'option <literal/ForceExtended/ contrôle l'utilisation des commandes liées 
+à la RFC 2428, <literal/EPSV/ et <literal/EPRT/. Par défaut, elle vaut 
+«&nbsp;false&nbsp;»&thinsp;; 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.
+     </VarListEntry>
+
+     <VarListEntry><Term>cdrom</Term>
+     <ListItem><Para>
+CDROM URIs&thinsp;; la seule option de configuration pour les URIs de CDROM
+est le point de montage&nbsp;: <literal/cdrom::Mount/&thinsp;; il doit représenter le
+point de montage du lecteur de cédérom indiqué dans <filename>/etc/fstab</>. 
+On peut fournir d'autres commandes de montage et de démontage quand le
+point de montage ne peut être listé dans le fichier <filename>/etc/fstab</>
+(par exemple, un montage SMB ou ...). Syntaxiquement, il faut placer
+<literallayout>"/cdrom/"::Mount "foo";</literallayout> dans le bloc cdrom.
+La barre oblique finale est importante. Les commandes de démontage
+peuvent être spécifiées en utilisant <literal/UMount/.
+     </VarListEntry>
+   </VariableList>
+ </RefSect1>
+
+ <RefSect1><Title>Les répertoires</>
+   <para>   
+Les répertoires de la section <literal/Dir::State/ concernent le système
+local. <literal/lists/ est le répertoire où placer les listes de paquets
+téléchargés et  <literal/status/ est le nom du fichier d'état de Dpkg.
+<literal/preferences/ concerne APT&nbsp;: c'est le nom du fichier de préférence.
+<literal/Dir::State/ contient le répertoire par défaut préfixé à tous les
+sous-éléments, quand ceux-ci ne commencent pas par <filename>/</> 
+ou <filename>./</>.
+   <para>
+<literal/Dir::Cache/ contient les emplacements qui renseignent sur le
+cache local&nbsp;: par exemple, les deux caches de paquets <literal/srcpkgcache/ 
+et <literal/pkgcache/ et aussi l'endroit où sont placées les archives
+téléchargées, <literal/Dir::Cache::archives/. 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 cache 
+<literal/pkgcache/ plutôt que celui de <literal/srcpkgcache/. Comme pour
+<literal/Dir::State/, le répertoire par défaut est contenu dans
+<literal/Dir::Cache/.
+   <para>
+<literal/Dir::Etc/ contient l'emplacement des fichiers de configuration,
+<literal/sourcelist/ indique l'emplacement de la liste de sources et 
+<literal/main/ est le fichier de configuration par défaut (le modifier
+n'a aucun effet, à moins qu'on ne le modifie avec le fichier de 
+configuration indiqué par la variable <envar/APT_CONFIG/). 
+   <para>
+<literal/Dir::Parts/ lit, par ordre d'entrée, tous les fragments de 
+configuration dans le répertoire indiqué. Ensuite, le fichier principal
+de configuration est chargé.
+   <para>
+Les programmes binaires sont pointés par <literal/Dir::Bin/.
+L'emplacement des gestionnaires de méthodes est indiqué par
+<literal/methods/&thinsp;; <literal/gzip/, <literal/Dpkg/, <literal/apt-get/,
+<literal/dpkg-source/, <literal/dpkg-buildpackage/ et <literal/apt-cache/
+indiquent l'emplacement des programmes correspondants.
+ </RefSect1>
+ 
+ <RefSect1><Title>APT et DSelect</>
+   <para>   
+Quand APT est utilisé comme une méthode de &dselect;, plusieurs directives 
+contrôlent le comportement par défaut. On les trouve dans la section
+<literal/DSelect/.
+   
+   <VariableList>
+     <VarListEntry><Term>Clean</Term>
+     <ListItem><Para>
+Mode de nettoyage du cache&thinsp;; cette variable peut prendre l'une des valeurs
+suivantes&nbsp;: «&nbsp;always&nbsp;», «&nbsp;prompt&nbsp;», «&nbsp;auto&nbsp;», «&nbsp;pre-auto&nbsp;» et «&nbsp;never&nbsp;». 
+«&nbsp;always&nbsp;» et «&nbsp;prompt&nbsp;» suppriment tous les paquets du cache après la mise à
+niveau&thinsp;; «&nbsp;prompt&nbsp;» (valeur par défaut) les supprime après une demande et 
+«&nbsp;auto&nbsp;» ne supprime que les archives qui ne peuvent plus être téléchargées 
+(remplacées, par exemple, par une nouvelle version). «&nbsp;pre-auto&nbsp;» les
+supprime avant de récupérer de nouveaux paquets.
+     </VarListEntry>
+     
+     <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.
+     </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.
+     </VarListEntry>
+
+     <VarListEntry><Term>PromptAfterUpdate</Term>
+     <ListItem><Para>
+Si cette option est «&nbsp;vraie&nbsp;», l'opération [U]pdate de &dselect; interroge
+toujours l'utilisateur avant de continuer. Par défaut, ce n'est qu'en cas 
+d'erreur que l'on propose à l'utilisateur d'intervenir.
+     </VarListEntry>
+   </VariableList>
+ </RefSect1>
+ 
+ <RefSect1><Title>Comment APT appelle Dpkg</>
+   <para>   
+Plusieurs directives de configuration contrôlent la manière dont APT
+invoque &dpkg;&nbsp;: elles figurent dans la section <literal/DPkg/.
+
+   <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
+passé comme un seul argument à Dpkg.
+     </VarListEntry>
+     
+     <VarListEntry><Term>Pre-Invoke</Term><Term>Post-Invoke</Term>
+     <ListItem><Para>
+Il s'agit d'une liste de commandes shell à exécuter avant ou après l'appel de
+&dpkg;. Tout comme pour <literal/Options/, on doit utiliser la notation de
+liste. Les commandes sont appelées dans l'ordre en utilisant /bin/sh&nbsp;: APT
+s'arrête dès que l'une d'elles échoue.
+     </VarListEntry>
+
+     <VarListEntry><Term>Pre-Install-Pkgs</Term>
+     <ListItem><Para>
+Il s'agit d'une liste de commandes shell à exécuter avant d'appeler Dpkg. 
+Tout comme pour <literal/Options/, on doit utiliser la notation de liste.
+Les commandes sont appelées dans l'ordre en utilisant /bin/sh&nbsp;: APT s'arrête
+dès que l'une d'elles échoue. Sur l'entrée standard, APT transmet aux
+commandes les noms de tous les fichiers .deb qu'il va installer, à raison d'un
+par ligne.
+     <para>
+La deuxième version de ce protocole donne plus de renseignements&nbsp;: on obtient
+la version du protocole, la configuration de APT et les paquets, fichiers
+ou versions qui ont changés. On autorise cette version en positionnant
+<literal/DPkg::Tools::Options::cmd::Version/ à 2. <literal/cmd/ est une 
+commande passée à <literal/Pre-Install-Pkgs/.
+     </VarListEntry>
+
+     <VarListEntry><Term>Run-Directory</Term>
+     <ListItem><Para>
+APT se place dans ce répertoire avant d'appeler Dpkg&thinsp;; par défaut c'est le 
+répertoire <filename>/</>.
+     </VarListEntry>
+
+     <VarListEntry><Term>Build-Options</Term>
+     <ListItem><Para>
+Ces options sont passées à &dpkg-buildpackage; lors de la compilation des
+paquets&thinsp;; par défaut la signature est désactivée et tous les binaires sont
+créés.
+     </VarListEntry>
+   </VariableList>
+ </RefSect1>
+
+ <RefSect1><Title>Les options de débogage</>
+   <para>   
+La plupart des options de la section <literal/debug/ n'ont aucun intérêt
+pour le simple utilisateur&thinsp;; cependant, <literal/Debug::pkgProblemResolver/
+affiche d'intéressantes informations sur les décisions que prend la
+commande dist-upgrade. <literal/Debug::NoLocking/ 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/ affiche la ligne de commande à
+chaque appel de Dpkg. <literal/Debug::IdentCdrom/ désactive l'inclusion de 
+données statfs dans les IDs de CDROM.
+ </RefSect1>
+ 
+ <RefSect1><Title>Exemples</>
+   <para>
+   &configureindex; contient un modèle de fichier montrant les valeurs par
+défaut de toutes les options possibles.
+ </RefSect1>
+ 
+ <RefSect1><Title>Fichiers</>
+   <para>
+   <filename>/etc/apt/apt.conf</>
+ </RefSect1>
+ 
+ <RefSect1><Title>Voir aussi</>
+   <para>
+   &apt-cache;, &apt-config;, &apt-preferences;.
+ </RefSect1>
+
+ &manbugs;
+ &manauthor;
+ &deux-traducteurs;
+
+</refentry>