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, 243 insertions, 0 deletions

diff --git a/doc/fr/apt_preferences.fr.5.sgml b/doc/fr/apt_preferences.fr.5.sgml
new file mode 100644
index 000000000..f910ef4f1
--- /dev/null
+++ b/doc/fr/apt_preferences.fr.5.sgml
@@ -0,0 +1,243 @@
+<!-- -*- mode: sgml; mode: fold -*- -->
+<!-- translation of version 1.3 -->
+<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
+
+<!ENTITY % aptent SYSTEM "apt.ent.fr">
+%aptent;
+
+]>
+
+<refentry lang=fr>
+ &apt-docinfo;
+ 
+ <refmeta>
+   <refentrytitle>apt_preferences</>
+   <manvolnum>5</>
+ </refmeta>
+ 
+ <!-- Man page title -->
+ <refnamediv>
+    <refname>apt_preferences</>
+    <refpurpose>Un fichier de contrôle, utilisé par APT, indiquant des préférences</>
+ </refnamediv>
+ 
+ <RefSect1><Title>Description</>
+   <para>
+Le fichier des préférences contrôle différents aspects du système APT. Il est
+conçu pour être modifiable par l'utilisateur et manipulable de façon 
+logicielle. Il comprend des enregistrements formés sur le modèle du fichier
+<filename/status/ de Dpkg : des sections séparées par des espaces et des lignes
+commençant par une étiquette suivie d'un « : ». Il se trouve dans
+<filename>/etc/apt/preferences</>.
+ </RefSect1>
+
+ <RefSect1><Title>Questions de version</>
+   <para>
+L'un des buts de ce fichier est de permettre à l'utilisateur de choisir 
+quelle version d'un paquet il veut installer. On peut faire ce choix de 
+plusieurs façons mais il est basé sur trois critères&nbsp;: la version, 
+l'édition et l'origine.
+   <para>
+Choisir la version peut se faire avec une recherche de correspondance sur une
+chaîne exacte ou bien sur une chaîne préfixée. Le format est&nbsp;: <literal/2.1.2/
+pour la première et <literal/2.2*/ pour la seconde. L'utilisation d'un préfixe
+permet d'ignorer le <literal/r/ du système d'ordonnancement des éditions 
+(<literal/2.1r*/), ou bien d'ignorer les révisions propres à Debian
+(<literal/1.1-*/). Quand on compare des versions en se servant d'un préfixe,
+la version possédant le numéro le plus élevé est toujours choisie.
+   <para>
+Choisir une édition de la distribution est plus compliqué et possède trois 
+formes. Le but principal du choix d'une édition est d'identifier un ensemble de
+paquets qui corresponde à un vendeur particulier ou à une édition de la 
+distribution (p.ex. Debian 2.1). Les deux premières formes sont des raccourcis 
+pour une utilisation rapide en ligne de commande. Si le premier caractère de
+la chaîne est un chiffre, c'est une recherche fondée sur la version d'une 
+édition&thinsp;; sinon, c'est une recherche sur le nom d'une édition. Quand la 
+chaîne comporte des signes égal, c'est une recherche fondée sur une 
+description complète de l'édition&thinsp;; cette chaîne est une liste de clés 
+(une seule lettre) suivies d'un mot et séparées par une virgule. Exemples&nbsp;:
+<informalexample><programlisting>
+v=2.1*,o=Debian,c=main
+l=Debian
+a=stable
+</programlisting></informalexample>   
+   <para>
+Ces recherches utilisent des données prises dans les fichiers 
+<filename/Release/ récupérés par APT pendant une mise à jour. Voici les
+clés disponibles&nbsp;:
+   <VariableList>
+     <VarListEntry><term>a= Archive</term>
+     <ListItem><Para>
+C'est le nom habituel donné à nos archives, comme <literal/stable/ ou
+<literal/unstable/. Le nom spécial <literal/now/ désigne l'ensemble des
+paquets installés.
+     </VarListEntry>
+     
+     <VarListEntry><term>c= Composant</term>
+     <ListItem><Para>
+Indique un sous-composant de l'archive, tel que <literal/main/, 
+<literal/contrib/, etc. Quand il n'y a pas de composant dans telle archive,
+on peut l'omettre.
+     </VarListEntry>
+     
+     <VarListEntry><term>v= Version</term>
+     <ListItem><Para>
+C'est la chaîne représentant la version&thinsp;; elle possède les mêmes 
+caractéristiques que celle du fichier <filename/Packages/. C'est le niveau
+édition de l'archive. Les numéros d'une édition classique de la distribution 
+Debian ressemblent à <literal/2.1r2/ où le r désigne une édition (release) de
+la distribution 2.1. Les nouvelles éditions sont limitées à des mises à
+jour concernant la sécurité.
+     </VarListEntry>
+
+     <VarListEntry><term>o= Origine</term>
+     <ListItem><Para>
+Ce terme indique qui a fourni l'archive. Pour Debian, c'est <literal/Debian/.
+Les autres fournisseurs peuvent utiliser leur propre nom.
+     </VarListEntry>
+
+     <VarListEntry><term><term>l= Label</term>
+     <ListItem><Para>
+Cela donne le nom général de la distribution. Pour Debian, c'est 
+<literal/Debian/. Pour des distributions dérivées, ce terme doit être leur
+propre nom.
+     </VarListEntry>
+   </VariableList>   
+   <para>
+La dernière méthode est le choix de l'origine. C'est simplement le nom du site
+d'où proviennent les paquets. Une chaîne vide indique un URI de fichier.
+   <para>
+Le choix d'une version, et en particulier les deux dernières méthodes, 
+concerne plusieurs parties d'APT, pas seulement le fichier préférences.
+ </RefSect1>
+ 
+<RefSect1><Title>Règles pour le choix d'une version</>
+   <para>
+APT conserve une liste de toutes les versions disponibles de tous les
+paquets. Quand on indique plusieurs éditions ou vendeurs dans le fichier
+&sources-list;, tous ces éléments sont disponibles. APT choisit par défaut
+la version la plus récente parmi toutes ces sources automatiques. Quelques
+sources sont étiquetées Non Automatique, p.ex. 
+<filename>project/experimental</> -- elles sont mises en bas de la pile de 
+sélection.
+   <para>
+Pour décider quelle version utiliser, APT affecte une priorité à toutes les
+versions disponibles d'un paquet. Puis il fait deux choses. Premièrement&nbsp;:
+il choisit, parmi les versions plus récentes que la version installée, la 
+version qui possède la plus haute priorité&thinsp;; ensuite il choisit, parmi 
+les versions plus anciennes que la version installée, celle qui possède la 
+plus haute priorité. Deuxièmement&nbsp;: si les versions plus anciennes ont 
+une priorité supérieure à 1000, il les compare avec la priorité que possède 
+l'ensemble de mise à niveau&nbsp;: la plus grande est choisie. Autrement, les 
+versions provoquant une régression sont ignorées et il choisit la plus grande 
+priorité de l'ensemble de mise à niveau.
+   <para>
+On peut penser le système de priorité en termes de strates&nbsp;:
+   <VariableList>
+     <VarListEntry><term>1000 et au-dessus</term>
+     <ListItem><Para>
+Priorités permettant la régression
+     </VarListEntry>
+     
+     <VarListEntry><term>1000</term>
+     <ListItem><Para>
+La barrière pour empêcher la régression.
+     </VarListEntry>
+     
+     <VarListEntry><term>de 100 à 1000</term>
+     <ListItem><Para>
+Priorités standards. 990 est la priorité définie par l'option 
+<option/--target-release / du programme &apt-get;. 989 est le début des
+priorités automatiques et 500 la priorité par défaut des fichiers d'un paquet.
+     </VarListEntry>
+     
+     <VarListEntry><term>100</term>
+     <ListItem><Para>
+Priorité de la version actuellement installée.
+     </VarListEntry>
+
+     <VarListEntry><term>de 0 à 100</term>
+     <ListItem><Para>
+Priorités non automatiques. On s'en sert uniquement si le paquet n'est pas
+installé et s'il n'y a pas d'autre version disponible.
+     </VarListEntry>
+
+     <VarListEntry><term>inférieur à 0</term>
+     <ListItem><Para>
+Priorité pour une version qui ne sera jamais sélectionnée.
+     </VarListEntry>
+   </VariableList>   
+   <para>
+Une priorité supérieure à 1000 donnée à une étiquette (pin) autorise une 
+régression vers cette version.
+   <para>
+On peut accrocher une étiquette à chaque paquet et chaque fichier
+<filename/Packages/ possède une priorité pour tous les paquets. La plus
+haute priorité affectée à un paquet est celle qui est utilisée.
+   <para>
+Une étiquette de paquet est de cette forme&nbsp;:
+<informalexample><programlisting>
+Package: apt
+Pin: version 0.4.0
+Pin-Priority: 1001
+</programlisting></informalexample>   
+La première ligne indique le paquet, la seconde donne le nom de l'étiquette 
+et la dernière la priorité pour cette étiquette. Le premier mot du nom de 
+l'étiquette peut être&nbsp;: version, release ou origin&thinsp;; le reste du 
+champ est décrit plus haut dans la section «&nbsp;Règles pour le choix d'une 
+version&nbsp;».
+   <para>
+Une étiquette par défaut représente comment sont définies les priorités des
+fichiers d'un paquet. On peut spécifier autant d'étiquette par défaut qu'on
+veut&thinsp;; la première correspondant au défaut sélectionne la priorité pour 
+les fichiers d'un paquet. Seuls «&nbsp;release&nbsp;» et «&nbsp;origin&nbsp;» 
+peuvent être utilisés dans le nom de l'étiquette puisqu'ils correspondent aux 
+fichiers <filename/Packages/.
+<informalexample><programlisting>
+Package: *
+Pin: release v=2.1*
+Pin-Priority: 998
+</programlisting></informalexample>
+   <para>
+Quand le champ Pin-Priority manque, la priorité est par défaut de 989
+dans les deux cas.
+   
+   <RefSect2><title>Effets notables</>
+   <para>
+À cause de la barrière empêchant les régressions (priorité 1000), il est
+possible qu'une version possédant une priorité inférieure soit choisie si
+une version possédant une priorité supérieure provoque une régression. Par
+exemple, le paquet foo possède les versions <literal/1.2/, <literal/1.1/
+et <literal/1.0/&thinsp;; <literal/1.1/ est la version installée&thinsp;; les 
+priorités de chaque version sont&nbsp;: 900, 100 et 950 respectivement&nbsp;: 
+la version <literal/1.2/ sera installée.
+   <para>
+Dans la pratique, c'est ce qu'on veut&thinsp;! Un utilisateur utilisera une
+étiquette par défaut pour rendre la distribution «&nbsp;stable&nbsp;» la 
+distribution par défaut&thinsp;; il utilisera ensuite l'option 
+<option/--target-dist/ avec &apt-get; pour choisir de nouvelles versions dans 
+«&nbsp;unstable&nbsp;». Les paquets mis à niveau avec «&nbsp;unstable&nbsp;» 
+suivront les versions disponibles dans «&nbsp;unstable&nbsp;» puisque les 
+versions de «&nbsp;stable&nbsp;» sont maintenant passées
+sous la barrière empêchant la régression.
+   <para>
+Si on ne le veut pas, on doit utiliser une étiquette par défaut qui donne
+à «&nbsp;unstable&nbsp;» une priorité inférieure à 100.
+   <para>
+Ceux qui utilisent des suppléments venant de tiers comme Helix GNOME peuvent 
+se servir de ce procédé pour obtenir des paquets Helix&thinsp;; ils peuvent 
+forcer l'utilisation des paquets Debian en définissant la priorité de cette 
+source suffisamment haut. On peut même réaliser une régression massive d'un 
+ensemble de paquets à un autre en utilisant une priorité supérieure à 1000.
+   </RefSect2>
+ </RefSect1>
+  
+ <RefSect1><Title>Voir aussi</>
+   <para>
+   &apt-cache; &apt-conf;
+ </RefSect1>
+
+ &manbugs;
+ &manauthor;
+&traducteur; 
+</refentry>