[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
Prochaine révisionLes deux révisions suivantes
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:31 (UTC)] – [Navigation within a Manpage] traduction [fr] cedric
Ligne 57: Ligne 57:
 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 77:
        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 93:
 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 134:
 </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 
 + 
 +On peut aussi **définir des repères** à une ligne de la manpage 
 +  * //<key>m</key>,a// définit un repère dans la ligne active 
 +  * //<key>'</key>, a// saute au repère dans la manpage
  
-One can also **set marks** at a line of the manpage +Malheureusement, ces repères sont perdus lorsque vous quittez la manpage (ce qui se fait avec <key>q</key>).
-  * //<key>m</key>,a// sets mark a in the current line +
-  * //<key>'</key>, a// jumps to mark a in the 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 ===== ===== Formatting a Manpage as a PDF-document =====

Piste :

fr:howtos:general_admin:searching_and_reading_manpages_efficiently ()