[2024-feb-29] Sad news: Eric Layton aka Nocturnal Slacker aka vtel57 passed away on Feb 26th, shortly after hospitalization. He was one of our Wiki's most prominent admins. He will be missed.

Welcome to the Slackware Documentation Project

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

--- fr:howtos:general_admin:searching_and_reading_manpages_efficiently [2015/09/11 00:37 (UTC)] – [How to Recherche et Lecture Efficace des Manpages] traduction [fr] cedric
+++ fr:howtos:general_admin:searching_and_reading_manpages_efficiently [2015/09/14 17:44 (UTC)] (Version actuelle) – traduction [fr] terminée - relecture nécessaire cedric
@@ Ligne 1: / Ligne 1: @@
 <!-- Page originale revue 2013-01-06 mfillpot -->
 <!-- Page originale revue 2012-12-31 hazel -->
+<!-- Première traduction fr 2015-09-14 cedric -->
 <!-- Ajouter votre texte ci-dessous. Il est fortement recommandé de commencer avec un Titre (voir la barre d'outils ci-dessus). -->
 ====== Comment Rechercher et Consulter Efficacement les Manpages ======
-<note warning>TRADUCTION en cours  --- //[[wiki:user:cedric|Cedric M.]] 2015/09/11 00:29//</note>
 Les Manpages sont les pages du Manuel Unix en ligne. J'espère que ce Howto pourra en aider
 quelques uns plus efficacement, même si je suis conscient que beaucoup de lecteurs sont déjà familiers avec ce sujet.
-===== Searching for a Manpage =====
+===== Recherche une Manpage =====
-In order to search for information about anything in the manpages you can
-use one of the following commands:
+Pour rechercher des informations sur quoi que ce soit dans les pages de manuel que vous pouvez
+utiliser l'une des commandes suivantes:
   * ''apropos''
   * ''man -k''
   * ''whatis''
-''apropos'' is only an alias for ''man -k''; there is no difference between
+''apropos'' est juste un alias pour ''man -k''; il n'y a aucune différence entre les deux. La différence entre ''whatis'' et les autres commandes est que ''whatis'' recherches les mots en entier alors que ''apropos'' (ou ''man -k'') recherche une partie du mot.
-them. The difference between ''whatis'' and the other commands is that
-''whatis'' searches for whole words whereas ''apropos'' (or ''man -k''
-respectively) searches for parts of strings.
-If you don't know how exactly a word, for example a command, is written, you
+Si vous ne savez pas exactement comment un mot, par exemple une commande, s'écrit, vous
-can use ''apropos''. If you know exactly the word to search for, ''whatis''
+pouvez utiliser '' à propos ''. Si vous connaissez l'orthographe exacte du mot à rechercher, '' whatis ''
-would be more efficient because it results in fewer lines of output.
+sera plus efficace car il retournera moins de lignes.
-=== Example ===
+=== Exemple ===
-Searching for information about DHCP:
+Rechercher des information sur DHCP:
-With the ''apropos'' command:
+Avec la commande ''apropos'' :
 <code>
 user@darkstar$ apropos dhcp
@@ Ligne 45: / Ligne 42: @@
 dnsmasq []           (8)  - A lightweight DHCP and caching DNS server
 </code>
-With the ''whatis'' command:
+Avec la commande ''whatis'' :
 <code>
 user@darkstar$ whatis dhcp
@@ Ligne 51: / Ligne 48: @@
 dhcp []              (5)  - options - Dynamic Host Configuration Protocol options
 </code>
-For both commands, the search is case-insensitive!
+Les deux commandes sont sensibles à la casse!
-===== Updating the ''whatis'' Database =====
+===== Mettre à Jour la Base de Données de ''whatis'' =====
-The ''whatis''command has its own database. The manpages for any packages of
-the stock Slackware installation are already present in the database. This
-is also true if you upgrade such packages. But if you build your own
-packages from source, for example from
-[[http://www.slackbuilds.org|SlackBuilds.org]], the manpages for these
-packages are not yet present in the ''whatis'' database. In order to update
-the database after installing new packages, Slackware provides the
-''makewhatis'' command. It has to be executed as root.
-Please note that some other distributions use the ''mandb'' command for this
+La commande ''whatis'' possède sa propre base de données. Les pages de manuel pour tous les paquets de l'installation par défaut de la Slackware sont déjà présents dans la base de données. C'est également vrai si vous mettez à niveau ces paquets. Mais si vous construisez vos propres paquets depuis les sources, par exemple à partir de [[http://www.slackbuilds.org | SlackBuilds.org]], les pages de manuel pour ceux-ci ne seront pas présents dans la base de données ''whatis''. Afin de mettre à jour la base de données après l'installation de ces nouveaux paquets, Slackware fournit la commande ''makewhatis''. Elle doit être exécuté en tant que root.
-purpose.
-===== Sections in the Manual =====
+Notez que certaines distributions Linux utilisent la commande ''mandb'' pour réaliser cette tâche.
-Don't confuse these sections with the sections within the structure of each
-manpage; they are described in the paragraph below.
+===== Les Sections dans le Manual =====
+Ne confondez pas ces sections avec les sections au sein de la structure de chaque
+page de manuel; ils sont décrits dans le paragraphe ci-dessous.
+Le manuel manpages est divisé en huit sections différentes. Voici un
+extrait de la page de manuel pour la commande ''man''.
-The manpages manual is divided into eight different sections. Here is an
-extract from the manpage for the ''man'' command.
 <code>
 MANUAL SECTIONS
@@ Ligne 84: / Ligne 76: @@
       System Administration tools and Daemons
 </code>
-If the manual pages for a topic are divided over different sections, one can
+Si les pages de manuel pour un sujet sont divisés en différentes sections, on peut
-pass the section number as an additional argument to the ''man'' command.
+passer le numéro de la section comme un argument supplémentaire à la commande ''man''.
-=== Example ===
+=== Exemple ===
 <code>
 user@darkstar$ apropos man
@@ Ligne 99: / Ligne 92: @@
 manuals with []      (7)  - mdoc
 </code>
-Now if you want to read the manpage about "macros to format man pages" in
+Maintenant, si vous voulez lire la manpages "macros to format man pages" de la section 7, vous devrez exécuter la commande suivante:
-section 7 you'll have to execute the following command:
 <code>
 user@darkstar$ man 7 man
 </code>
-===== The Structure of the Manpages =====
+===== Structure des Manpages =====
-The manpages all have (or should have) the same structure:
+Les manpages doivent toutes (ou devraient toute) avoir la même structure:
   * Name
-    * Name of the command and a short description of its function(s)
+    * Nom de la commande et brève description de sa(ses) fonction(s)
   * Synopsis
-    * A usage statement including a short list of the options
+    * Condition d'utilisation et liste des options
   * Description
-    * A detailed explanation of the command
+    * Une explication détaillée de la commande
   * Options
-    * Detailed explanation of the command line options for the command
+    * Une explication détaillée des options de la ligne de commande
   * Bugs
-    * Known Bugs
+    * Les problèmes connus
   * Author
-    * The author(s) of the package and maybe the author of the manpage
+    * L'auteur(s) du paquet et éventuelelment l'auteur de la manpage
   * See also
-    * Advice for manpages about similar or related programs
+    * Conseils de mapages à consulter sur les programmes similaires ou connexes
-If one searches for information about a subject rather than a single
+Si l'on recherche des informations sur un sujet plutôt qu'une commande, la ligne "see also" est très intéressant.
- command the "see also" line is very interesting.
-===== Searching within a Manpage =====
+===== Rechercher à l'Intérieur d'une Manpage =====
-The reader for the manpages is the program ''less''. Its keybindings are
-very similar to the vi editor.
-  * <key>'/'</key> searches the document forward
+Le lecteur pour les pages de manuel est le programme ''less''. Ses raccourcis clavier sont très similaire à l'éditeur vi.
-  * <key>'?'</key> searched the document backwards
-  * <key>'n'</key> the cursor jumps to the next match.
-The <key>Minus</key> key has no special meaning in the search patterns, so it is
+  * <key>'/'</key> recherche vers le bas
-possible to search (for example) for the -k option with ///-k//
+  * <key>'?'</key> recherche vers le haut
+  * <key>'n'</key> recherche l'occurence suivante.
-===Example===
+Le caractère <key>Minus</key> n'a pas de signification particulière dans le champ de recherche, il est donc possible de rechercher (par exemple) l'option -k avec ///-k//
-Searching for the //-h// option in the manpage for the ''ls'' command with
- //-h// gives us
+===Exemple===
+Rechercher l'option //-h// dans la manpage de la commande ''ls'' avec //-h// donne :
 <code>
  -h, --human-readable
@@ Ligne 144: / Ligne 133: @@
 </code>
-===== Navigation within a Manpage =====
+===== Parcourir le Contenu d'une Manpage =====
-Navigation commands are like those in vi:
+Les commandes de déplacement sont similaire à celles de vi:
-  * <key>'G'</key> end of the manpage
+  * <key>'G'</key> aller à la fin de la manpage
-  * <key>g</key>,<key>g</key> first line of the mapage
+  * <key>g</key>,<key>g</key> aller à la première ligne de la manpage
-  * //n//,<key>'G'</key> nth line of the manpage
+  * //n//,<key>'G'</key> aller à la nième ligne de la manpage
-One can also **set marks** at a line of the manpage
+On peut aussi **définir des repères** à une ligne de la manpage
-  * //<key>m</key>,a// sets mark a in the current line
+  * //<key>m</key>,a// définit un repère dans la ligne active
-  * //<key>'</key>, a// jumps to mark a in the manpage
+  * //<key>'</key>, a// saute au repère dans la manpage
-Unfortunately these marks are lost when you leave the manpage (which is
-done with <key>q</key>).
-===== Formatting a Manpage as a PDF-document =====
+Malheureusement, ces repères sont perdus lorsque vous quittez la manpage (ce qui se fait avec <key>q</key>).
-If you want to have a manpage as a PDF document you can use the command:
+===== Formater une Manpage en un Document PDF =====
+Si vous voulez avoir un document PDF d'une manpage, vous pouvez utiliser la commande:
 <code>man -t ls | ps2pdf - > ls-manpage.pdf</code>
-which formats the manpage for the ''ls'' command into a pdf document
+ceci qui formatera la manpage de la commande «ls '' dans un document pdf nommé "ls-manpage.pdf".
-named "ls-manpage.pdf".
+===== Lectures Complémentaires =====
+Pour plus d'informations, lisez la manpage pour la commande ''man'' et les manpages listées dans la section "see also".
-===== Further Reading =====
-For more information read the manpage for the ''man'' command and the
-manpages listed in "see also".
 ====== Sources ======
-  * Originally written by [[wiki:user:markush|Markus Hutmacher]]
+  * Initialement écrit par [[wiki:user:markush|Markus Hutmacher]]
+  * Traduit de l'anglais par [[wiki:user:cedric|Cedric M.]] //2015/09/14 17:40//
 <!-- Si vous copiez des informations depuis une autre source, veuillez l'indiquer. -->
 <!-- * Source originale : [[http://some.website.org/some/page.html]] -->
@@ Ligne 175: / Ligne 167: @@
 <!-- Veuillez ne rien modifier dans la ligne ci-dessous, hormis ajouter de nouveaux mots-clés. -->
 <!-- Vous devez supprimer le mot-clé "template" avant de sauvegarder cette nouvelle page. -->
-{{tag>translation_in_progress fr:howtos manpages searching documentation information author_markush translator_cedric }}
+{{tag>fr:howtos manpages searching documentation information author_markush translator_cedric }}

Piste :

Différences

Recherche

Navigation

Imprimer/exporter

Outils

SlackDocs

Slackware Links