[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

Les deux révisions précédentesRévision précédente
Prochaine révision		Révision précédente
fr:howtos:general_admin:searching_and_reading_manpages_efficiently [2015/09/14 15:28 (UTC)] – [Updating the ''whatis'' Database] traduction [fr] cedricfr: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 2013-01-06 mfillpot -->
 <!-- Page originale revue 2012-12-31 hazel --> <!-- 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). --> <!-- 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 ====== ====== 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 Les Manpages sont les pages du Manuel Unix en ligne. J'espère que ce Howto pourra en aider
Ligne 57: Ligne 56:
 Notez que certaines distributions Linux utilisent la commande ''mandb'' pour réaliser cette tâche. Notez que certaines distributions Linux utilisent la commande ''mandb'' pour réaliser cette tâche.
  
-===== Sections in the Manual ===== +===== Les Sections dans le Manual ===== 
-Don't confuse these sections with the sections within the structure of each + 
-manpage; they are described in the paragraph below.+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> <code>
 MANUAL SECTIONS  MANUAL SECTIONS 
Ligne 75: Ligne 76:
        8      System Administration tools and Daemons        8      System Administration tools and Daemons
 </code> </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> <code>
 user@darkstar$ apropos man   user@darkstar$ apropos man  
Ligne 90: Ligne 92:
 manuals with []      (7)  - mdoc  manuals with []      (7)  - mdoc 
 </code> </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> <code>
 user@darkstar$ man 7 man user@darkstar$ man 7 man
 </code> </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
-    * 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   * Synopsis
-    * A usage statement including a short list of the options+    * Condition d'utilisation et liste des options
   * Description   * Description
-    * A detailed explanation of the command+    * Une explication détaillée de la commande
   * Options   * Options
-    * Detailed explanation of the command line options for the command+    * Une explication détaillée des options de la ligne de commande
   * Bugs   * Bugs
-    * Known Bugs+    * Les problèmes connus
   * Author   * 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   * 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> <code>
  -h, --human-readable   -h, --human-readable 
Ligne 135: Ligne 133:
 </code> </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> <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 ====== ====== 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. --> <!-- Si vous copiez des informations depuis une autre source, veuillez l'indiquer. -->
 <!-- * Source originale : [[http://some.website.org/some/page.html]] --> <!-- * Source originale : [[http://some.website.org/some/page.html]] -->
Ligne 166: Ligne 167:
 <!-- Veuillez ne rien modifier dans la ligne ci-dessous, hormis ajouter de nouveaux mots-clés. --> <!-- 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. --> <!-- 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 :

fr:howtos:general_admin:searching_and_reading_manpages_efficiently ()