Man page/Navigate/fr

Ce guide vous explique comment naviguer dans les pages de manuel en utilisant man.

Le programme man
Chacun, à un certain stade de sa vie avec Linux l'a utilisé. Il s'agit de la commande man. Néanmoins, bien que le programme man lui-même soit assez simple dans sa structure, il dispose de quelques fonctionnalités autres que celle de simplement faire défiler une page. Ce document espère apporter un peu de lumière sur ces fonctionnalités.

Arrangement de Man
Les pages de manuel sont stockées principalement dans le répertoire. Cependant, tant que lemplacement d'une page de manuel est listé dans la variable d'environnement, man est capable de la retrouver. Gentoo stocke généralement les variables  dans. Dans ces répertoires, il existe quelques dossiers intitulés manX, ou X est le numéro de section. Par exemple, un arrangement standard de man ressemble à ceci :

La numérotation réelle des sections semble être tout à fait standard. Néanmoins, notez qu'il y a un dossier  et quelques  dossiers. La table suivante présente les répertoires de pages de manuel ci-dessus et ce qu'ils contiennent :

Bien que cela ne soit pas une liste détaillée et exhaustive, elle couvre les pages de manuel qui intéressent la plupart des gens. Cependant, dans certains cas, vous pouvez savoir ce qu'une section présente aussi aisément que de consulter cette table. Le prochain chapitre vous montrera comment parcourir cet arrangement.

Feuilleter les pages de manuel
Maintenant que vous avez une idée claire de l'arrangement des pages de manuel, vous pouvez commencer à rechercher des commandes. Parfois, il nous faut affiner progressivement notre recherche. Le premier pas consiste à s'intéresser aux sections. Pour trouver la description d'une section, on peut utiliser man intro, comme ceci :

Malheureusement, cela ne marche pas toujours ! Cependant, heureusement pour nous, il y a une autre façon de rechercher des commandes qui peut retourner des résultats multiples (comme un appel à une bibliothèque et une commande système qui ont le même nom). Pour ce faire, nous utilisons l'option  de la commande man de cette manière :

Parfois la sortie peut prendre pas mal de place. Dans ce cas, il peut être préférable de spécifier plus de mots clé. Maintenant que nous savons où trouver la page de manuel, la section suivante va vous montrer comment la visualiser.

Visualiser les pages de manuel
Visualiser les pages de manuel peut être accompli de deux manières. En premier lieu avec la commande  man [nom de la page man ] . La deuxième manière utilise man [nom de page man page ]. Considérons par exemple. Nous pouvons voir, soit la première page de manuel qui apparaît avec bc(qui devrait être la section 1, parce que c'est la section de numéro le plus faible contenant une page de manuel sur ) :

Cependant, comment faire pour avoir la version POSIX ? Dans ce cas nous utilisons la deuxième forme :

Et la page de manuel est affichée. Maintenant que nous savons afficher une page de manuel, il est temps de l'utiliser. La section suivante vous montre comment naviguer et rechercher.

Naviguer et chercher dans les pages de manuel
Navigating a man page is fairly simple. To move up and down line by line, use the and  arrow keys. To move up page by page, you can use the and  keys. Do however note that these navigation instructions assume the environmental  variable is set to use the default pager, less. Less also has a few other commands for navigation, but the arrow keys usually suffice:

Searching, however, is more interesting. The two most basic searches are  and. The first version searches forwards, and the second searches backwards. is a regular expression pattern that is described in man 7 regex. Let's take for example searching for the  option to emerge. First, bring up the emerge man page:

Then, at the screen, press the key to bring up the entry prompt to search forwards and enter in our search pattern:

Ceci recherchera la page de manuel et se focalisera sur l'item recherché :

If you hit a search result by accident and want to continue searching for the same results, simply press the key again, and press  (i.e. don't put a pattern it). This will cause the search to default to the last pattern used. Now with some man pages, options are listed, then explained later on. Take the man 5 portage man page. It lists the files used, then explains their usage. Searching forward a few times would return the results, but there's an easier way to handle this, with the second search form, backwards searching. Let's use this to find the description on. First, bring up man 5 portage:

Now press +. This will bring you to the end of the page:

Now we'll go ahead and enter the pattern to search for with the  backwards search option. First press the key to bring up the prompt, and then enter in, our query:

Then hit to bring up the result:

La recherche est terminée ! Notez que, tout comme avec  , utiliser   sans expression régulière revient à rechercher avec la dernière expression régulière utilisée.

Conclusion
Ceci conclut le guide sur man. Nous espérons avoir apporter un peu de clarté sur la navigation dans les pages, et peut-être même, avoir apporté de nouvelles astuces à des utilisateurs plus expérimentés. Pour ceux qui préfèrent un moyen alternatif pour naviguer dans les pages de manuel, les moyens suivants sont aussi disponibles :


 * - a program for converting man pages to html
 * - a tk based man page browser

Also the KDE web browser can browse man pages using the man: syntax in the address bar.