<!-- -*- mode: sgml; mode: fold -*- -->
-<!-- translation of version 1.4 -->
+<!-- translation of version 1.17 -->
<!doctype refentry PUBLIC "-//OASIS//DTD DocBook V3.1//EN" [
<!ENTITY % aptent SYSTEM "apt.ent.fr">
]>
-<refentry lang=fr>
+<refentry lang="fr">
&apt-docinfo;
<refmeta>
<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>depends <arg choice="plain" rep="repeat"><replaceable>paquet</replaceable></arg></arg>
+ <arg>rdepends <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>
+ <arg>madison <arg choice="plain" rep="repeat"><replaceable>paquets</replaceable></arg></arg>
</group>
</cmdsynopsis>
</refsynopsisdiv>
des commandes suivantes doit être présente.
<VariableList>
- <VarListEntry><Term>add</Term>
+ <VarListEntry><Term>add <replaceable/fichier(s)/</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>
- <VarListEntry><Term>showpkg</Term>
+ <VarListEntry><Term>showpkg <replaceable/paquet(s)/</Term>
<ListItem><Para>
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
<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 et 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>
</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
-un paquet réel et il est aussi rempli par « debconf-tiny ».
+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 fourni par « debconf-tiny ».
</listitem>
<listitem><para>
<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>
</listitem>
</itemizedlist>
</VarListEntry>
+
+ <VarListEntry><Term>showsrc <replaceable/paquet(s)/</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>
dépendances absentes dans le cache de paquets.
</VarListEntry>
- <VarListEntry><Term>show</Term>
+ <VarListEntry><Term>show <replaceable/paquet(s)/</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>
- <VarListEntry><Term>search</Term>
+ <VarListEntry><Term>search <replaceable/regex [ regex ... ]/</Term>
<ListItem><Para>
La commande <literal/search/ recherche l'expression régulière donnée en
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
régulières différentes sur lesquelles sera réalisé un « et » logique.
</VarListEntry>
- <VarListEntry><Term>depends</Term>
+ <VarListEntry><Term>depends <replaceable/paquet(s)/</Term>
<ListItem><Para>
La commande <literal/depends/ affiche la liste de toutes les dépendances
d'un paquet et la liste de tous les paquets possibles qui satisfont ces
dépendances.
</VarListEntry>
- <VarListEntry><Term>pkgnames</Term>
+ <VarListEntry><Term>rdepends <replaceable/paquet(s)/</Term>
+ <ListItem><Para>
+La commande <literal/rdepends/ affiche la liste de toutes les dépendances inverses
+d'un paquet.
+ </VarListEntry>
+
+ <VarListEntry><Term>pkgnames <replaceable/[ prefix ]/ </Term>
<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>
- <VarListEntry><Term>dotty</Term>
+ <VarListEntry><Term>dotty <replaceable/paquet(s)/</Term>
<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
-désactiver ce comportement en positionnant l'option
-<literal>APT::Cache::GivenOnly</literal>.
+leurs dépendances, ce qui peut produire un graphe très volumineux.
+Pour limiter la sortie aux paquets listés sur la ligne de commande, positionnez
+l'option <literal>APT::Cache::GivenOnly</>.
</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é
Attention, dotty ne peut pas représenter des ensembles de paquets
plus volumineux.
</VarListEntry>
- </VariableList>
+
+ <VarListEntry><Term>policy <replaceable/[ paquet(s) ]/</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>
+
+ <VarListEntry><Term>madison <replaceable/[ paquet(s) ]/</Term>
+ <ListItem><Para>
+
+ La commande <literal/madison/ d'<literal/apt-cache/ cherche à mimer le
+format de sortie propre à l'outil debian de gestion d'archives,
+<literal/madison/, ainsi qu'une part de ses fonctionnalités. Elle affiche les
+versions disponibles d'un paquet dans un tableau. Contrairement au programme
+original <literal/madison/, elle n'affiche que des informations qui cocernent
+l'architecture pour laquelle Apt a lu la liste des paquets disponibles
+(<literal/APT::Architecture/).
+ </VarListEntry>
+
+ </VariableList>
</RefSect1>
<RefSect1><Title>Options</>
<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>
<VarListEntry><term><option/-a/</><term><option/--all-versions/</>
<ListItem><Para>
Affiche la totalité des champs d'information pour toutes les versions
-disponibles : cette option concerne seulement la commande show.
+disponibles : c'est la valeur par défaut. Pour la désactiver, utilisez
+l'option <option/--no-all-versions/. Quand l'option <option/--no-all-versions/
+est choisie, seuls les éléments de la version choisie (celle qui serait
+installée) seront affichés.
+Ctte option concerne seulement la commande <literal/show/.
Élément de configuration : <literal/APT::Cache::AllVersions/.
</VarListEntry>
Élément de configuration : <literal/APT::Cache::Generate/.
</VarListEntry>
- <VarListEntry><term><option/--names-only/</>
+ <VarListEntry><term><option/--names-only/</><term><option/-n/</>
<ListItem><Para>
-N'effectue une recherche que sur les noms de paquets et non sur les
+N'effectue une recherche que sur les noms de paquets et pas sur les
descriptions longues.
Élément de configuration : <literal/APT::Cache::NamesOnly/.
</VarListEntry>
<VarListEntry><term><option/--recurse/</>
<ListItem><Para>
-Avec cette option <literal/depends/ est récursive de manière à n'afficher
-qu'une seule fois les paquets mentionnés.
+Avec cette option <literal/depends/ et <literal/rdepends/ sont récursives de
+manière à n'afficher qu'une seule fois les paquets mentionnés.
Élément de configuration : <literal/APT::Cache::RecurseDepends/.
</VarListEntry>
+ <VarListEntry><term><option/--installed/</>
+ <ListItem><Para>
+Cette option limite la sortie de <literal/depends/ et de <literal/rdepends/
+aux paquets qui sont actuellement installés.
+Élément de configuration : <literal/APT::Cache::Installed/.
+ </VarListEntry>
+
&apt-commonoptions;
</VariableList>
&manbugs;
&manauthor;
&deux-traducteurs;
-</refentry>
\ No newline at end of file
+</refentry>
projects / apt.git / blobdiff