diff options
Diffstat (limited to 'doc/fr')
-rw-r--r-- | doc/fr/apt-cache.fr.8.sgml | 120 | ||||
-rw-r--r-- | doc/fr/apt-cdrom.fr.8.sgml | 16 | ||||
-rw-r--r-- | doc/fr/apt-config.fr.8.sgml | 6 | ||||
-rw-r--r-- | doc/fr/apt-extracttemplates.fr.1.sgml | 6 | ||||
-rw-r--r-- | doc/fr/apt-ftparchive.fr.1.sgml | 149 | ||||
-rw-r--r-- | doc/fr/apt-get.fr.8.sgml | 492 | ||||
-rw-r--r-- | doc/fr/apt-sortpkgs.fr.1.sgml | 6 | ||||
-rw-r--r-- | doc/fr/apt.conf.fr.5.sgml | 176 | ||||
-rw-r--r-- | doc/fr/apt.ent.fr | 22 | ||||
-rw-r--r-- | doc/fr/apt_preferences.fr.5.sgml | 744 | ||||
-rw-r--r-- | doc/fr/makefile | 8 | ||||
-rw-r--r-- | doc/fr/sources.list.fr.5.sgml | 34 | ||||
-rw-r--r-- | doc/fr/vendors.list.fr.5.sgml | 104 |
13 files changed, 1431 insertions, 452 deletions
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 @@ <!-- -*- mode: sgml; mode: fold -*- --> -<!-- translation of version 1.4 --> +<!-- translation of version 1.10 --> <!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ <!ENTITY % aptent SYSTEM "apt.ent.fr"> @@ -31,17 +31,19 @@ <group choice=req> <arg>add <arg choice="plain" rep="repeat"><replaceable>fichier</replaceable></arg></arg> <arg>gencaches</> - <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> + <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> + <arg>showsrc <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>stats</> <arg>dump</> <arg>dumpavail</> <arg>unmet</> <arg>search <arg choice="plain"><replaceable>regex</replaceable></arg></arg> - <arg>show <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> - <arg>depends <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> + <arg>show <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> + <arg>showpkg <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> + <arg>depends <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> <arg>pkgnames <arg choice="plain"><replaceable>prefix</replaceable></arg></arg> - <arg>dotty <arg choice="plain" rep="repeat"><replaceable>pkg</replaceable></arg></arg> + <arg>dotty <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg> + <arg>policy <arg choice="plain" rep="repeat"><replaceable>paquets</replaceable></arg></arg> </group> </cmdsynopsis> </refsynopsisdiv> @@ -60,15 +62,15 @@ des commandes suivantes doit �tre pr�sente. <VariableList> <VarListEntry><Term>add</Term> <ListItem><Para> -La commande <literal/add/ ajoute les fichiers donn�s en argument au cache des -paquets. +La commande <literal/add/ ajoute des fichiers indexant des paquets au cache des +paquets. Cela sert uniquement pour le d�bogage. </VarListEntry> <VarListEntry><Term>gencaches</Term> <ListItem><Para> La commande <literal/gencaches/ fait la m�me chose que -<command/apt-get check/. Elle construit les caches de source et de paquet � -partir des sources r�pertori�es dans &sources-list; et dans +<command/apt-get check/. Elle construit les caches des sources et des paquets +� partir des sources r�pertori�es dans &sources-list; et dans <filename>/var/lib/dpkg/status</>. </VarListEntry> @@ -77,8 +79,9 @@ partir des sources r�pertori�es dans &sources-list; et dans La commande <literal/showpkg/ affiche des informations sur les paquets donn�s en argument. Les arguments restants sont les noms de paquets. Les versions disponibles et les d�pendances inverses de chaque paquet r�pertori� sont -list�es, ainsi que les d�pendances normales pour chaque version. Les d�pendances -normales d'un paquet sont constitu�es par les paquets dont il d�pend ; les +list�es, ainsi que les d�pendances normales pour chaque version. Les +d�pendances normales d'un paquet sont constitu�es par les paquets dont il +d�pend ; les d�pendances inverses sont les paquets qui d�pendent du paquet en question. Les d�pendances normales doivent donc �tre satisfaites et les d�pendances inverses n'ont pas besoin de l'�tre. Ainsi, la commande @@ -99,11 +102,12 @@ Reverse Provides: <para> 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. </VarListEntry> <VarListEntry><Term>stats</Term> @@ -116,33 +120,34 @@ autre argument n'est attendu. Voici les informations rapport�es : </listitem> <listitem><para> -<literal/Normal packages/ est le nombre de paquets simples, ordinaires ; ces -paquets tol�rent une correspondance bijective entre leur nom et le nom utilis� -par d'autres paquets pour les qualifier comme d�pendance. La majorit� des -paquets appartient � cette cat�gorie. +<literal/Normal packages/ est le nombre de paquets simples, +ordinaires ; ces paquets tol�rent une correspondance bijective entre +leur nom et le nom utilis� par les autres paquets pour les qualifier comme +d�pendance. La majorit� des paquets appartient � cette cat�gorie. </listitem> <listitem><para> <literal/Pure virtual packages/ est le nombre des paquets qui n'existent que -sous la forme d'un nom repr�sentant un paquet virtuel ; ces paquets +sous la forme d'un nom repr�sentant un paquet virtuel ; ces paquets � fournissent � seulement un nom de paquet virtuel et aucun paquet n'utilise v�ritablement ce nom. Par exemple, au sein du syst�me Debian -GNU-Linux, le nom � mail-transport-agent � est un paquet virtuel pur ; -plusieurs paquets peuvent � remplir � ce nom � mail-transport-agent �, mais il +GNU/Linux, le nom � mail-transport-agent � est un paquet virtuel +pur ; plusieurs paquets peuvent � remplir � ce nom +� mail-transport-agent �, mais il n'existe aucun paquet nomm� � mail-transport-agent �. </listitem> <listitem><para> <literal/Single virtual packages/ est le nombre de paquets virtuels qui ne peuvent �tre remplis que par un seul paquet. Par exemple, au sein du syst�me -Debian GNU-Linux, � X11-text-viewer � est un paquet virtuel ; seul le paquet -� xless � remplit � X11-text-viewer �. +Debian GNU/Linux, � X11-text-viewer � est un paquet virtuel ; +seul le paquet � xless � remplit � X11-text-viewer �. </listitem> <listitem><para> <literal/Mixed virtual packages/ est le nombre des paquets qui remplissent un -paquet virtuel particulier et/ou dont le nom est un nom de paquet virtuel. -Par exemple, au sein du syst�me Debian GNU-Linux, � debconf � est +paquet virtuel particulier ou dont le nom est un nom de paquet virtuel. +Par exemple, au sein du syst�me Debian GNU/Linux, � debconf � est un paquet r�el et il est aussi rempli par � debconf-tiny �. </listitem> @@ -150,16 +155,16 @@ un paquet r�el et il est aussi rempli par � debconf-tiny �. <literal/Missing/ est le nombre de paquets r�f�renc�s dans une d�pendance mais qui ne sont fournis par aucun paquet. Les paquets manquants peuvent �tre mis en �vidence quand on n'acc�de pas � une distribution compl�te -ou si un paquet (r�el ou virtuel) a �t� abandonn� par une distribution. +ou si un paquet (r�el ou virtuel) a �t� sorti d'une distribution. Habituellement on les trouve dans les champs � Conflicts �. </listitem> <listitem><para> <literal/Total distinct/ versions est le nombre de versions de paquets trouv�es -dans le cache ; cette valeur est par cons�quent au moins �gale au nombre total -de paquets. Quand on acc�de � plus d'une distribution (� stable � et -� unstable �, par exemple), cette valeur peut �tre consid�rablement plus -grande que le nombre total de paquets. +dans le cache ; cette valeur est par cons�quent au moins �gale au +nombre total de paquets. Quand on acc�de � plus d'une distribution +(� stable � et � unstable �, par exemple), cette valeur +peut �tre consid�rablement plus grande que le nombre total de paquets. </listitem> <listitem><para> @@ -168,6 +173,14 @@ d�clar�es par tous les paquets pr�sents dans le cache. </listitem> </itemizedlist> </VarListEntry> + + <VarListEntry><Term>showsrc</Term> + <ListItem><Para> + <literal/showsrc/ affiche toutes les entr�es de paquet-source qui +correspondent aux noms donn�s. Toutes les versions sont affich�es et toutes +les entr�es qui d�clarent que ces noms correspondent � des paquets binaires. + </VarListEntry> + <VarListEntry><Term>dump</Term> <ListItem><Para> @@ -190,7 +203,7 @@ d�pendances absentes dans le cache de paquets. <VarListEntry><Term>show</Term> <ListItem><Para> -La commande <literal/show/ est semblable � <literal/dpkg --print-avail/ ; +La commande <literal/show/ est semblable � <literal/dpkg --print-avail/ ; elle affiche des informations sur les paquets donn�s en argument. </VarListEntry> @@ -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 <option/--full/, la sortie est identique � <literal/show/ pour chaque -paquet ; l'option <option/--names-only/ ne recherche pas la cha�ne +paquet ; l'option <option/--names-only/ ne recherche pas la cha�ne dans les descriptions longues mais seulement dans les noms de paquets. <para> On peut utiliser des arguments distincts pour indiquer des expressions @@ -219,8 +232,8 @@ d�pendances. <ListItem><Para> Cette commande affiche le nom de chaque paquet du syst�me. Un pr�fixe pour filtrer la liste des noms peut �tre donn� en argument. La sortie est -appropri�e � une utilisation au sein d'une fonction compl�te de shell ; elle -est produite tr�s rapidement. On utilise au mieux cette commande avec +appropri�e � une utilisation au sein d'une fonction compl�te de shell ; +elle est produite tr�s rapidement. On utilise au mieux cette commande avec l'option <option/--generate/. </VarListEntry> @@ -228,7 +241,7 @@ l'option <option/--generate/. <ListItem><Para> La commande <literal/dotty/ prend une liste de paquets sur la ligne de commande et affiche une sortie appropri�e � une utilisation par dotty avec le paquet -<ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphVis</>. +<ulink url="http://www.research.att.com/sw/tools/graphviz/">GraphViz</>. Il en r�sulte un ensemble de noeuds et d'arcs repr�sentant les relations entre les paquets. Par d�faut les paquets donn�s en argument suivent toutes leurs d�pendances, ce qui peut produire un graphe tr�s volumineux. On peut @@ -236,7 +249,7 @@ d�sactiver ce comportement en positionnant l'option <literal>APT::Cache::GivenOnly</literal>. </para> <para> -Les noeuds r�sultants ont plusieurs formes ; les paquets normaux sont +Les noeuds r�sultants ont plusieurs formes ; les paquets normaux sont des bo�tes, les � provides � purs sont des triangles, les � provides � mixtes sont des diamants et les paquets manquants sont des hexagones. Les bo�tes oranges expriment un arr�t de la r�cursivit� @@ -247,7 +260,16 @@ lignes vertes repr�sentent des conflits. Attention, dotty ne peut pas repr�senter des ensembles de paquets plus volumineux. </VarListEntry> - </VariableList> + + <VarListEntry><Term>policy</Term> + <ListItem><Para> + <literal/policy/ sert � d�boguer des probl�mes relatifs au fichier des +pr�f�rences. Sans argument, la commande affiche la priorit� de chaque source. +Sinon, elle affiche des informations pr�cises sur la priorit� du paquet donn� +en argument. + </VarListEntry> + + </VariableList> </RefSect1> <RefSect1><Title>Options</> @@ -264,26 +286,26 @@ le cache primaire utilis� par toutes les op�rations. <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�cimal 100 en cas d'erreur. &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 � l'utilisateur. <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�alablement utilis� ce disque et n'a trouv� aucune erreur. <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�r�s. <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�der aux sources des distributions. Un index doit <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 �tre pr�sente : <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�c�d�s de chemins relatifs d�finis dans les sections suivantes de mani�re <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�trage par section). <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 � .deb �. Par d�faut, c'est <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 � Packages � cr�e. Par d�faut, c'est <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�fix�s par le r�pertoire de l'archive. <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� et le responsable de paquet. <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�trage de <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�e, la valeur de new remplace la valeur du champ. La deuxi�me forme 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 �tre d�sactiv�e avec l'option <option/--no-delink/. <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�ation de fichiers � Contents �. Par d�faut, elle est activ�e. <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 � quoi devrait ressembler le fichier de configuration. <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�installer. <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 � vos risques et p�rils. <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�tres. <para> Trois options de configuration sont fournies pour le contr�le des caches qui sont compatibles avec HTTP/1.1. <literal/No-Cache/ signifie que le mandataire -ne doit pas du tout utiliser les r�ponses qu'il a stock�es ; <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 � cause de son peu d'efficacit�. <para> L'option <literal/ForceExtended/ contr�le l'utilisation des commandes li�es � la RFC 2428, <literal/EPSV/ et <literal/EPRT/. Par d�faut, elle vaut -� 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 �tre sp�cifi�es en utilisant <literal/UMount/. <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�lent le comportement par d�faut. On les trouve dans la section <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� dans la phase de mise � jour. <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��s. <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 ?</Title> + +<para>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 : + +<variablelist> +<varlistentry><term>P > 1000</term> +<listitem><simpara>Cette priorit� entra�ne l'installation du paquet m�me s'il +s'agit d'un retour en arri�re. +</simpara></listitem> +</varlistentry> +<varlistentry><term>990 < P <=1000</term> +<listitem><simpara>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. +</simpara></listitem> +</varlistentry> +<varlistentry><term>500 < P <=990</term> +<listitem><simpara>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. +</simpara></listitem> +</varlistentry> +<varlistentry><term>100 < P <=500</term> +<listitem><simpara>L'exemplaire sera install�, sauf s'il existe un exemplaire +appartenant � une autre distribution ou si la version install�e est plus +r�cente. +</simpara></listitem> +<varlistentry><term>0 <= P <=100</term> +<listitem><simpara> L'exemplaire sera install� si aucun exemplaire du paquet +n'est install�. +</simpara></listitem> +</varlistentry> +<varlistentry><term>P < 0</term> +<listitem><simpara>Cette priorit� emp�che l'installation de l'exemplaire. +</simpara></listitem> +</varlistentry> +</variablelist> +</para> + +<para>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�. +</para> + +<para>Supposons par exemple que le fichier des pr�f�rences contienne les trois +entr�es d�crites plus haut : + +<programlisting> +Package: perl +Pin: version 5.8* +Pin-Priority: 1001 + +Package: * +Pin: origin "" +Pin-Priority: 999 + +Package: * +Pin: release unstable +Pin-Priority: 50 +</programlisting> + +Alors : + +<itemizedlist> +<listitem><simpara> La version la plus r�cente du paquet <literal/perl/ sera +install� pour autant que son num�ro de version commence par <literal/5.8/. +Si l'<emphasis/une/ des versions 5.8* existe et si la version install�e est +une version 5.9*, il y aura un retour en arri�re. +</simpara></listitem> +<listitem><simpara>Les exemplaires des paquets (autres que <literal/perl/) +disponibles dans le site local ont priorit� sur les autres exemplaires, +m�me ceux appartenant � la distribution par d�faut. +</simpara></listitem> +<listitem><simpara> 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 <literal/unstable/, ne sera install� que si aucun exemplaire +du paquet n'est d�j� install�. +</simpara></listitem> +</itemizedlist> +</para> +</RefSect2> + +<RefSect2><Title>D�termination de la version des paquets et des propri�t�s des +distributions</Title> + +<para>Chaque source list�e dans le fichier &sources-list; doit fournir +les fichiers <filename>Packages</filename> et <filename>Release</filename> +qui d�crivent les exemplaires des paquets disponibles � cet endroit. +</para> + +<para>Le fichier <filename>Packages</filename> se trouve normalement dans le +r�pertoire +<filename>.../dists/<replaceable>dist-name</replaceable>/<replaceable>component</replaceable>/<replaceable>arch</replaceable></filename>, par exemple, +<filename>.../dists/stable/main/binary-i386/Packages</filename>. 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 : +<variablelist> +<varlistentry> +<term>La ligne <literal/Package:/ </term> +<listitem><simpara>donne le nom du paquet</simpara></listitem> +</varlistentry> +<varlistentry> +<term>La ligne <literal/Version:/ </term> +<listitem><simpara>donne le num�ro de version du paquet</simpara></listitem> +</varlistentry> +</variablelist> +</para> + +<para> Le fichier <filename>Release</filename> se trouve normalement dans le +r�pertoire +<filename>.../dists/<replaceable>dist-name</replaceable></filename>, par exemple, <filename>.../dists/stable/Release</filename>, ou <filename>.../dists/woody/Release</filename>. +Il consiste en une seule entr�e compos�e de plusieurs lignes qui s'applique � +<emphasis/tous/ les exemplaires des paquets situ�s dans les r�pertoires sous +le r�pertoire parent. Contrairement au fichier <filename/Packages/, presque +toutes les lignes du fichier <filename/Release/ sont pertinentes pour +d�terminer les priorit�s : +<variablelist> +<varlistentry> +<term>La ligne <literal/Archive:/ </term> +<listitem><simpara>nomme l'archive � laquelle appartiennent tous les +exemplaires des paquets situ�s dans les r�pertoires. Par exemple, la ligne +<literal/Archive: stable/ indique que tous les paquets dans les r�pertoires +situ�s sous le r�pertoire parent du fichier <filename/Release/ appartiennent +� l'archive <literal/stable/. Indiquer cette valeur dans le fichier des +pr�f�rences demanderait cette ligne : +</simpara> + +<programlisting> +Pin: release a=stable +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> +<term>La ligne <literal/Version:/ </term> +<listitem><simpara>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 : +</simpara> + +<programlisting> +Pin: release v=3.0 +Pin: release a=stable v=3.0 +Pin: release 3.0 +</programlisting> + +</listitem> +</varlistentry> + +<varlistentry> +<term>La ligne <literal/Component:/</term> +<listitem><simpara>nomme un composant qui indique le type de licence associ� +aux exemplaires situ�s dans les r�pertoires sous le fichier +<filename/Release/. Par exemple, la ligne <literal/Component: main/ indique +que tous les exemplaires dans les r�pertoires appartiennent au composant +<literal/main/, c'est-�-dire que leur licence est en accord avec les +Directives Debian pour le logiciel libre. Indiquer ce composant dans le +fichier des pr�f�rences demanderait cette ligne : +</simpara> + +<programlisting> +Pin: release c=main +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> +<term>La ligne <literal/Origin:/ </term> +<listitem><simpara>nomme le producteur des exemplaires des paquets situ�s +dans les r�pertoires sous le fichier <filename/Release/. En g�n�ral, c'est +<literal/Debian/. Indiquer cette origine dans le fichier des pr�f�rences +demanderait cette ligne : +</simpara> + +<programlisting> +Pin: release o=Debian +</programlisting> +</listitem> +</varlistentry> + +<varlistentry> +<term>La ligne <literal/Label:/ </term> +<listitem><simpara>semble redondante. En g�n�ral, c'est +<literal/Debian/. Indiquer cette origine dans le fichier des pr�f�rences +demanderait cette ligne : +</simpara> + +<programlisting> +Pin: release l=Debian +</programlisting> +</listitem> +</varlistentry> +</variablelist> +</para> + +<para>Tous les fichiers <filename>Packages</filename> et +<filename>Release</filename> r�cup�r�s dans des sources list�es par le +fichier &sources-list; sont conserv�s dans le r�pertoire +<filename>/var/lib/apt/lists</filename> ou dans le fichier sp�cifi� par la +variable <literal/Dir::State::Lists/ dans le fichier <filename/apt.conf/. +Par exemple, le fichier +<filename>debian.lcs.mit.edu_debian_dists_unstable_contrib_binary-i386_Release</filename> contient le fichier <filename>Release</filename> du site +<literal/debian.lcs.mit.edu/, architecture <literal/binary-i386/ et +composant <literal/contrib/ de la distribution <literal/unstable/. +</para> + +</RefSect2> + +<RefSect2><Title>Lignes facultatives dans le fichier des pr�f�rences</Title> + +<para>Toute entr�e du fichier des pr�f�rences peut commencer par une ou +plusieurs lignes contenant le mot <literal/Explanation:/. Cela permet de +commenter l'entr�e. +</para> + +<para>La ligne <literal/Pin-Priority:/ d'une entr�e est facultative. Si elle +n'existe pas, APT affecte une priorit� inf�rieure de 1 � la valeur sp�cifi�e +sur une ligne commen�ant par <literal/Pin-Priority: release .../. +</para> +</RefSect2> +</RefSect1> + +<RefSect1><Title>Exemples</> +<RefSect2><Title>Comment suivre Stable ?</Title> + +<para>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 <literal/stable/ et une priorit� prohibitivement basse � tous +les exemplaires appartenant � d'autres distributions <literal/Debian/. + +<programlisting> +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 +</programlisting> +</para> + +<para>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 <literal/stable/ pour faire la mise � niveau : + +<programlisting> +apt-get install <replaceable>paquet</replaceable> +apt-get upgrade +apt-get dist-upgrade +</programlisting> +</para> + +<para>La commande suivante utilisera la version la plus r�cente de la +distribution <literal/testing/ pour mettre � niveau le paquet sp�cifi� ; +cependant les mises � niveau ult�rieures ne se feront pas automatiquement. + +<programlisting> +apt-get install <replaceable>paquet</replaceable>/testing +</programlisting> +</RefSect2> + + <RefSect2><Title>Comment suivre Testing ?</Title> + +<para>Le fichier des pr�f�rences suivant affecte une priorit� haute aux +versions des paquets appartenant � la distribution <literal/testing/, une +priorit� moindre aux versions appartenant � la distribution <literal/unstable/ +et une priorit� prohibitivement basse aux versions appartenant � d'autres +distributions <literal/Debian/. + +<programlisting> +Package: * +Pin: release a=testing +Pin-Priority: 900 + +Package: * +Pin: release a=unstable +Pin-Priority: 800 + +Package: * +Pin: release o=Debian +Pin-Priority: -10 +</programlisting> +</para> + +<para>Avec le fichier des pr�f�rences ci-dessus, les commandes suivantes +utiliseront les versions les plus r�centes de <literal/testing/ pour faire +la mise � niveau : + +<programlisting> +apt-get install <replaceable>paquet</replaceable> +apt-get upgrade +apt-get dist-upgrade +</programlisting> +</para> + +<para>La commande suivante utilisera la version la plus r�cente de la +distribution <literal/unstable/ pour mettre � niveau le paquet sp�cifi� ; +Par la suite, <command>apt-get dist-upgrade</command> et les autres +commandes <emphasis/utiliseront/ les versions les plus r�centes de +<literal/unstable/ pour mettre � niveau le paquet. + +<programlisting> +apt-get install <replaceable>paquet</replaceable>/unstable +</programlisting> +</para> + +</RefSect2> +</RefSect1> + + <RefSect1><Title>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 �tre un commentaire commen�ant par un caract�re #. 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�sent. 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 � faible bande passante. <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</title> + <RefSect1><title>La sp�cification des URI</title> <para> -Les URIs actuellement reconnus sont : cdrom, file, http et ftp. +Les URI actuellement reconnus sont : cdrom, file, http et ftp. <VariableList> <VarListEntry><term>file</term> <ListItem><Para> Le proc�d� <literal/file/ permet qu'un r�pertoire arbitraire au sein du syst�me de fichier soit consid�r� comme une archive. On s'en sert avec les -montages NFS, les miroirs et archives locaux. +montages NFS, les miroirs et les archives locaux. </VarListEntry> <VarListEntry><term>cdrom</term> @@ -126,7 +126,7 @@ m�thode d'authentification peu s�re. <VarListEntry><term>ftp</term> <ListItem><Para> Le proc�d� <literal/ftp/ indique un serveur FTP comme archive. Le -fonctionnement en mode ftp est grandement configurable ; r�f�rez-vous +fonctionnement en mode ftp est grandement configurable ; r�f�rez-vous � la page de manuel de &apt-conf; pour davantage de renseignements. On remarquera qu'on peut indiquer un mandataire ftp avec la variable d'environnement <EnVar/ftp_proxy/. On peut aussi sp�cifier un mandataire http @@ -145,12 +145,12 @@ disque zip pour recopier des fichiers un peu partout via APT. <VarListEntry><term>rsh</term><term>ssh</term> <ListItem><Para> -Le proc�d� <literal/rsh/ssh/ utilise rsh/ssh pour se connecter � une +Le proc�d� rsh/ssh utilise rsh/ssh pour se connecter � une machine distante en tant que tel utilisateur donn� et pour acc�der aux fichiers. Aucune authentification par mot de passe n'est possible : il faut au pr�alable r�gler ce probl�me avec des cl�s RSA ou bien rhosts. Pour l'acc�s aux fichiers de la machine distante et le transfert, on utilise les -commandes standards <command/find/ et <command/dd/. +commandes standard <command/find/ et <command/dd/. </VarListEntry> </VariableList> </RefSect1> @@ -192,7 +192,7 @@ r�pertoire debian-non-US, et n'utiliser que les fichiers trouv�s dans <filename>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.] <literallayout>deb http://ftp.de.debian.org/debian-non-US unstable/binary-$(ARCH)/</literallayout> </RefSect1> 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 @@ +<!-- -*- mode: sgml; mode: fold -*- --> +<!-- translation of version 1.2 --> +<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [ + +<!ENTITY % aptent SYSTEM "apt.ent.fr"> +%aptent; + +]> + +<refentry lang=fr> + &apt-docinfo; + + <refmeta> + <refentrytitle>vendors.list</> + <manvolnum>5</> + </refmeta> + + <!-- Man page title --> + <refnamediv> + <refname>vendors.list</> + <refpurpose>Configuration de la cl� de s�curit� pour APT</> + </refnamediv> + + <RefSect1><Title>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> + |