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. 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, 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 le paramètre   de 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. La deuxième manière utilise. Considérons   par exemple. Nous pouvons voir, soit la première page de manuel qui apparaît avec  (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
Naviguer dans une page de manuel est très facile. Utilisez les touches fléchées pour vous déplacer d'une ligne vers le haut ou vers le bas. Utilisez les touches « page vers le haut » et « page vers le bas » pour aller de page en page, respectivement vers le haut et vers le bas. Notez néanmoins que ces instructions de navigation supposent que la variable d'environnement  est définie pour utiliser l'outil de  pagination par défaut, à savoir. Less comprend aussi quelques autres commandes de navigation, mais les touches fléchées suffisent généralement :

Commande de navigation supplémentaire de less

La recherche, pour sa part, est plus intéressante. Les deux commandes de recherche de base sont  et. La première version cherche en avant, la seconde en arrière. est une expression régulière qui est décrite dans. Prenons l'exemple de la recherche de l'option   de la commande. Tout d'abord appelons la page emerge :

Ensuite, pressons la touche  pour faire apparaître l'invite de commande pour rechercher en avant et saisissons l'expression régulière à rechercher :

Faire apparaître l'invite de commande de recherche en avant

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

Résultats de la recherche en avant

Si vous atteignez un résultat de recherche par accident et que vous voulez continuer à chercher parmi les mêmes résultats, pressez simplement la touche, puis faites  Entrée (c.à.d. ne saisissez pas d'expression régulière). Ceci fera repartir la recherche avec la dernière expression régulière utilisée. Maintenant, dans quelques pages, les options sont listées, puis expliqués plus loin dans le texte. Prenez. Elle liste les fichiers utilisés, puis explique comment les utiliser. Une recherche en avant répétée quelques fois devrait retourner les résultats, mais il y a une manière plus facile d'appréhender cela ; elle consiste à utiliser la deuxième forme, la recherche en arrière.Essayons de l'utiliser pour trouver la description de. Tout d'abord, appelons la page  :

Maintenant pressez la combinaison de touches. Cela vous amènera en fin de page :

Fin de la page de manuel après un SHIFT+g

Avançons maintenant en entrant l'expression régulière à chercher avec l'option   de recherche en arrière. Tout d'abord pressons la touche   pour faire apparaître l'invite de commande et saisisson  , l'objet de notre recherche :

Spécifier notre recherche

Faites Entrée pour afficher le résultat :

Résutlat de notre recherche

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 :


 * app-text/man2html - un programme de conversions des pages de manuel en html
 * app-text/tkman - un navigateur de pages de manuel basé sur tk

Le navigateur  de   peut aussi vous permettre de naviguer dans les pages de manuel en utilisant la syntaxe   dans la barre d'adresse.

Remerciements
Nous tenons à remercier les auteurs et éditeurs suivants pour leur contribution à ce guide :


 * Chris White
 * José Fournier (Traduction)