[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:26 (UTC)] – [Searching 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 
 + 
 +Si l'on recherche des informations sur un sujet plutôt qu'une commande, la ligne "see also" est très intéressant.
  
-If one searches for information about a subject rather than a single +===== Rechercher à l'Intérieur d'une Manpage =====
- command the "see also" line is very interesting.+
  
-===== Searching within a Manpage ===== +Le lecteur pour les pages de manuel est le programme ''less''. Ses raccourcis clavier sont très similaire à l'éditeur vi.
-The reader for the manpages is the program ''less''. Its keybindings are +
-very similar to the vi editor.+
  
-  * <key>'/'</key> searches the document forward +  * <key>'/'</key> recherche vers le bas 
-  * <key>'?'</key> searched the document backwards +  * <key>'?'</key> recherche vers le haut 
-  * <key>'n'</key> the cursor jumps to the next match.+  * <key>'n'</key> recherche l'occurence suivante.
  
-The <key>Minus</key> key has no special meaning in the search patterns, so it is +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//
-possible to search (for example) for the -k option with ///-k//+
  
-===Example=== +===Exemple=== 
-Searching for the //-h// option in the manpage for the ''ls'' command with +Rechercher l'option //-h// dans la manpage de la commande ''ls'' avec //-h// donne :
- //-h// gives us+
 <code> <code>
  -h, --human-readable   -h, --human-readable 

Piste :

fr:howtos:general_admin:searching_and_reading_manpages_efficiently ()