From 602daf93c858dcd3a01cce78323d07d2b379a03c Mon Sep 17 00:00:00 2001 From: Arch Librarian Date: Mon, 20 Sep 2004 17:02:16 +0000 Subject: * Updated French man pages from Philippe Batailler Author: mdz Date: 2003-07-25 17:03:35 GMT * Updated French man pages from Philippe Batailler (Closes: #182194) --- debian/changelog | 2 + doc/fr/apt-cache.fr.8.sgml | 120 +++--- doc/fr/apt-cdrom.fr.8.sgml | 16 +- doc/fr/apt-config.fr.8.sgml | 6 +- doc/fr/apt-extracttemplates.fr.1.sgml | 6 +- doc/fr/apt-ftparchive.fr.1.sgml | 149 ++++--- doc/fr/apt-get.fr.8.sgml | 492 ++++++++++++++++++++++ doc/fr/apt-sortpkgs.fr.1.sgml | 6 +- doc/fr/apt.conf.fr.5.sgml | 176 ++++---- doc/fr/apt.ent.fr | 22 +- doc/fr/apt_preferences.fr.5.sgml | 744 ++++++++++++++++++++++++---------- doc/fr/makefile | 8 +- doc/fr/sources.list.fr.5.sgml | 34 +- doc/fr/vendors.list.fr.5.sgml | 104 +++++ 14 files changed, 1433 insertions(+), 452 deletions(-) create mode 100644 doc/fr/apt-get.fr.8.sgml create mode 100644 doc/fr/vendors.list.fr.5.sgml diff --git a/debian/changelog b/debian/changelog index 67e93597d..becccbfff 100644 --- a/debian/changelog +++ b/debian/changelog @@ -1,6 +1,8 @@ apt (0.5.8) unstable; urgency=low * Clarify the meaning of the only-source option in apt-get(8) (Closes: #177258) + * Updated French man pages from Philippe Batailler + (Closes: #182194) -- diff --git a/doc/fr/apt-cache.fr.8.sgml b/doc/fr/apt-cache.fr.8.sgml index 6670127bb..fb5b8a095 100644 --- a/doc/fr/apt-cache.fr.8.sgml +++ b/doc/fr/apt-cache.fr.8.sgml @@ -1,5 +1,5 @@ - + @@ -31,17 +31,19 @@ add fichier gencaches - showpkg pkg + showpkg paquet + showsrc paquet stats dump dumpavail unmet search regex - show pkg - showpkg pkg - depends pkg + show paquet + showpkg paquet + depends paquet pkgnames prefix - dotty pkg + dotty paquet + policy paquets @@ -60,15 +62,15 @@ des commandes suivantes doit add -La commande gencaches La commande /var/lib/dpkg/status. @@ -77,8 +79,9 @@ partir des sources r La commande On peut voir que libreadline2, version 2.1-8, dépend de libc5, ncurses3.0, et -ldso ; ces paquets doivent être installés au préalable pour que libreadline2 -fonctionne. À leur tour, libreadlineg2 et libreadline2-altdev dépendent de -libreadline2. Si libreadline2 est installé, libc5, ncurses3.0 et ldso doivent -être installés ; libreadlineg2 et libreadline2-altdev n'ont pas à l'être. Pour connaître le sens de la fin de chaîne, il est préférable de consulter le code -source d'APT. +ldso ; ces paquets doivent être installés au préalable pour que +libreadline2 fonctionne. À leur tour, libreadlineg2 et libreadline2-altdev +dépendent de libreadline2. Si libreadline2 est installé, libc5, ncurses3.0 et +ldso doivent être installés ; libreadlineg2 et libreadline2-altdev +n'ont pas à l'être. Pour connaître le sens de la fin de chaîne, il est +préférable de consulter le code source d'APT. stats @@ -116,33 +120,34 @@ autre argument n'est attendu. Voici les informations rapport - @@ -150,16 +155,16 @@ un paquet r @@ -168,6 +173,14 @@ d + + showsrc + + + dump @@ -190,7 +203,7 @@ d show -La commande @@ -201,7 +214,7 @@ argument sur tous les paquets disponibles. Elle cherche une occurrence de la chaîne dans les noms de paquets et dans les descriptions puis elle affiche le nom du paquet et sa description courte. Quand on donne l'option - + + policy + + + + Options</> @@ -264,26 +286,26 @@ le cache primaire utilis <VarListEntry><term><option/-s/</><term><option/--src-cache/</> <ListItem><Para> Indique le fichier servant de cache des sources. Ce cache n'est utilisé que -par <literal/gencaches/ ; une version des informations sur les paquets, +par <literal/gencaches/ ; une version des informations sur les paquets, faite à partir d'une analyse de sources distantes, est conservée. Quand le -cache des paquets est crée, le cache de sources est utilisé afin d'éviter +cache des paquets est créé, le cache des sources est utilisé afin d'éviter d'analyser à nouveau tous les paquets. Élément de configuration : <literal/Dir::Cache::srcpkgcache/. </VarListEntry> <VarListEntry><term><option/-q/</><term><option/--quiet/</> <ListItem><Para> -Mode silencieux ; produit une sortie pertinente pour l'enregistrement dans un -fichier journal, sans afficher d'indicateur de progression. Un plus grand -nombre de q produira un plus grand silence, avec un maximum de 2. Vous pouvez -aussi utiliser <option/-q=#/ pour positionner le niveau de silence, annulant -le fichier de configuration. +Mode silencieux ; produit une sortie pertinente pour l'enregistrement +dans un fichier-journal, sans afficher d'indicateur de progression. Un plus +grand nombre de q produira un plus grand silence, avec un maximum de 2. Vous +pouvez aussi utiliser <option/-q=#/ pour positionner le niveau de silence, +annulant le fichier de configuration. Élément de configuration : <literal/quiet/. </VarListEntry> <VarListEntry><term><option/-i/</><term><option/--important/</> <ListItem><Para> -N'affiche que les dépendances importantes ; à utiliser avec la commande +N'affiche que les dépendances importantes ; à utiliser avec la commande unmet pour n'afficher que les relations Depends et Pre-Depends. Élément de configuration : <literal/APT::Cache::Important/. </VarListEntry> @@ -374,4 +396,4 @@ d &manbugs; &manauthor; &deux-traducteurs; -</refentry> \ No newline at end of file +</refentry> diff --git a/doc/fr/apt-cdrom.fr.8.sgml b/doc/fr/apt-cdrom.fr.8.sgml index 11ba0ec63..eafed052e 100644 --- a/doc/fr/apt-cdrom.fr.8.sgml +++ b/doc/fr/apt-cdrom.fr.8.sgml @@ -7,7 +7,7 @@ ]> -<refentry lang=fr> +<refentry> &apt-docinfo; <refmeta> @@ -16,7 +16,7 @@ </refmeta> <!-- Man page title --> - <refnamediv> + <refnamediv lang=fr> <refname>apt-cdrom</> <refpurpose>Gestion des cédéroms par APT</> </refnamediv> @@ -80,7 +80,7 @@ que le nom du fichier stock <VariableList> <VarListEntry><term><option/-d/</><term><option/--cdrom/</> <ListItem><Para> -Point de montage ; spécifie l'emplacement de montage du cédérom. Ce +Point de montage ; spécifie l'emplacement de montage du cédérom. Ce point de montage doit être spécifié dans <filename>/etc/fstab</> et correctement configuré. Élément de configuration : <literal/Acquire::cdrom::mount/. @@ -88,7 +88,7 @@ correctement configur <VarListEntry><term><option/-r/</><term><option/--rename/</> <ListItem><Para> -Change le nom d'un disque ; change le nom d'un disque ou annule le nom +Change le nom d'un disque ; change le nom d'un disque ou annule le nom donné aux disques. Cette option oblige <command/apt-cdrom/ à demander un nouveau nom à l'utilisateur. Élément de configuration : <literal/APT::CDROM::Rename/. @@ -96,13 +96,13 @@ nouveau nom <VarListEntry><term><option/-m/</><term><option/--no-mount/</> <ListItem><Para> -Pas de montage ; empêche <command/apt-cdrom/ de monter ou démonter le +Pas de montage ; empêche <command/apt-cdrom/ de monter ou démonter le point de montage. Élément de configuration : <literal/APT::CDROM::NoMount/. </VarListEntry> <VarListEntry><term><option/-f/</><term><option/--fast/</> <ListItem><Para> -Copie rapide ; suppose que les paquets sont valides et ne vérifie pas +Copie rapide ; suppose que les paquets sont valides et ne vérifie pas chaque paquet. Cette option ne devrait être utilisée que si <command/apt-cdrom/ a préalablement utilisé ce disque et n'a trouvé aucune erreur. Élément de configuration : <literal/APT::CDROM::Fast/. @@ -110,7 +110,7 @@ a pr <VarListEntry><term><option/-a/</><term><option/--thorough/</> <ListItem><Para> -Parcours minutieux des paquets ; cette option peut être nécessaire avec +Parcours minutieux des paquets ; cette option peut être nécessaire avec de vieux cédéroms de systèmes Debian 1.1 ou 1.2 dont les fichiers Packages sont situés dans des endroits étranges. Il faudra plus de temps pour parcourir le CD mais tous les paquets seront repérés. @@ -121,7 +121,7 @@ parcourir le CD mais tous les paquets seront rep <term><option/--recon/</> <term><option/--no-act/</> <ListItem><Para> -Aucune modification ; ne pas modifier le fichier &sources-list; ni les +Aucune modification ; ne pas modifier le fichier &sources-list; ni les fichiers d'index. Cependant, tout est vérifié. Élément de configuration : <literal/APT::CDROM::NoAct/. </VarListEntry> diff --git a/doc/fr/apt-config.fr.8.sgml b/doc/fr/apt-config.fr.8.sgml index 788bed89f..8f2ae4511 100644 --- a/doc/fr/apt-config.fr.8.sgml +++ b/doc/fr/apt-config.fr.8.sgml @@ -1,5 +1,5 @@ <!-- -*- mode: sgml; mode: fold -*- --> -<!-- translation of version 1.3 --> +<!-- translation of version 1.4 --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> @@ -39,7 +39,7 @@ <para> <command/apt-config/ est un programme interne utilisé par différentes composantes d'APT ; il offre la possibilité d'une configuration -cohérente et permet aux applications conçues sous forme de scripts une +cohérente et permet aux applications conçues sous forme de script une utilisation simple du fichier de configuration principal <filename>/etc/apt/apt.conf</>. <para> @@ -56,7 +56,7 @@ premier est une variable de shell et le second une valeur de configuration demander. La sortie standard consiste en une liste de commandes d'assignation de shell pour chaque valeur présente. Dans un script shell, cette commande devrait -être utilisée comme suit : +être utilisée comme suit : </para> diff --git a/doc/fr/apt-extracttemplates.fr.1.sgml b/doc/fr/apt-extracttemplates.fr.1.sgml index 25f375106..a3da8c3fa 100644 --- a/doc/fr/apt-extracttemplates.fr.1.sgml +++ b/doc/fr/apt-extracttemplates.fr.1.sgml @@ -7,7 +7,7 @@ ]> -<refentry lang=fr> +<refentry> &apt-docinfo; <refmeta> @@ -16,7 +16,7 @@ </refmeta> <!-- Man page title --> - <refnamediv> + <refnamediv lang=fr> <refname>apt-extracttemplates</> <refpurpose>Un outil pour extraire d'un paquet Debian les textes de configuration pour DebConf. </refnamediv> @@ -43,7 +43,7 @@ suivant : <para> Les scripts et guides de configuration sont écrits dans le répertoire temporaire indiqué par l'option <option>-t</option> ou -<option>--tempdir</option> (<literal/APT::ExtractTemplates::TempDir/>) ; les noms de fichier sont de la +<option>--tempdir</option> (<literal/APT::ExtractTemplates::TempDir/>) ; les noms de fichier sont de la forme <filename>template.XXXX</> ou <filename>config.XXXX</>. </RefSect1> diff --git a/doc/fr/apt-ftparchive.fr.1.sgml b/doc/fr/apt-ftparchive.fr.1.sgml index 98fc5ac83..53f6a0adc 100644 --- a/doc/fr/apt-ftparchive.fr.1.sgml +++ b/doc/fr/apt-ftparchive.fr.1.sgml @@ -1,5 +1,5 @@ <!-- -*- mode: sgml; mode: fold -*- --> -<!-- translation of version 1.4 --> +<!-- translation of version 1.5 --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> @@ -51,15 +51,17 @@ dont APT se sert pour acc <para> <command/apt-ftparchive/ est un ensemble comprenant le programme &dpkg-scanpackages; et toutes ses fonctionnalités via la commande -<literal/directory/ ; il comprend aussi un générateur de fichier « Contents », -la commande <literal/contents/, et une technique élaborée pour « scripter » -le processus de création d'une archive complète. +<literal/directory/ ; il comprend aussi un générateur de fichier +« Contents », la commande <literal/contents/, et une technique +élaborée pour « scripter » le processus de création d'une archive +complète. <para> <command/apt-ftparchive/ peut utiliser lui-même des bases de données binaires -pour « cacher » le contenu d'un fichier .deb ; il n'a pas besoin de programmes -extérieurs, sauf &gzip;. Lors d'une exécution, il vérifie les changements dans -les fichiers et crée les fichiers compressés voulus. +pour « cacher » le contenu d'un fichier .deb ; il n'a pas +besoin de programmes extérieurs, sauf &gzip;. Lors d'une exécution, il +vérifie les changements dans les fichiers et crée les fichiers compressés +voulus. <para> À moins que l'option <option/-h/ ou <option/--help/ ne soit donnée, l'une des @@ -70,8 +72,8 @@ commandes suivantes doit <ListItem><Para> La commande <literal/packages/ crée un fichier « Packages » à partir d'une arborescence. Elle recherche récursivement à travers le répertoire donné -les fichiers .deb et, pour chaque fichier trouvé, envoie l'enregistrement -du paquet sur la sortie standard. Cette commande est approximativement +les fichiers .deb et, pour chaque fichier trouvé, envoie une entrée pour ce +paquet sur la sortie standard. Cette commande est approximativement équivalente à &dpkg-scanpackages;. <para> On peut se servir de l'option <option/--db/ pour demander un cache binaire. @@ -81,12 +83,12 @@ On peut se servir de l'option <option/--db/ pour demander un cache binaire. <ListItem><Para> La commande <literal/sources/ crée un index des sources à partir d'une arborescence. Elle recherche récursivement à travers le répertoire donné -les fichiers .dsc et, pour chaque fichier trouvé, envoie l'enregistrement -du paquet sur la sortie standard. Cette commande est approximativement +les fichiers .dsc et, pour chaque fichier trouvé, envoie une entrée pour ce +paquet sur la sortie standard. Cette commande est approximativement équivalente à &dpkg-scansources;. <para> -Quand on précise un fichier « override », c'est un fichier source avec une -extension .src qui est recherché. On peut se servir de l'option +Quand on précise un fichier « override », c'est un fichier source +avec une extension .src qui est recherché. On peut se servir de l'option <option/--source-override/ pour changer de fichier source d'« override ». </VarListEntry> @@ -142,7 +144,8 @@ pr <VariableList> <VarListEntry><term>ArchiveDir</term> <ListItem><Para> -Indique la racine de l'archive FTP ; Pour une configuration Debian classique, +Indique la racine de l'archive FTP ; Pour une configuration Debian +classique, c'est le répertoire qui contient le fichier <filename/ls-LR/, et les noeuds des distributions. </VarListEntry> @@ -174,15 +177,16 @@ d'autres sections (param <VarListEntry><term>Packages::Compress</term> <ListItem><Para> Indique comment sont compressés les fichiers d'index. C'est une chaîne qui -contient des valeurs séparées par des espaces ; elle contient au moins l'une -des valeurs suivantes : « . » (pas de compression), « gzip », « bzip2 ». +contient des valeurs séparées par des espaces ; elle contient au moins +l'une des valeurs suivantes : « . » (pas de compression), +« gzip », « bzip2 ». Par défaut, c'est la chaîne « . gzip ». </VarListEntry> <VarListEntry><term>Packages::Extensions</term> <ListItem><Para> Indique la liste par défaut des extensions de fichier qui constituent des -fichiers-paquets. Par défaut, c'est « .deb ». +paquets. Par défaut, c'est « .deb ». </VarListEntry> <VarListEntry><term>Sources::Compress</term> @@ -221,27 +225,29 @@ utilisateur (umasq) est ignor <refsect2><title>La section TreeDefault</> <para> -On indique les valeurs par défaut particulières à la section « Tree ». Toutes -ces variables sont des variables de substitution ; les chaînes $(DIST), +On indique les valeurs par défaut particulières à la section +« Tree ». Toutes ces variables sont des variables de +substitution ; les chaînes $(DIST), $(SECTION) et $(ARCH) sont remplacées par leur valeur respective. <VariableList> <VarListEntry><term>MaxContentsChange</term> <ListItem><Para> Indique le nombre de kilooctets de fichiers « Contents » qui sont -crées chaque jour. Les fichiers « Contents » sont tirés au sort +créés chaque jour. Les fichiers « Contents » sont tirés au sort selon le système <emphasis>round-robin</emphasis> de manière que, sur plusieurs jours, tous soient reconstruits. </VarListEntry> <VarListEntry><term>ContentsAge</term> <ListItem><Para> -Contrôle le nombre de jours pendant lequel un fichier « Contents » peut être -utilisé sans actualisation. Quand cette limite est franchie, le « mtime » -du fichier « Contents » est mis à jour. Cela peut arriver quand un fichier -est modifié sans que cela modifie le fichier « Contents » (modification -par « override » par exemple). Un délai est permis dans l'espoir que de -nouveaux « .deb » seront installés, exigeant un nouveau « Contents ». Par +Contrôle le nombre de jours pendant lequel un fichier « Contents » +peut être utilisé sans actualisation. Quand cette limite est franchie, +le « mtime » du fichier « Contents » est mis à jour. Cela +peut arriver quand un fichier est modifié sans que cela modifie le fichier +« Contents » (modification par « override » par exemple). +Un délai est permis dans l'espoir que de nouveaux « .deb » seront +installés, exigeant un nouveau « Contents ». Par défaut ce nombre vaut 10, l'unité étant le jour. </VarListEntry> @@ -253,7 +259,7 @@ Indique la racine de l'arborescence des <VarListEntry><term>Packages</term> <ListItem><Para> -Indique le fichier « Packages » crée. Par défaut, c'est +Indique le fichier « Packages » créé. Par défaut, c'est <filename>$(DIST)/$(SECTION)/binary-$(ARCH)/Packages</>. </VarListEntry> @@ -265,27 +271,27 @@ Indique le fichier <VarListEntry><term>InternalPrefix</term> <ListItem><Para> -Indique un préfixe de chemin ; ce préfixe fait qu'un lien symbolique sera +Indique un préfixe de chemin ; ce préfixe fait qu'un lien symbolique sera considéré comme un lien interne plutôt que comme un lien externe. Par défaut, c'est <filename>$(DIST)/$(SECTION)/</>. </VarListEntry> <VarListEntry><term>Contents</term> <ListItem><Para> -Indique le fichier « Contents » crée. Par défaut, c'est +Indique le fichier « Contents » créé. Par défaut, c'est <filename>$(DIST)/Contents-$(ARCH)</>. Quand le paramètrage fait que -différents fichiers « Packages » se réfèrent à un seul fichier « Contents », -<command/apt-ftparchive/ les intègre automatiquement. +différents fichiers « Packages » se réfèrent à un seul fichier +« Contents », <command/apt-ftparchive/ les intègre automatiquement. </VarListEntry> <VarListEntry><term>Contents::Header</term> <ListItem><Para> -Indique l'en-tête à préfixer au fichier « Contents » crée. +Indique l'en-tête à préfixer au fichier « Contents » créé. </VarListEntry> <VarListEntry><term>BinCacheDB</term> <ListItem><Para> -Indique la base de donnée binaire servant de cache pour cette section. +Indique la base de données binaire servant de cache pour cette section. Différentes sections peuvent partager cette base de données. </VarListEntry> @@ -300,7 +306,7 @@ sont pr <ListItem><Para> Indique qu'au lieu de lire l'arborescence, <command/apt-ftparchive/ doit lire la liste de fichiers dans le fichier donné en argument. Les noms relatifs -sont préfixés par le répertoire de l'archive. On s'en sert pour créer des +sont préfixés par le répertoire de l'archive. On s'en sert pour traiter les index de sources. </VarListEntry> </VariableList> @@ -340,8 +346,8 @@ distribution ; classiquement, on trouve <literal/main contrib non-free/. <VarListEntry><term>Architectures</term> <ListItem><Para> C'est une liste de toutes les architectures qui appartiennent à chaque -section. L'architecture spéciale « source » indique que l'arborescence -est une arborescence de sources. +section. L'architecture spéciale « source » indique que +l'arborescence est une arborescence de sources. </VarListEntry> <VarListEntry><term>BinOverride</term> @@ -352,9 +358,20 @@ des informations sur la section, la priorit <VarListEntry><term>SrcOverride</term> <ListItem><Para> -Indique le fichier source d'« override ». Le fichier d'« override » contient -des informations sur la section. +Indique le fichier source d'« override ». Le fichier +d'« override » contient des informations sur la section. + </VarListEntry> + + <VarListEntry><term>ExtraOverride</term> + <ListItem><Para> +Indique le fichier supplémentaire d'« override » pour les binaires. </VarListEntry> + + <VarListEntry><term>SrcExtraOverride</term> + <ListItem><Para> + Indique le fichier supplémentaire d'« override » pour les sources. + </VarListEntry> + </VariableList> </refsect2> @@ -368,28 +385,37 @@ section <literal/Tree/ sans substitution de variables ou au param <VariableList> <VarListEntry><term>Packages</term> <ListItem><Para> -Indique le fichier « Packages » crée. +Indique le fichier « Packages » créé. </VarListEntry> <VarListEntry><term>SrcPackages</term> <ListItem><Para> -Indique le fichier « Sources » crée. L'un des deux fichiers, +Indique le fichier « Sources » créé. L'un des deux fichiers, <literal/Packages/ ou <literal/SrcPackages/ est nécessaire. </VarListEntry> <VarListEntry><term>Contents</term> <ListItem><Para> -Indique le fichier « Contents » crée. +Indique le fichier « Contents » créé. </VarListEntry> <VarListEntry><term>Binoverride</term> <ListItem><Para> -Indique le fichier binaire d'« override ». +Indique le fichier d'« override » pour les binaires. </VarListEntry> <VarListEntry><term>SrcOverride</term> <ListItem><Para> -Indique le fichier source d'« override ». +Indique le fichier d'« override » pour les sources. + </VarListEntry> + <VarListEntry><term>ExtraOverride</term> + <ListItem><Para> +Indique le fichier supplémentaire d'« override » pour les binaires. + </VarListEntry> + + <VarListEntry><term>SrcExtraOverride</term> + <ListItem><Para> +Indique le fichier supplémentaire d'« override » pour les sources. </VarListEntry> <VarListEntry><term>BinCacheDB</term> @@ -410,13 +436,13 @@ Indique le fichier contenant la liste des fichiers. </refsect2> </RefSect1> - <RefSect1><Title>Le fichier binaire « Override »</> + <RefSect1><Title>Le fichier d'« Override » pour les binaires.</> <para> -Le fichier binaire « Override » est pleinement compatible avec +Le fichier d'« Override » est pleinement compatible avec &dpkg-scanpackages;. Il contient quatre champs séparés par des espaces. Le -premier est le nom du paquet ; le deuxième est la priorité à donner à ce -paquet ; le troisième est sa section et le dernier champ est un champ pour -une permutation du responsable du paquet. +premier est le nom du paquet ; le deuxième est la priorité à donner à ce +paquet ; le troisième est sa section et le dernier champ est un champ +pour changer le nom du responsable de paquet. <para> Le champ du responsable est de cette forme : <literallayout>old [// oldn]* => new</literallayout> @@ -428,13 +454,21 @@ rencontr remplace inconditionnellement le champ. </RefSect1> - <RefSect1><title>Le fichier Source « Override »</> + <RefSect1><title>Le fichier d'« Override » pour les sources</> <para> -Le fichier Source « Override » est pleinement compatible avec +Le fichier d'« Override » est pleinement compatible avec &dpkg-scansources;. Il contient deux champs. Le premier est le nom du paquet -source; le second, sa section. +source ; le second, sa section. </RefSect1> + <RefSect1><title>Le fichier supplémentaire d'« Override »</> + <para> +Le fichier supplémentaire d'« Override » permet d'ajouter ou de +remplacer des étiquettes sur la sortie. Il possède trois colonnes : +la première représente le paquet, la seconde est une étiquette et la +troisième en fin de ligne est la nouvelle valeur. + </RefSect1> + <RefSect1><Title>Les options</> &apt-cmdblurb; @@ -456,9 +490,10 @@ commande generate. <VarListEntry><term><option/-q/</><term><option/--quiet/</> <ListItem><Para> -Mode silencieux ; cette commande produit une sortie destinée à l'enregistrement -dans un fichier journal en omettant les indicateurs de progression. -Un plus grand nombre de « q » (2 au plus) produit un plus grand silence. +Mode silencieux ; cette commande produit une sortie destinée à +l'enregistrement dans un fichier-journal en omettant les indicateurs de +progression. Un plus grand nombre de « q » (2 au plus) produit un +plus grand silence. On peut aussi utiliser <option/-q=#/ pour positionner le niveau de silence, et annuler le fichier de configuration. Élément de configuration : <literal/quiet/. @@ -474,8 +509,8 @@ elle peut <VarListEntry><term><option/--contents/</> <ListItem><Para> -Permettre la création d'un fichier « Contents ». Quand cette option est -activée et que les index sont créés sous forme de base de données binaire, +Permettre la création d'un fichier « Contents ». Quand cette option +est activée et que les index sont créés sous forme de base de données binaire, la liste des fichiers est aussi extraite et conservée dans la base de données pour un usage futur. Avec la commande generate, cette option permet la création de fichiers « Contents ». Par défaut, elle est activée. @@ -484,7 +519,7 @@ cr <VarListEntry><term><option/-s/</><term><option/--source-override/</> <ListItem><Para> -Indique le fichier source d'« override » à utiliser avec la commande +Indique le fichier d'« override » à utiliser avec la commande <literal/sources/. Élément de configuration : <literal/APT::FTPArchive::SourceOverride/. </VarListEntry> diff --git a/doc/fr/apt-get.fr.8.sgml b/doc/fr/apt-get.fr.8.sgml new file mode 100644 index 000000000..e2f9fb5b4 --- /dev/null +++ b/doc/fr/apt-get.fr.8.sgml @@ -0,0 +1,492 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.12 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>apt-get</> + <manvolnum>8</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>apt-get</> + <refpurpose>Utilitaire d'APT pour la manipulation de paquets -- interface en ligne de commande.</> + </refnamediv> + + <!-- Arguments --> + <refsynopsisdiv> + <cmdsynopsis> + <command>apt-get</> + <arg><option>-hvs</></arg> + <arg><option>-o=<replaceable/option de configuration/</></arg> + <arg><option>-c=<replaceable/fichier/</></arg> + <group choice=req> + <arg>update</> + <arg>upgrade</> + <arg>dselect-upgrade</> + <arg>install <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> + <arg>remove <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> + <arg>source <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> + <arg>build-dep <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> + <arg>check</> + <arg>clean</> + <arg>autoclean</> + </group> + </cmdsynopsis> + </refsynopsisdiv> + + <RefSect1><Title>Description</> + <para> + <command/apt-get/ est l'outil en ligne de commande pour manipuler les +paquets. Il peut être considéré par l'utilisateur comme un générateur de +sortie pour les autres outils de la bibliothèque APT. + <para> +À moins que l'option <option/-h/, ou <option/--help/ ne soit donnée, l'une des +commandes suivantes doit être présente. + + <VariableList> + <VarListEntry><Term>update</Term> + <ListItem><Para> +La commande <literal/update/ permet de resynchroniser un fichier répertoriant +les paquets disponibles et sa source. Ces fichiers sont récupérés aux +endroits spécifiés dans <filename>/etc/apt/sources.list</>. Ainsi, lorsqu'on +utilise une archive Debian, cette commande récupère les fichiers +<filename>Packages.gz</> et les analyse de manière à rendre disponibles +les informations concernant les nouveaux paquets et les paquets mis à jour. +On doit toujours exécuter une commande <literal/update/ avant les commandes +<literal/upgrade/ ou <literal/dist-upgrade/. Il faut savoir que l'indicateur +de progression d'ensemble n'est pas correct puisque la taille de ces fichiers +ne peut être connue à l'avance. + </VarListEntry> + + <VarListEntry><Term>upgrade</Term> + <ListItem><Para> +La commande <literal/upgrade/ permet d'installer les versions les plus +récentes de tous les paquets présents sur le sytème en utilisant les +sources énumérées dans <filename>/etc/apt/sources.list</>. Les paquets +installés dont il existe de nouvelles versions sont récupérés et mis à +niveau. En aucun cas des paquets déjà installés ne sont supprimés ; de +même, des paquets qui ne sont pas déjà installés ne sont ni récupérés ni +installés. Les paquets dont de nouvelles versions ne peuvent pas être +installées sans changer le statut d'installation d'un autre paquet sont +laissés dans leur version courante. On doit d'abord exécuter la commande +<literal/update/ pour que <command/apt-get/ connaisse l'existence de +nouvelles versions des paquets. + </VarListEntry> + + <VarListEntry><Term>dselect-upgrade</Term> + <ListItem><Para> +Cette commande est utilisée conjointement avec &dselect;, l'interface +traditionnelle Debian GNU/Linux pour la gestion des paquets. +La commande <literal/dselect-upgrade/ suit les modifications faites par +&dselect; dans le champ <literal/Status/ des paquets disponibles, et effectue +les actions nécessaires à la réalisation de cet état (par exemple, +suppression d'anciens paquets, installation de nouveaux paquets). + </VarListEntry> + + <VarListEntry><Term>dist-upgrade</Term> + <ListItem><Para> +La commande <literal/dist-upgrade/ effectue la fonction <literal/upgrade/ en +y ajoutant une gestion intelligente des changements de dépendances dans les +nouvelles versions des paquets ; <command/apt-get/ possède un système +« intelligent » de résolution des conflits et il essaye, quand c'est +nécessaire, de mettre à niveau les paquets les plus importants aux dépens +des paquets les moins importants. Le fichier <filename>/etc/apt/sources.list</> +contient une liste de sources où récupérer les paquets désirés. + </VarListEntry> + + <VarListEntry><Term>install</Term> + <ListItem><Para> +La commande <literal/install/ est suivie par un ou plusieurs paquets à +installer. Chaque paquet est un nom de paquet ; ce n'est pas un nom de +fichier pleinement déterminé (par exemple, dans un système Debian GNU/Linux, +on indiquera libc6 et non pas <filename>libc6_1.9.6-2.deb</>). Tous les +paquets requis par le(s) paquet(s) que l'on veut installer sont aussi +récupérés et installés. On se sert du fichier +<filename>/etc/apt/sources.list</> pour localiser les paquets désirés. Quand +un trait d'union est accolé (sans espace intermédiaire) au nom d'un paquet +déjà installé, ce paquet est supprimé. De même on peut ajouter un signe +« + » pour désigner un paquet à installer. +Cette dernière fonctionnalité peut être utilisée pour annuler les décisions +prises par le système de résolution des conflits d'apt-get. + <para> +On peut choisir d'installer une version particulière d'un paquet en faisant +suivre son nom par un signe égal et par la version. Cette version sera +localisée et l'installation sera demandée. On peut aussi choisir une +distribution particulière en faisant suivre le nom du paquet par une barre +oblique et par le nom de la distribution ou de l'archive (stable, frozen, +unstable). + <para> +Avec ces possibilités de choisir la version, de vieilles versions d'un paquet +peuvent être installées. Il faut faire attention. + <para> +Quand aucun paquet ne correspond à l'expression donnée en argument et que cette +expression contient l'un des caractères « . », « ? » ou +« * », on considère que c'est une expression rationnelle POSIX et +elle est appliquée à tous les paquets de la base de données. Tout paquet +correspondant est installé (ou supprimé). Notez que la comparaison est +effectuée par sous-chaîne et « lo » correspond aussi bien à +« how-lo » qu'à « lowest ». Préfixez l'expression par +un caractère « ^ » si vous ne le voulez pas. + </VarListEntry> + + <VarListEntry><Term>remove</Term> + <ListItem><Para> +La commande <literal/remove/ est identique à la commande <literal/install/ ; +Mais les paquets sont supprimés et non pas installés. Quand un signe plus est +accolé (sans espace intermédiaire) au nom du paquet, le paquet est installé. + </VarListEntry> + + <VarListEntry><Term>source</Term> + <ListItem><Para> +Avec la commande <literal/source/, <command/apt-get/ récupère des paquets +sources. APT examine les paquets disponibles pour choisir le paquet source +à récupérer. Il trouve ensuite et télécharge dans le répertoire courant +la version la plus récente. Les paquets source sont suivis différemment que +les paquets binaires, via les lignes de type <literal/deb-src/ dans le fichier +&sources-list;. On n'obtiendra probablement pas les mêmes sources que celles +du paquet installé ou celles du paquet qu'on pourrait installer. Si l'option +<option>--compile</> est spécifiée, le paquet est compilé en un binaire .deb +avec <command>dpkg-buildpackage</>. Si <option>--download-only</> est +spécifié, le source n'est pas décompacté. + <para> +De la même façon qu'avec les paquets binaires, on peut récupérer une version +particulière d'un paquet source en faisant suivre son nom par un signe égal +et par la version. Cela permet une comparaison exacte entre le nom du paquet +source et la version ; cela lance implicitement la commande +<literal/APT::Get::Only-Source/. + <para> +Notez que les paquets sources ne sont pas suivis comme le sont les paquets +binaires. Ils ne sont présents que dans le répertoire courant et sont +semblables à des sources téléchargés sous forme de tarball. + </VarListEntry> + + <VarListEntry><Term>build-dep</Term> + <ListItem><Para> +Avec la commande <literal/build-dep/, 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 +hasard. + </VarListEntry> + + <VarListEntry><Term>check</Term> + <ListItem><Para> +La commande <literal/check/ est un outil de diagnostic ; il met à jour +le cache des paquets et cherche des dépendances défectueuses. + </VarListEntry> + + <VarListEntry><Term>clean</Term> + <ListItem><Para> +La commande <literal/clean/ nettoie le référentiel local des paquets +récupérés. Il supprime tout, excepté le fichier lock situé dans +<filename>&cachedir;/archives/</> et <filename>&cachedir;/archive/partial/</>. +Quand APT est utilisé comme mode de &dselect;, <literal/clean/ est effectué +automatiquement. Quand on n'utilise pas &dselect;, il faut exécuter +<literal/apt-get clean/ de temps en temps si l'on veut libérer de l'espace +disque. + </VarListEntry> + + <VarListEntry><Term>autoclean</Term> + <ListItem><Para> +Tout comme <literal/clean/, <literal/autoclean/ nettoie le référentiel local +des paquets récupérés. La différence est qu'il supprime uniquement les paquets +qui ne peuvent plus être téléchargés et qui sont grandement inutiles. +On peut ainsi contrôler la taille de ce cache sur une longue période. +Tant qu'elle n'est pas activée, l'option de configuration +<literal/APT::Clean-Installed/ empêche la suppression de paquets installés. + </VarListEntry> + </VariableList> + </RefSect1> + + <RefSect1><Title>Options</> + &apt-cmdblurb; + + <VariableList> + <VarListEntry><term><option/-d/</><term><option/--download-only/</> + <ListItem><Para> +Récupération seule ; les paquets sont ramenés mais ne sont ni dépaquetés +ni installés. Élément de configuration : <literal/APT::Get::Download-Only/. + </VarListEntry> + + <VarListEntry><term><option/-f/</><term><option/--fix-broken/</> + <ListItem><Para> +Correction ; essaye de réparer un système dont les dépendances sont +défectueuses. Cette option, utilisée avec install ou remove, peut omettre +tout paquet de façon à permettre à APT de déduire une solution viable. +Chaque paquet spécifié doit complètement corriger le problème. Cette option +est quelquefois nécessaire lorsque l'on exécute APT pour la première fois ; +APT lui-même interdit les dépendances défectueuses dans un système. Il est +possible que la structure de dépendances d'un système soit tellement +corrompue qu'elle requiert une intervention manuelle (ce qui veut dire la +plupart du temps utiliser &dselect; ou <command/dpkg --remove/ pour éliminer +les paquets en cause). L'utilisation de cette option conjointement avec +<option>-m</> peut produire une erreur dans certaines situations. +Élément de configuration : <literal/APT::Get::Fix-Broken/. + </VarListEntry> + + <VarListEntry><term><option/-m/</><term><option/--ignore-missing/</> + <term><option/--fix-missing/</> + <ListItem><Para> +Ignorer les paquets manquants ; si des paquets ne peuvent être +récupérés, ou, après récupération, ne satisfont pas au contrôle d'intégrité, +cette commande met ces paquets de côté et gère le résultat. Utiliser cette +option conjointement avec <option>-f</> peut produire une erreur dans +certaines situations. Quand un paquet, sélectionné pour une installation +(particulièrement si c'est mentionné en ligne de commande), ne peut être +récupéré, il est mis silencieusement de côté. Élément de configuration : +<literal/APT::Get::Fix-Missing/. + </VarListEntry> + + <VarListEntry><term><option/--no-download/</> + <ListItem><Para> +Pas de récupération. Le mieux est d'utiliser cette option avec +<option/--ignore-missing/ pour forcer APT à n'utiliser que les .deb qu'il a +déjà récupérés. +Élément de configuration : <literal/APT::Get::Download/. + </VarListEntry> + + <VarListEntry><term><option/-q/</><term><option/--quiet/</> + <ListItem><Para> +Mode silencieux ; cette commande produit une sortie destinée à +l'enregistrement dans un fichier-journal en omettant les indicateurs de +progression. Un plus grand nombre de « q » (2 au plus) produit un +plus grand silence. +On peut aussi utiliser <option/-q=#/ pour positionner le niveau de silence, +et annuler le fichier de configuration. Notez qu'un niveau de silence égal à 2 +implique <option>-y</> et vous ne devez jamais utiliser <option>-qq</> sans +l'accompagner d'un modificateur tel que <option>-d</>, <option>--print-uris</> + ou <option>-s</> : APT pourrait exécuter des actions inattendues ! +Élément de configuration : <literal/quiet/. + </VarListEntry> + + <VarListEntry><term><option/-s/</> + <term><option/--simulate/</> + <term><option/--just-print/</> + <term><option/--dry-run/</> + <term><option/--recon/</> + <term><option/--no-act/</> + <ListItem><Para> +Simulation ; cette commande réalise une simulation des actions qui +seraient exécutées mais ne modifie pas le système. +Élément de configuration : <literal/APT::Get::Simulate/. + <para> +la simulation affiche une série de lignes représentant chacune une opération +de dpkg, Configure (Conf),Remove (Remv),Unpack (Inst). Les crochets encadrent +des paquets endommagés et des crochets n'encadrant rien indiquent que les +dommages n'ont aucune conséquence (rare). + </VarListEntry> + + <VarListEntry><term><option/-y/</><term><option/--yes/</> + <term><option/--assume-yes/</> + <ListItem><Para> +Répond automatiquement oui aux questions ; présume « oui » +comme réponse à toutes les questions et s'exécute de manière non interactive. +Dans le cas d'une situation indésirable, comme le changement d'un paquet +gelé ou la suppression d'un paquet essentiel, <literal/apt-get/ +s'interrompt. +Élément de configuration : <literal/APT::Get::Assume-Yes/. + </VarListEntry> + + <VarListEntry><term><option/-u/</><term><option/--show-upgraded/</> + <ListItem><Para> +Afficher les paquets mis à niveau ; affiche une liste de tous les paquets à +mettre à niveau. Élément de configuration : <literal/APT::Get::Show-Upgraded/. + </VarListEntry> + + <VarListEntry><term><option/-b/</><term><option/--compile/</> + <term><option/--build/</> + <ListItem><Para> +Cette commande compile un paquet source après l'avoir récupéré. +Élément de configuration : <literal/APT::Get::Compile/. + </VarListEntry> + + <VarListEntry><term><option/--ignore-hold/</> + <ListItem><Para> +Cette commande ignore la marque « Hold » d'un paquet ; par ce biais, +<command/apt-get/ ignore un « hold » placé sur un paquet. cela peut être utile +avec <literal/dist-upgrade/ pour annuler un grand nombre de « hold » +indésirables. Élément de configuration : <literal/APT::Ignore-Hold/. + </VarListEntry> + + <VarListEntry><term><option/--no-upgrade/</> + <ListItem><Para> +Aucune mise à niveau ; quand elle est utilisée avec <literal/install/, +cette commande empêche les paquets listés et déja installés d'être mis à +niveau. +Élément de configuration : <literal/APT::Get::Upgrade/. + </VarListEntry> + + <VarListEntry><term><option/--force-yes/</> + <ListItem><Para> +Forcer l'acceptation ; cette option est dangereuse parce qu'elle laisse +APT continuer sans poser de questions quand il réalise quelque chose de +potentiellement dommageable. Cette option ne doit être utilisée que dans des +circonstances très spéciales. Utiliser <literal/force-yes/ peut détruire le système ! +Élément de configuration : <literal/APT::Get::force-yes/. + </VarListEntry> + + <VarListEntry><term><option/--print-uris/</> + <ListItem><Para> +Au lieu d'aller chercher les paquets à installer, leurs URI sont affichées. +Chaque URI a un chemin, un nom de fichier destination, une taille et une +clé md5 attendue. Notez que le nom de fichier à afficher ne correspond pas +toujours au nom de fichier sur le site distant ! Cette option marche +aussi avec la commande <literal/source/. +Élément de configuration : <literal/APT::Get::Print-URIs/. + </VarListEntry> + + <VarListEntry><term><option/--purge/</> + <ListItem><Para> +Utiliser purge à la place de remove pour supprimer tout ce qui peut être +supprimé. +Élément de configuration : <literal/APT::Get::Purge/. + </VarListEntry> + + <VarListEntry><term><option/--reinstall/</> + <ListItem><Para> +Réinstaller les paquets déjà installés avec leur version la plus récente. +Élément de configuration : <literal/APT::Get::ReInstall/. + </VarListEntry> + + <VarListEntry><term><option/--list-cleanup/</> + <ListItem><Para> +Cette option est activée par défaut ; utilisez <literal/--no-list-cleanup/ +pour la désactiver. Quand elle est activée, <command/apt-get/ gère +automatiquement le contenu de <filename>&statedir;/lists</> afin d'assurer +que les fichiers obsolètes sont effacés. La seule raison de la désactiver +est une modification fréquente de votre liste de sources. +Élément de configuration : <literal/APT::Get::List-Cleanup/. + </VarListEntry> + + <VarListEntry><term><option/-t/</> + <term><option/--target-release/</> + <term><option/--default-release/</> + <ListItem><Para> +Cette option contrôle l'entrée par défaut pour les questions de +distribution ; une étiquette (pin) par défaut dont la priorité vaut 990 +est crée en utilisant la chaîne spécifiée. Le fichier des préférences peut +annuler cette décision. En clair, cette option permet de contrôler simplement +dans quelle distribution seront récupérés les paquets. Par exemple : +<option>-t '2.1*'</> ou <option>-t unstable</>. Élément de configuration : <literal/APT::Default-Release/. + </VarListEntry> + + <VarListEntry><term><option/--trivial-only/</> + <ListItem><Para> +Ne réalise que les opérations « triviales ». Logiquement ceci peut être +considéré comme relatif à <option>--assume-yes</>. Alors que +<option>--assume-yes</> répond oui à n'importe quelle question, +<option>--trivial-only</> répond non. +Élément de configuration : <literal/APT::Get::Trivial-Only/. + </VarListEntry> + + <VarListEntry><term><option/--no-remove/</> + <ListItem><Para> +Quand des paquets doivent être supprimés, apt-get s'arrête immédiatement sans +poser de questions. Élément de configuration : <literal/APT::Get::Remove/. + </VarListEntry> + + <VarListEntry><term><option/--only-source/</> + <ListItem><Para> +Cette option n'a de sens qu'avec la commande <literal/source/. Elle indique +que les noms de sources donnés ne doivent pas être repérés à travers la +table binaire. +Élément de configuration : <literal/APT::Get::Only-Source/ + </VarListEntry> + + <VarListEntry><term><option/--diff-only/</><term><option/--tar-only/</> + <ListItem><Para> +Ne récupérer que le fichier diff ou tar d'une archive de source. +Élément de configuration : <literal/APT::Get::Diff-Only/ et +<literal/APT::Get::Tar-Only/. + </VarListEntry> + + <VarListEntry><term><option/--arch-only/</> + <ListItem><Para> +Ne traiter que les dépendances de construction pour telle architecture. +Élément de configuration : <literal/APT::Get::Arch-Only/ + </VarListEntry> + + + &apt-commonoptions; + + </VariableList> + </RefSect1> + + <RefSect1><Title>Fichiers</> + <variablelist> + <VarListEntry><term><filename>/etc/apt/sources.list</></term> + <ListItem><Para> +Liste les emplacements où aller chercher les paquets. +Élément de configuration : <literal/Dir::Etc::SourceList/. + </VarListEntry> + + <VarListEntry><term><filename>/etc/apt/apt.conf</></term> + <ListItem><Para> +Fichier de configuration d'APT. +Élément de configuration : <literal/Dir::Etc::Main/. + </VarListEntry> + + <VarListEntry><term><filename>/etc/apt/apt.conf.d/</></term> + <ListItem><Para> +Éléments du fichier de configuration d'APT. +Élément de configuration : <literal/Dir::Etc::Parts/. + </VarListEntry> + + <VarListEntry><term><filename>/etc/apt/preferences</></term> + <ListItem><Para> +Fichier des préférences. +Élément de configuration : <literal/Dir::Etc::Preferences/. + </VarListEntry> + + + <VarListEntry><term><filename>&cachedir;/archives/</></term> + <ListItem><Para> +Zone de stockage pour les paquets récupérés. +Élément de configuration : <literal/Dir::Cache::Archives/. + </VarListEntry> + + <VarListEntry><term><filename>&cachedir;/archives/partial/</></term> + <ListItem><Para> +Zone de stockage pour les paquets en transit. +Élément de configuration : <literal/Dir::Cache::Archives/ (implicitement, partial). + </VarListEntry> + + <VarListEntry><term><filename>&statedir;/lists/</></term> + <ListItem><Para> +Zone de stockage des informations concernant chaque ressource spécifiée dans +&sources-list;. +Élément de configuration : <literal/Dir::State::Lists/. + </VarListEntry> + + <VarListEntry><term><filename>&statedir;/lists/partial/</></term> + <ListItem><Para> +Zone de stockage pour les informations d'état des paquets en transit. +Élément de configuration : <literal/Dir::State::Lists/ (implicit partial). + </VarListEntry> + </variablelist> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &apt-cache;, &dpkg;, &dselect;, &sources-list;, &apt-conf;, Le guide + « APT users guide » dans &docdir;, &apt-preferences;. + </RefSect1> + + <RefSect1><Title>Diagnostics</> + <para> +<command/apt-get/ retourne zéro après un déroulement normal, et le nombre +décimal 100 en cas d'erreur. + </RefSect1> + + &manbugs; + &manauthor; + &deux-traducteurs; +</refentry> diff --git a/doc/fr/apt-sortpkgs.fr.1.sgml b/doc/fr/apt-sortpkgs.fr.1.sgml index 8e964f6b8..52dbe529a 100644 --- a/doc/fr/apt-sortpkgs.fr.1.sgml +++ b/doc/fr/apt-sortpkgs.fr.1.sgml @@ -7,7 +7,7 @@ ]> -<refentry lang=fr> +<refentry> &apt-docinfo; <refmeta> @@ -16,7 +16,7 @@ </refmeta> <!-- Man page title --> - <refnamediv> + <refnamediv lang=fr> <refname>apt-sortpkgs</> <refpurpose>Un outil pour trier les index de paquets. </refnamediv> @@ -39,7 +39,7 @@ paquet) et trie leurs enregistrements selon le nom de paquet. Un tri des champs de chaque enregistrement est réalisé selon des règles internes. <para> -Le résultat est envoyé sur la sortie standard ; l'entrée doit être un +Le résultat est envoyé sur la sortie standard ; l'entrée doit être un fichier analysable. </RefSect1> diff --git a/doc/fr/apt.conf.fr.5.sgml b/doc/fr/apt.conf.fr.5.sgml index 3e104203e..22f440a65 100644 --- a/doc/fr/apt.conf.fr.5.sgml +++ b/doc/fr/apt.conf.fr.5.sgml @@ -1,5 +1,5 @@ <!-- -*- mode: sgml; mode: fold -*- --> -<!-- translation of version 1.5 --> +<!-- translation of version 1.9 --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> @@ -24,17 +24,18 @@ <RefSect1><Title>Description</> <para> <filename/apt.conf/ est le principal fichier de configuration de la -collection d'outils que constitue APT ; tous les outils font appel à ce -fichier de configuration et utilisent un analyseur syntaxique de ligne de +collection d'outils que constitue APT ; 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/ ; puis il lit les fichiers situés dans +<envar/APT_CONFIG/ ; 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/ ; enfin il applique les options de la ligne de commande qui annulent les directives de configuration, chargeant, +indiqué par <literal/Dir::Etc::main/ ; 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 (« :: ») pour indiquer une option ; par exemple, <literal/APT::Get::Assume-Yes/ est +organisées en groupes fonctionnels. On se sert du double deux points (« :: ») pour indiquer une option ; 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> @@ -66,7 +67,7 @@ montrent <para> Deux éléments spéciaux sont autorisés : <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 à +moins que le nom ne 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 @@ -79,22 +80,22 @@ de la liste. <RefSect1><Title>Le groupe APT</> <para> -Ce groupe d'options contrôle aussi bien le comportement global d' APT que +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 ; cette option positionne l'architecture à utiliser +L'architecture du système ; 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 « suspendus » ; cette option globale indique au système de -résolution de ne pas tenir compte des paquets « suspendus » dans sa prise de -décision. +Ignore les paquets « gelés » ; cette option globale indique au +système de résolution de ne pas tenir compte des paquets « gelés » +dans sa prise de décision. </VarListEntry> <VarListEntry><Term>Clean-Installed</Term> @@ -108,9 +109,9 @@ direct pour les r <VarListEntry><Term>Immediate-Configure</Term> <ListItem><Para> -Désactive la configuration immédiate ; cette dangereuse option désactive +Désactive la configuration immédiate ; 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 +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. @@ -118,19 +119,26 @@ Utilisez-la <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 +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 : 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. +NE DOIT JAMAIS SE PRODUIRE : 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 « available ». Cette option fixe la taille de ce cache. +informations du fichier « available ». Cette option fixe la taille +de ce cache. + </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. </VarListEntry> <VarListEntry><Term>Get</Term> @@ -163,24 +171,24 @@ les gestionnaires d'URI. <VariableList> <VarListEntry><Term>Queue-Mode</Term> <ListItem><Para> -Le mode file d'attente ; <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. +Le mode file d'attente ; <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é. +récupérer, le nombre donné de fois, les fichiers dont la récupération a échoué. </VarListEntry> <VarListEntry><Term>Source-Symlinks</Term> <ListItem><Para> Utilise des liens symboliques pour les archives de sources. Positionnée à -« true », cette option crée si possible des liens symboliques vers les -archives de sources au lieu de les copier. +« true », cette option crée si possible des liens symboliques vers +les archives de sources au lieu de les copier. Par défaut à « true ». </VarListEntry> @@ -196,7 +204,7 @@ remplace tous ces param <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 ; <literal/Max-Age/ +ne doit pas du tout utiliser les réponses qu'il a stockées ; <literal/Max-Age/ sert uniquement pour les fichiers d'index : 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 @@ -223,7 +231,7 @@ ne respectent pas la RFC 2068. <ListItem><Para> FTP URIs ; ftp::Proxy est le serveur mandataire par défaut à utiliser. Il se présente sous la forme standard : -<literal>ftp://[[user][:pass]@]host[:port]/</> ; il est remplacé par la +<literal>ftp://[[user][:pass]@]host[:port]/</> ; 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 @@ -237,9 +245,10 @@ L'option <literal/timeout/ positionne le compteur de temps mort (timeout) utilisé par la méthode : 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 ; cela marche -dans presque tous les environnements. Cependant, certaines situations -nécessitent que le mode passif soit désactivé et que le mode « port » de ftp +passif. Généralement, c'est plus sûr d'activer le mode passif ; cela +marche dans presque tous les environnements. Cependant, certaines situations +nécessitent que le mode passif soit désactivé et que le mode +« port » 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). @@ -252,17 +261,18 @@ d'utiliser HTTP par FTP <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 -« false » ; ce qui signifie que ces commandes ne sont utilisées que pour une -connexion de type IPv6. Quand elle vaut « true », on les utilise même si -la connexion est de type IPv4. La plupart des serveurs FTP ne suivent pas -la RFC 2428. +« false » ; ce qui signifie que ces commandes ne sont +utilisées que pour une connexion de type IPv6. Quand elle vaut +« true », 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 ; la seule option de configuration pour les URIs de CDROM -est le point de montage : <literal/cdrom::Mount/ ; il doit représenter le -point de montage du lecteur de cédérom indiqué dans <filename>/etc/fstab</>. +CDROM URIs ; la seule option de configuration pour les URIs de CDROM +est le point de montage : <literal/cdrom::Mount/ ; 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 @@ -277,20 +287,21 @@ peuvent <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 : c'est le nom du fichier de préférence. +téléchargés et <literal/status/ est le nom du fichier d'état de Dpkg. +<literal/preferences/ concerne APT : c'est le nom du fichier des +préférences. <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 : 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 +cache local : 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 se passer du cache <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, @@ -305,7 +316,7 @@ 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/ ; <literal/gzip/, <literal/Dpkg/, <literal/apt-get/, +<literal/methods/ ; <literal/gzip/, <literal/Dpkg/, <literal/apt-get/, <literal/dpkg-source/, <literal/dpkg-buildpackage/ et <literal/apt-cache/ indiquent l'emplacement des programmes correspondants. </RefSect1> @@ -319,13 +330,15 @@ contr <VariableList> <VarListEntry><Term>Clean</Term> <ListItem><Para> -Mode de nettoyage du cache ; cette variable peut prendre l'une des valeurs -suivantes : « always », « prompt », « auto », « pre-auto » et « never ». -« always » et « prompt » suppriment tous les paquets du cache après la mise à -niveau ; « prompt » (valeur par défaut) les supprime après une demande et -« auto » ne supprime que les archives qui ne peuvent plus être téléchargées -(remplacées, par exemple, par une nouvelle version). « pre-auto » les -supprime avant de récupérer de nouveaux paquets. +Mode de nettoyage du cache ; cette variable peut prendre l'une des valeurs +suivantes : « always », « prompt », +« auto », « pre-auto » et « never ». +« always » et « prompt » suppriment tous les paquets du +cache après la mise à niveau ; « prompt » (valeur par défaut) +les supprime après une demande et « auto » ne supprime que les +archives qui ne peuvent plus être téléchargées (remplacées, par exemple, par +une nouvelle version). « pre-auto » les supprime avant de récupérer +de nouveaux paquets. </VarListEntry> <VarListEntry><Term>Options</Term> @@ -342,9 +355,9 @@ ligne de commande quand ce programme est utilis <VarListEntry><Term>PromptAfterUpdate</Term> <ListItem><Para> -Si cette option est « vraie », 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. +Si cette option est « vraie », 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> @@ -357,45 +370,45 @@ invoque &dpkg; : 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 +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. +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 : APT -s'arrête dès que l'une d'elles échoue. +liste. Les commandes sont appelées dans l'ordre, en utilisant +<filename>/bin/sh</> : 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 : 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. +Les commandes sont appelées dans l'ordre, en utilisant +<filename>/bin/sh</> : 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 : 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 +La deuxième version de ce protocole donne plus de renseignements : on +obtient la version du protocole, la configuration de APT et les paquets, +fichiers ou versions qui ont changé. 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 ; par défaut c'est le -répertoire <filename>/</>. +APT se place dans ce répertoire avant d'appeler Dpkg ; 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 ; par défaut la signature est désactivée et tous les binaires sont +paquets ; par défaut la signature est désactivée et tous les binaires sont créés. </VarListEntry> </VariableList> @@ -404,13 +417,14 @@ cr <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 ; 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 « root » 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. +pour le simple utilisateur ; 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 « root » et +<literal/Debug::pkgDPkgPM/ affiche la ligne de commande à chaque appel de +Dpkg. <literal/Debug::IdentCdrom/ désactive l'inclusion de +données de type statfs dans les ID de CDROM. </RefSect1> <RefSect1><Title>Exemples</> diff --git a/doc/fr/apt.ent.fr b/doc/fr/apt.ent.fr index 527fe0e74..b2aacd5aa 100644 --- a/doc/fr/apt.ent.fr +++ b/doc/fr/apt.ent.fr @@ -1,5 +1,5 @@ <!-- -*- mode: sgml; mode: fold -*- --> -<!-- translation of version 1.7 --> +<!-- translation of version 1.9 --> <!-- Some common paths.. --> <!ENTITY docdir "/usr/share/doc/apt/"> <!ENTITY configureindex "<filename>&docdir;examples/configure-index.gz</>"> @@ -48,8 +48,8 @@ </CiteRefEntry> "> -<!ENTITY bug "<CiteRefEntry> - <RefEntryTitle><command/bug/</RefEntryTitle> +<!ENTITY reportbug "<CiteRefEntry> + <RefEntryTitle><command/reportbug/</RefEntryTitle> <ManVolNum/1/ </CiteRefEntry> "> @@ -106,7 +106,7 @@ Voyez la <ulink url='http://bugs.debian.org/apt'> page concernant les bogues de APT</>. Si vous voulez rapporter un bogue, consultez le texte <filename>/usr/share/doc/debian/bug-reporting.txt</> ou utilisez la -commande &bug;. +commande &reportbug;. </RefSect1> "> @@ -114,7 +114,7 @@ commande &bug;. <!ENTITY manauthor " <RefSect1><Title>Auteur</> <para> - APT a été écrit par l'équipe APT <email>apt@packages.debian.org.</> + APT a été écrit par l'équipe APT <email>apt@packages.debian.org</>. </RefSect1> "> @@ -122,14 +122,14 @@ commande &bug;. <!ENTITY deux-traducteurs " <RefSect1><Title>Traduction</> <para> -Jérôme Marant. 2000 ; mise à jour : Philippe Batailler. 2001.</> +Jérôme Marant. 2000 ; mise à jour : Philippe Batailler. 2003. </RefSect1> "> <!ENTITY traducteur " <RefSect1><Title>Traduction</> <para> -Philippe Batailler. 2001. +Philippe Batailler. 2003. </RefSect1> "> @@ -148,14 +148,14 @@ Affiche la version du programme. <VarListEntry><term><option/-c/</><term><option/--config-file/</> <ListItem><Para> -Fichier de configuration ; indique quel fichier de configuration utiliser. +Fichier de configuration ; indique quel fichier de configuration utiliser. Le programme lit le fichier de configuration par défaut, puis celui-ci. Voyez &apt-conf; pour la syntaxe. </VarListEntry> <VarListEntry><term><option/-o/</><term><option/--option/</> <ListItem><Para> -Donne une option de configuration ; cela fixe une option de configuration +Donne une option de configuration ; cela fixe une option de configuration arbitraire. La syntaxe est : <option>-o Foo::Bar=bar</>. </VarListEntry> "> @@ -164,8 +164,8 @@ arbitraire. La syntaxe est : <option>-o Foo::Bar=bar</>. put in the blurb about -h, -v, -c and -o --> <!ENTITY apt-cmdblurb " <para> -Toutes les options de ligne de commande peuvent être positionnées via le -fichier de configuration ; les descriptifs indiquent l'option de +Toutes les options en ligne de commande peuvent être positionnées via le +fichier de configuration ; les descriptifs indiquent l'option de configuration à positionner. En ce qui concerne les options booléennes, on peut annuler le fichier de configuration en utilisant quelque chose comme <option/-f-/,<option/--no-f/, <option/-f=no/ ou d'autres variantes. diff --git a/doc/fr/apt_preferences.fr.5.sgml b/doc/fr/apt_preferences.fr.5.sgml index f910ef4f1..d6530bd2c 100644 --- a/doc/fr/apt_preferences.fr.5.sgml +++ b/doc/fr/apt_preferences.fr.5.sgml @@ -1,5 +1,5 @@ <!-- -*- mode: sgml; mode: fold -*- --> -<!-- translation of version 1.3 --> +<!-- translation of version 1.6 --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> @@ -9,235 +9,545 @@ <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</> + <refpurpose>Un fichier de contrôle, utilisé par APT et 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 : 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 : <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 ; 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 ; cette chaîne est une liste de clés -(une seule lettre) suivies d'un mot et séparées par une virgule. Exemples : -<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 : - <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 ; 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 : -il choisit, parmi les versions plus récentes que la version installée, la -version qui possède la plus haute priorité ; ensuite il choisit, parmi -les versions plus anciennes que la version installée, celle qui possède la -plus haute priorité. Deuxièmement : 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 : 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 : - <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 : -<informalexample><programlisting> -Package: apt -Pin: version 0.4.0 +<RefSect1><Title>Description</> +<para> +Le fichier d'APT, <filename>/etc/apt/preferences</>, peut être utilisé pour +choisir la version des paquets que l'on veut installer. +</para> + +<para>Quand le fichier &sources-list; contient des références à plusieurs +distributions (par exemple, <literal>stable</literal> et +<literal>testing</literal>), plusieurs versions d'un paquet peuvent être +installées ; et, si ce fichier contient, pour une même distribution, +des références à plusieurs sites de téléchargement, il peut exister plusieurs +exemplaires de la même version d'un paquet. Apt affecte une priorité à +chaque exemplaire disponible. (Dans ce qui suit, un exemplaire est l' +exemplaire d'un paquet disponible selon le fichier &sources-list;.) +La commande <command>apt-get</command>, tenant compte des contraintes de +dépendance, installe l'exemplaire possédant la plus haute priorité. Si deux +exemplaires ont la même priorité, elle installe l'exemplaire le plus récent, +c'est-à-dire celui qui possède le numéro de version le plus haut. +</para> + +<para>Le fichier des préférences annule les priorités assignées par défaut +aux exemplaires des paquets : ainsi l'utilisateur peut choisir +l'exemplaire qu'il veut installer. +</para> + +<RefSect2><Title>Les priorités assignées par défaut</> + +<para>Quand le fichier des préférences n'existe pas, ou quand aucune entrée +de ce fichier ne s'applique à un exemplaire précis, la priorité affectée à +cet exemplaire est la priorité de la distribution à laquelle il appartient. +On peut distinguer une distribution et lui donner une priorité plus haute +que celle des autres distributions : on l'appelle la distribution par +défaut ou « target release » et elle peut être définie sur la ligne +de commande de <command>apt-get</command> ou dans le fichier de configuration +d'APT, <filename>/etc/apt/apt.conf</filename>. +Par exemple : + +<programlisting> +# Commande pour installer la version <literal/testing/ d'un <replaceable>paquet</replaceable> +<command>apt-get install -t testing <replaceable>paquet</replaceable></command> +</programlisting> + +<programlisting> +# Utiliser le fichier de configuration pour rendre la distribution +<literal/stable/ la distribution par defaut (ou « target release ») +APT::Default-Release "stable"; +</programlisting> +</para> + +<para>Quand une distribution par défaut a été indiquée, APT utilise +l'algorithme suivant pour déterminer la priorité des exemplaires d'un +paquet : + +<variablelist> +<varlistentry> +<term>une priorité égale à 100</term> +<listitem><simpara>est affectée à l'exemplaire déjà installé (s'il existe). +</simpara></listitem> +</varlistentry> +<varlistentry> +<term>une priorité égale à 500</term> +<listitem><simpara>est affectée aux exemplaires qui ne sont pas installés et +qui n'appartiennent pas à la distribution par défaut. +</simpara></listitem> +</varlistentry> +<varlistentry> +<term>une priorité égale à 990</term> +<listitem><simpara>est affectée aux exemplaires qui ne sont pas installés et +qui appartiennent à la distribution par défaut. +</simpara></listitem> +</varlistentry> +</variablelist> +</para> + +<para>Quand aucune distribution par défaut n'a été indiquée, APT affecte +simplement une priorité égale à 100 à tout exemplaire installé d'un paquet +et une priorité égale à 500 à tout exemplaire non installé d'un paquet. +</para> + +<para>Puis APT applique les règles suivantes pour déterminer l'exemplaire +du paquet qu'il faut installer (elles sont listées par ordre de priorité) : + +<itemizedlist> +<listitem><simpara>Ne jamais revenir en arrière, sauf si la priorité d'un +exemplaire disponible dépasse 1000. (« Revenir en arrière » signifie +installer une version moins récente que la version installée. Il +faut noter qu'aucune des priorités par défaut n'excède 1000 ; de telles +valeurs ne peuvent être définies que dans le fichier des préférences.) +</simpara></listitem> +<listitem><simpara>Installer l'exemplaire qui possède la priorité la plus +haute. +</simpara></listitem> +<listitem><simpara>Quand deux (ou plus) exemplaires ont la même priorité, +installer l'exemplaire le plus récent. +</simpara></listitem> +<listitem><simpara>Quand deux (ou plus) exemplaires ont le même numéro de +version, installer l'exemplaire dont la source est listée en premier dans +&sources-list;. (L'exemplaire installé, s'il existe, est toujours choisi +dans une telle comparaison, sauf si la commande +<command>apt-get --reinstall</command> est utilisée.) +</simpara></listitem> +</itemizedlist> +</para> + +<para>En général, l'exemplaire installé d'un paquet (priorité 100) n'est +pas aussi récent que l'un des exemplaires disponibles dans les sources +listées dans le fichier &sources-list; (priorité 500 ou 990). Et donc le +paquet sera mis à niveau avec la commande : +<command>apt-get install</command> ou <command>apt-get dist-upgrade</command>. +</para> + +<para>L'exemplaire installé d'un paquet peut être - rarement - +<emphasis/plus/ récent que tout autre exemplaire disponible. Pas de retour +en arrière. +</para> + +<para>Parfois, l'exemplaire installé d'un paquet est plus récent que la +version appartenant à la distribution par défaut, mais moins récent que +la version appartenant à une autre distribution. Un tel exemplaire sera mis +à niveau car au moins <emphasis/l'un/ des exemplaires disponibles possède +une plus haute priorité que la sienne. +</para> + +</RefSect2> + +<RefSect2><Title>Conséquences des préférences</> + +<para>Le fichier des préférences permet à l'administrateur-système de +choisir ses priorités. Ce fichier est constitué d'une ou plusieurs entrées +séparées par des lignes blanches. Ces entrées peuvent avoir deux formes, +une forme particulière et une forme générale. +<itemizedlist> +<listitem> +<simpara>La forme particulière affecte une priorité +(<emphasis>Pin-Priority</emphasis>) à un paquet précis, à une version précise +ou à un intervalle spécifiant plusieurs versions. Par exemple, l'entrée +suivante affecte une priorité haute à toutes les versions du paquet +<filename/perl/ dont le numéro de version commence par <literal/5.8/. +</simpara> + +<programlisting> +Package: perl +Pin: version 5.8* 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 : version, release ou origin ; le reste du -champ est décrit plus haut dans la section « Règles pour le choix d'une -version ». - <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 ; la première correspondant au défaut sélectionne la priorité pour -les fichiers d'un paquet. Seuls « release » et « origin » -peuvent être utilisés dans le nom de l'étiquette puisqu'ils correspondent aux -fichiers <filename/Packages/. -<informalexample><programlisting> +</programlisting> +</listitem> + +<listitem><simpara> +La forme générale affecte une priorité à toutes les versions d'un paquet dans +une distribution donnée (c'est-à-dire, à toutes les versions d'un paquet qui +sont listées dans un fichier <filename/Release/), ou à toutes les versions +d'un paquet provenant d'un site internet identifié par un nom pleinement +qualifié. +</simpara> + +<simpara>Cette forme générale des entrées du fichier des préférences +s'applique seulement aux groupes de paquets. Par exemple, l'entrée suivante +affecte une priorité haute à tous les exemplaires disponibles dans le +site local. +</simpara> + +<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/ ; <literal/1.1/ est la version installée ; les -priorités de chaque version sont : 900, 100 et 950 respectivement : -la version <literal/1.2/ sera installée. - <para> -Dans la pratique, c'est ce qu'on veut ! Un utilisateur utilisera une -étiquette par défaut pour rendre la distribution « stable » la -distribution par défaut ; il utilisera ensuite l'option -<option/--target-dist/ avec &apt-get; pour choisir de nouvelles versions dans -« unstable ». Les paquets mis à niveau avec « unstable » -suivront les versions disponibles dans « unstable » puisque les -versions de « stable » 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 -à « unstable » 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 ; 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; +Pin: origin "" +Pin-Priority: 999 +</programlisting> + +<simpara>Attention ! le mot-clé utilisé ici, <literal/origin/, ne doit pas +être confondu avec l'« Origin: » d'une distribution indiqué dans +un fichier <filename/Release/. Ce qui suit l'étiquette « Origin: » +dans un fichier <filename/Release/ n'est pas l'adresse d'un site internet +mais le nom d'un auteur ou d'un vendeur, comme Debian ou Ximian. +</simpara> + +<simpara>L'entrée suivante affecte une priorité basse à toutes les versions +d'un paquet appartenant à tout distribution dont le nom +d'« Archive » (<literal/a/) est <literal/unstable/. +</simpara> + +<programlisting> +Package: * +Pin: release a=unstable +Pin-Priority: 50 +</programlisting> + +<simpara>L'entrée suivante affecte une priorité haute à toutes les versions +d'un paquet appartenant à toute distribution dont le nom +d'« Archive » (<literal/a/) est <literal/stable/ et dont le numéro +de « Version » (<literal/v/) est <literal/3.0/. +</simpara> + +<programlisting> +Package: * +Pin: release a=stable, v=3.0 +Pin-Priority: 50 +</programlisting> +</listitem> +</itemizedlist> +</para> + +</RefSect2> + +<RefSect2><Title>Comment APT interprète-t-il les priorités ? + +Les priorités (P) indiquées dans le fichier des préférences doivent +être des entiers positifs ou négatifs. Ils sont interprétés comme suit : + + +P > 1000 +Cette priorité entraîne l'installation du paquet même s'il +s'agit d'un retour en arrière. + + +990 < P <=1000 +L'exemplaire sera installé, même s'il n'appartient pas à +la distribution par défaut ; mais il ne sera pas installé si l'exemplaire +installé est plus récent. + + +500 < P <=990 +L'exemplaire sera installé, sauf s'il existe un exemplaire +appartenant à la distribution par défaut ou si la version installée est plus +récente. + + +100 < P <=500 +L'exemplaire sera installé, sauf s'il existe un exemplaire +appartenant à une autre distribution ou si la version installée est plus +récente. + +0 <= P <=100 + L'exemplaire sera installé si aucun exemplaire du paquet +n'est installé. + + +P < 0 +Cette priorité empêche l'installation de l'exemplaire. + + + + + +Si l'une des entrées de forme particulière correspond à l'exemplaire +disponible d'un paquet, cette entrée détermine la priorité de cet exemplaire. +Si deux entrées de forme particulière correspondent à l'exemplaire disponible +d'un paquet, la première entrée rencontrée détermine la priorité. Si deux +entrées de forme générale correspondent à l'exemplaire disponible d'un paquet, +la première entrée rencontrée détermine la priorité. + + +Supposons par exemple que le fichier des préférences contienne les trois +entrées décrites plus haut : + + +Package: perl +Pin: version 5.8* +Pin-Priority: 1001 + +Package: * +Pin: origin "" +Pin-Priority: 999 + +Package: * +Pin: release unstable +Pin-Priority: 50 + + +Alors : + + + La version la plus récente du paquet +Les exemplaires des paquets (autres que + L'exemplaire d'un paquet dont l'origine n'est pas le site +local mais un site internet listé dans &sources-list; et qui appartient à une +distribution + + + + +Détermination de la version des paquets et des propriétés des +distributions + +Chaque source listée dans le fichier &sources-list; doit fournir +les fichiers Packages et Release +qui décrivent les exemplaires des paquets disponibles à cet endroit. + + +Le fichier Packages se trouve normalement dans le +répertoire +.../dists/dist-name/component/arch, par exemple, +.../dists/stable/main/binary-i386/Packages. Il consiste +en entrées composées de lignes, une pour chaque paquet disponible dans le +répertoire. Seules deux lignes des entrées sont pertinentes pour la +détermination des priorités : + + +La ligne +donne le nom du paquet + + +La ligne +donne le numéro de version du paquet + + + + + Le fichier Release se trouve normalement dans le +répertoire +.../dists/dist-name, par exemple, .../dists/stable/Release, ou .../dists/woody/Release. +Il consiste en une seule entrée composée de plusieurs lignes qui s'applique à + + +La ligne +nomme l'archive à laquelle appartiennent tous les +exemplaires des paquets situés dans les répertoires. Par exemple, la ligne + + + +Pin: release a=stable + + + + + +La ligne +indique la version de la distribution. Par exemple, les +exemplaires des paquets dans les répertoires peuvent appartenir à la +distribution Debian GNU/Linux version 3.0. Il n'y a pas de numéro de version +pour les distributions testing et unstable car elles n'ont pas encore été +publiées. Indiquer cette valeur dans le fichier des préférences demanderait +ces lignes : + + + +Pin: release v=3.0 +Pin: release a=stable v=3.0 +Pin: release 3.0 + + + + + + +La ligne +nomme un composant qui indique le type de licence associé +aux exemplaires situés dans les répertoires sous le fichier + + + +Pin: release c=main + + + + + +La ligne +nomme le producteur des exemplaires des paquets situés +dans les répertoires sous le fichier + + +Pin: release o=Debian + + + + + +La ligne +semble redondante. En général, c'est + + + +Pin: release l=Debian + + + + + + +Tous les fichiers Packages et +Release récupérés dans des sources listées par le +fichier &sources-list; sont conservés dans le répertoire +/var/lib/apt/lists ou dans le fichier spécifié par la +variable debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release contient le fichier Release du site + + + + +Lignes facultatives dans le fichier des préférences + +Toute entrée du fichier des préférences peut commencer par une ou +plusieurs lignes contenant le mot + +La ligne + + + +Exemples</> +<RefSect2><Title>Comment suivre Stable ? + +Le fichier des préférences suivant affecte une priorité plus haute que +la priorité par défaut (500) à tous les exemplaires appartenant à la +distribution +Package: * +Pin: release a=stable +Pin-Priority: 900 + +Explanation: Ne pas installer des exemplaires d'origine Debian +Explanation: sauf ceux de la distribution stable +Package: * +Pin: release o=Debian +Pin-Priority: -10 + + + +Avec le fichier des préférences ci-dessus et un fichier &sources-list; +adéquat, les commandes suivantes utiliseront les versions les plus récentes +de +apt-get install paquet +apt-get upgrade +apt-get dist-upgrade + + + +La commande suivante utilisera la version la plus récente de la +distribution +apt-get install paquet/testing + + + + Comment suivre Testing ? + +Le fichier des préférences suivant affecte une priorité haute aux +versions des paquets appartenant à la distribution +Package: * +Pin: release a=testing +Pin-Priority: 900 + +Package: * +Pin: release a=unstable +Pin-Priority: 800 + +Package: * +Pin: release o=Debian +Pin-Priority: -10 + + + +Avec le fichier des préférences ci-dessus, les commandes suivantes +utiliseront les versions les plus récentes de +apt-get install paquet +apt-get upgrade +apt-get dist-upgrade + + + +La commande suivante utilisera la version la plus récente de la +distribution apt-get dist-upgrade et les autres +commandes +apt-get install paquet/unstable + + + + + + + See Also</> +<para> +&apt-get; &apt-cache; &apt-conf; &sources-list; </RefSect1> &manbugs; &manauthor; -&traducteur; +&traducteur; </refentry> diff --git a/doc/fr/makefile b/doc/fr/makefile index 4e6aafb9e..e0dd31c1f 100644 --- a/doc/fr/makefile +++ b/doc/fr/makefile @@ -5,8 +5,10 @@ SUBDIR=doc/fr # Bring in the default rules include ../../buildlib/defaults.mak -SOURCE = 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 +# Man pages +SOURCE = apt-cache.fr.8 apt-get.fr.8 apt-cdrom.fr.8 apt.conf.fr.5 \ + sources.list.fr.5 apt-config.fr.8 apt-sortpkgs.fr.1 \ + apt-ftparchive.fr.1 apt_preferences.fr.5 apt-extracttemplates.fr.1 \ + vendors.list.fr.5 INCLUDES = apt.ent.fr include $(SGML_MANPAGE_H) diff --git a/doc/fr/sources.list.fr.5.sgml b/doc/fr/sources.list.fr.5.sgml index e2c48079c..ed3deabf2 100644 --- a/doc/fr/sources.list.fr.5.sgml +++ b/doc/fr/sources.list.fr.5.sgml @@ -1,5 +1,5 @@ <!-- -*- mode: sgml; mode: fold -*- --> -<!-- translation of version 1.2 --> +<!-- translation of version 1.5 --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> @@ -26,15 +26,15 @@ La liste des ressources de paquets indique où trouver les archives du système de distribution de paquets utilisé. Pour l'instant, cette page de manuel ne documente que le système d'empaquetage utilisé par le système -Debian GNU-Linux. Ce fichier de contrôle est situé dans +Debian GNU/Linux. Ce fichier de contrôle est situé dans <filename>/etc/apt/sources.list</>. <para> La liste des sources est conçue pour prendre en compte un nombre quelconque -de sources actives et différents média source. Le fichier présente +de sources actives et différents média. Le fichier présente une source par ligne et la source préférée apparaît en premier. Le format de chaque ligne est : <literal/type uri args/. Le premier élément, <literal/type/, détermine le format des <literal/args/. <literal/uri/ est un -identificateur universel de ressources (URI), qui est un surensemble du plus +identificateur universel de ressources (URI), qui est un sur-ensemble du plus spécifique et bien connu repère universel de ressources, ou URL. La fin de la ligne peut être un commentaire commençant par un caractère #. </RefSect1> @@ -44,7 +44,7 @@ ligne peut Le type <literal/deb/ décrit une archive Debian classique à deux niveaux, <filename>distribution/composant</>. <literal/distribution/ peut prendre l'une des valeurs suivantes : <literal/stable/, <literal/unstable/, ou -<literal/testing/, et composant : <literal/main/, <literal/contrib/, +<literal/frozen/, et composant : <literal/main/, <literal/contrib/, <literal/non-free/, ou <literal/non-us/. Le type <literal/deb-src/ décrit le code source pour une distribution Debian dans le même format que le type <literal/deb/. Une ligne <literal/deb-src/ est nécessaire pour récupérer les @@ -67,15 +67,15 @@ pr qui sera remplacée par l'architecture Debian (i386, m68k, powerpc, ...) sur laquelle s'exécute le système. On peut ainsi utiliser un fichier <filename/sources.list/ qui ne dépend pas d'une architecture. En général, -ce n'est intéressant que si l'on indique un chemin exact ; sinon +ce n'est intéressant que si l'on indique un chemin exact ; sinon <literal/APT/ crée automatiquement un URI en fonction de l'architecture effective. <para> Puisqu'on ne peut indiquer qu'une seule distribution par ligne, il peut être nécessaire de disposer le même URI sur plusieurs lignes quand on veut accéder à un sous-ensemble des distributions ou composants disponibles à cette -adresse. APT trie les URIs après avoir crée pour lui-même la liste -complète ; il regroupe les références multiples au même hôte Internet +adresse. APT trie les URI après avoir crée pour lui-même la liste +complète ; il regroupe les références multiples au même hôte Internet en vue d'une connexion unique et il évite ainsi, par exemple, d'établir une connexion FTP, de la fermer, faire autre chose, puis d'établir encore cette connexion. Cette fonctionnalité permet l'accès à des sites FTP surchargés qui @@ -85,25 +85,25 @@ efficacement parti des sites <para> Il est important d'indiquer les sources par ordre de préférence, la source principale apparaissant en premier. Un tri est fait, de la plus -rapide à la plus lente ; par exemple, CD-ROM suivi par les hôtes d'un +rapide à la plus lente ; par exemple, CD-ROM suivi par les hôtes d'un réseau local, puis les hôtes Internet distants. <para> -Quelques exemples : +Voici quelques exemples : <literallayout> deb http://http.us.debian.org/debian stable main contrib non-free deb http://http.us.debian.org/debian dists/stable-updates/ </literallayout> </RefSect1> - <RefSect1><title>La spécification des URIs + La spécification des URI -Les URIs actuellement reconnus sont : cdrom, file, http et ftp. +Les URI actuellement reconnus sont : cdrom, file, http et ftp. file Le procédé cdrom @@ -126,7 +126,7 @@ m ftp Le procédé rshssh -Le procédé @@ -192,7 +192,7 @@ r unstable/binary-m68k pour les machines m68k et ainsi de suite pour les autres architectures supportées. [Notez que cet exemple montre seulement la manière d'utiliser la variable à substituer, non-us n'étant plus -structuré comme suit.] +structuré de cette manière.] deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/ diff --git a/doc/fr/vendors.list.fr.5.sgml b/doc/fr/vendors.list.fr.5.sgml new file mode 100644 index 000000000..a19aa0dc8 --- /dev/null +++ b/doc/fr/vendors.list.fr.5.sgml @@ -0,0 +1,104 @@ + + + +%aptent; + +]> + + + &apt-docinfo; + + + vendors.list + 5 + + + + + vendors.list + Configuration de la clé de sécurité pour APT + + + Description</> + <para> +La liste des distributeurs de paquets contient une liste de tous les +distributeurs +pour lesquels vous souhaitez authentifier les paquets que vous téléchargez. +Pour chaque distributeur, elle doit contenir l'empreinte de la clé PGP ; +ce qui permettra une vérification de la signature du fichier « release » et la +la vérification conséquente des sommes de contrôle des paquets téléchargés. +Pour cela, vous devez ajouter, dans une ligne du fichier sources.list, la +chaîne, enfermée dans des crochets, identifiant le distributeur +(voyez plus loin), et cela pour tous les miroirs du référentiel de ce +distributeur. + <para> +Le format de ce fichier est semblable au format du fichier apt.conf. C'est un +nombre quelconque de blocs concernant des distributeurs ; chaque bloc +commence +par une chaîne donnant la <replaceable/key_type/ et le <replaceable/vendor_id/. + <para> +Un distributeur peut avoir plusieurs blocs pour définir différentes règles +de sécurité pour différentes distributions. Par exemple, Debian utilise +des méthodes de signature différents pour les distributions stable et unstable. + <para> + <replaceable/key_type/ est le type de vérification requis. +Actuellement, il n'existe qu'un seul type disponible, à savoir + <literal/simple-key/. + <para> + <replaceable/vendor_id/ est la chaîne identifiant le distributeur. C'est +une chaîne quelconque que vous devez donner pour identifier de façon unique +un distributeur listé dans ce fichier. + + Exemple : +<informalexample><programlisting> +simple-key "joe" +{ + Fingerprint "0987AB4378FSD872343298787ACC"; + Name "Joe Shmoe <joe@shmoe.com>"; +} +</programlisting></informalexample> + + </RefSect1> + + <RefSect1><Title>Le type simple-key</> + <para> +Ce type de vérification est utilisé quand le distributeur possède une +seule clé servant à la signature du fichier « Release ». Les éléments +suivants doivent être présents : + + <VariableList> + <VarListEntry><Term>Fingerprint</Term> + <ListItem><Para> + L'empreinte PGP de la clé. L'empreinte sera notée de façon standard avec +ou sans espaces. L'option <option/--fingerprint/ pour + <CiteRefEntry><RefEntryTitle><command/gpg/</RefEntryTitle><ManVolNum/1/</CiteRefEntry> +affichera L'empreinte pour la (les) clé(s) sélectionné(e)s. + </VarListEntry> + + <VarListEntry><Term>Name</Term> + <ListItem><Para> +C'est une chaîne décrivant le propriétaire de la clé ou le distributeur. On +peut mettre le nom du distributeur et son adresse électronique. Cette chaîne +doit être mise entre des « " ». + </VarListEntry> + + </VariableList> + </RefSect1> + + <RefSect1><Title>Fichiers</> + <para> + <filename>/etc/apt/vendors.list</> + </RefSect1> + + <RefSect1><Title>Voir aussi</> + <para> + &sources-list; + </RefSect1> + + &manbugs; + &manauthor; + &traducteur; +</refentry> + -- cgit v1.2.3