Info/fr

Ce guide a pour but de vous montrer comment utiliser la commande info pour naviguer à travers les pages info.

Qu'est-ce qu'info  ?
La plupart d'entre-vous est familière avec le système de documentation. ALors que man est très bon pour rechercher rapidement des items, il manque de structuration dans les liaisons entre pages. C'est là que  fait son entrée. Les pages info sont faites en utilisant les outils, et peuvent, en général,  être liées à d'autres pages, disposer de menus et d'une navigation facile. La section qui suit détaille la façon selon laquelle les pages info sont arrangées.

Arrangement des pages info
Les pages info principales sont dans le dossier. Contrairement au style d'arrangement des répertoires man, contient ce qui est plutôt une grande collection de fichiers. Ces fichiers ont le format suivant :

format des fichiers info

est le nom réel de la page (exemple: ). est une construction facultative qui désigne un autre niveau de nœuds (en général, ceux-ci sont référencés par le niveau sommet du document info en question). En vue d'économiser de l'espace, ces pages info sont compressées avec. Des pages info additionnelles peuvent être listées avec la variable d'environnement   (ordinairement définie à travers les différents fichiers ). Pour commencer, il est important de remarquer le fichier. Ce fichier spécial est utilisé quand la commande info est lancée sans paramètre. Il contient une liste de toutes les pages info disponibles pour les utilisateurs. Pour commencer à naviguer dans info, nous allons avancer et démarrer sans arguments :

Maintenant, dans le chapitre suivant, nous allons voir comment se servir des informations de base de la navigation.

Naviguer avec les menus
Maintenant qu'info est démarré, notre écran prend l'allure suivante :

Échantillon d'écran info

Juste maintenant, il y a un paquet d'entrées précédées d'un astérisque. Ce sont des items de menu pour naviguer à travers les différents niveaux de nœuds. Il y a deux manières de sélectionner un menu. Nous allons voir la première maintenant et l'autre plus tard. Tout d'abord, nous allons avancer et regarder la page info. Pour le faire, utilisez la flèche de direction vers le bas, jusqu'à atteindre la zone indiquée par la mise en évidence en fond bleu :

Naviguer jusqu'à l'entrée de menu wgety

Une fois cette zone atteinte, appuyez sur la touche de clavier  pour sélectionner l'entrée de menu. Ceci présentera la page info pour  :

La page info wget

Maintenant que nous avons une page info, la section suivante va présenter la navigation de base.

Navigation de base
En terme de nœuds, celui-ci est considéré comme le nœud  pour la page wget. Considérez le nœud  comme une table des matières pour cette page info particulière. Maintenant, naviguez vers la page réelle elle-même. Plusieurs méthodes sont possibles. La première est la méthode info standard. Elle consiste à utiliser la touche   pour avancer d'une page et la touche   pour revenir d'une page en arrière. C'est la méthode recommandée car elle permet d'avancer/revenir automatiquement vers le nœud approprié dans le document. Ceci permet un feuilletage des pages un peu linéaire pour ceux habitués aux pages man. Une autre manière consiste à utiliser les touches. Celles-ci fonctionnent mais elle n'avanceront/reculeront pas comme  le feraient. Si vous voulez sauter des nœuds entiers sans utiliser les touches , vous pouvez aussi utiliser les touches    (avancer) et   (reculer).

Comme mentionné précédemment, il y a 2 façons de naviguer dans les menus. La deuxième façon va être décrite ici. Les chiffres    peuvent être utilisés pour référencer les entrées de menu ans un document de la première à la neuvième. Ceci permet de rechercher rapidement dans des documents. Par exemple, nous allons utiliser    pour atteindre l'entrée de menu. Pressez donce la touche  et la page    sera affichée à l'écran :

Écran résultant sur Recursive Download

Nous sommes maintenant sur la page. C'est le moment de noter quelques éléments. Tout d'abord, la section d'entête. Cette entête montre les possibilités de navigation dans cette page. La page marquée    est accessible par la touche , et la page marquée   est accessible par la touche. Notez bien que cela ne fonctionne que pour un même niveau. Si vous en faites un usage excessif, vous pourriez vous retrouver sur un contenu qui n'a absolument rien à voir. C'est mieux d'utiliser   pour naviguer linéairement.

Si, pour une raison ou une autre, vous êtes perdu, il y quelques moyens de s'y retrouver. En premier lieu, la touche. Elle vous ramenera instantanément au nœud sommet (table des matières) pour la page info que vous feuilletez. Si vous voulez retourner à la dernière page que vous avez regardé, vous pouvez utiliser la touche. Si vous voulez remonter d'un niveau, vous pouvez utiliser la touche. Maintenant que vous avez quelques notions de navigation dans une page, le chapitre suivant va vous expliquer comment rechercher un contenu.

Naviguer vers d'autres pages info
Maintenant que vous savez naviguer dans une page info, nous allons regarder comment accéder à d'autres pages info. La première façon évidente de le faire est de se rendre sur la liste index des pages info via. Pour accéder à cet index depuis n'importe quel niveau d'un document, pressez simplement la touche. De là, vous pouvez chercher la page qui vous intéresse. Néanmoins, si vous connaissez déjà la page réelle, c'est plus facile de l'atteindre par. Pour accéder à une page info par son nom, tapez , pour faire apparaître l'invite de commande et entrez le nom de la page entre parenthèses :

Accéder à une page info par son nom

Ceci fera apparaître la page libc comme présentée ici :

Résultat de la commande Aller au nœud

Maintenant que vous savez comment accéder à des pages info par leur nom, la section suivante va vous montrer comment trouver des éléments d'information en utilisant l'index de la page info.

Recherche à partir d'un index
Dans cet exemple, nous allons voir comment trouver la fonction  de la bibliothèque C en utilisant l'index de la page info. Vous devriez toujours vous trouver sur la page info libc si vous en êtes resté à la dernière section, si ce n'est pas le cas, rendez-vous sur ce nœud avec la commande Goto node. Pour utiliser la recherche par l'index, pressez la touche  pour faire apparaître l'invite de commande, puis entrez le terme de votre recherche. Nous allons le montrer ci-dessous pour     :

Entering an index search query

Après avoir pressé la touche entrée et après exécution de votre requête, vous arrivez sur la définition de   de la page   :

Résultat de la requête de recherche à partir de l'index

Vous avez réussi votre recherche à partir de l'index de la page info. Cependant, parfois ce que nous cherchons se trouve dans la page elle-même. La section suivante va montre comment effectuer une recherche dans la page elle-même.

Recherche par la commande search
En démarrant de l'emplacement précédent au nœud, nous allons rechercher la variante   de la fonction. Pour effectuer la recherche, pressez la touche   pour faire apparaître l'invite de recherche et entrez la requête (sprintf dans notre cas) :

Entering a search query

Hit  and it will show the result of the query:

Result of the search query

And we have the function we need.

Conclusion
This concludes the overview of using info to view info pages. As always comments are both welcome and appreciated. Clicking on the my name (Chris White) on the right side will send me an email.

Additional Program Resources
In order to make things easier for those that wish to browse info pages through a more friendly graphical interface, the following are available:


 * app-text/info2html - Convert info pages to a browse-able HTML format
 * app-text/pinfo -  based info viewer
 * app-text/tkinfo - a  based info browser
 * app-vim/info - a  based info browser

The  browser   also allows you to browse info pages through the   URI.

Acknowledgements
We would like to thank the following authors and editors for their contributions to this guide:


 * Chris White