Linux

Comment lire facilement une page de manuel Linux

L’une des compétences les plus importantes que vous puissiez acquérir en tant qu’utilisateur Linux est de savoir comment utiliser une page de manuel, ou « page de manuel ».

Cet article vous présentera ces documents simples. Vous apprendrez à ouvrir les pages de manuel et à identifier le contenu à l’intérieur, qui comprendra des marques spéciales telles que gras et le texte souligné à côté d’indicateurs tels que des points de suspension (…) et des crochets ([ ]).

Les pages de manuel sont assez faciles à aborder et votre temps est précieux, alors ne perdons pas une minute de plus.

Ouvrir les pages de l’homme

Dans le terminal que vous avez sous la main, tapez

pour ouvrir une page de manuel. Si vous souhaitez ouvrir la page pour xterm, un terminal probablement sur votre système, tapez man xterm.

Les pages de manuel sont triées en sections. Parfois, vous les trouverez répertoriés avec leur numéro de section, comme « tty(4) ». Le numéro de section ici fait référence au terminal de contrôle tty dans la section « Fichiers spéciaux (périphériques) », qui fait partie des sections standard des pages de manuel répertoriées dans le lien de ce paragraphe.

Chaque fois que vous voyez une liste comme « tty(4) », vous pouvez accéder à cette section en tapant

La syntaxe man 4 tty atteindra la page de référence ici.

Trouver une page spécifique

Si jamais vous voulez voir si une page de manuel existe, essayez

Psssssst :  Comment savoir si VirtualBox est installé sur Ubuntu ?

comme whatis xterm.

Supposons que vous ne sachiez pas de quelle page vous avez besoin, mais que vous vouliez en savoir plus sur les terminaux. Vous pouvez rechercher un mot-clé en actualisant d’abord le cache de votre page de manuel avec la commande

Ensuite, recherchez avec

La syntaxe man -k terminal est appropriée dans cette situation.

Vous pouvez moins envoyer de longues sorties dans le lecteur de texte en utilisant

Cela facilitera le défilement et la recherche d’éléments.

Syntaxe de la page de manuel

En parlant de lecteurs de texte, vous trouverez probablement le cousin plus jeune de moins, connu sous le nom de plus, sur votre système. Affichez sa page de manuel avec

Cela devrait ressembler à l’image suivante.

La raison pour laquelle la page de manuel de more fonctionne bien en tant qu’exemple est la syntaxe indiquée dans sa section Synopsis. Ça lit « Suite [options] déposer… »

Bien que cela puisse ne pas sembler complexe, les variations de style et de forme du texte sont toutes importantes pour cette ligne.

Texte en gras

Tout texte en gras signifie que vous devez le saisir exactement comme indiqué. Lorsque vous utilisez l’utilitaire more, vous devrez taper le mot « more » au début de chaque commande.

Supports

Le texte entre parenthèses est facultatif. Dans le cas de more, vous pouvez utiliser des options telles que -f pour compter les lignes logiques ou -c pour peindre les lignes au lieu de les faire défiler. Le début d’une commande plus pourrait alors ressembler à

ou

Étant donné que ces paramètres sont facultatifs, vous pouvez les omettre entièrement.

Texte souligné ou en italique

Selon les capacités de votre terminal, vous verrez probablement du texte souligné et en italique à certains endroits. Parfois, ce texte peut également être d’une couleur différente. Dans tous les cas, ce type de texte nécessite de le remplacer par un argument approprié.

Dans cet exemple avec more, vous devez remplacer « file » par un nom de fichier. plus -c file.txt a du sens ici.

Ellipses

Une ellipse affichée après n’importe quel argument – fichier… – ou expression – [options]… – signifie que l’argument ou l’expression est répétable.

Ce que vous obtenez avec plus dans le fichier… signifie que quelque chose comme

est autorisée. Dans ce cas, d’autres liront « text.txt », l’imprimeront à l’écran, vous permettront de faire défiler si nécessaire, puis d’agir sur « autre texte.txt ».

Ou

Un autre type d’indicateur que vous verrez dans les pages de manuel est le « | ». Ce symbole signifie « ou », et dans une page de manuel, il vous montre que, par exemple, deux options ne sont pas autorisées ensemble à la fois.

L’exemple le plus utilisé ci-dessus ne répertorie aucun paramètre comme étant exclusif, il n’y a donc pas d’exemple pertinent à montrer pour cet utilitaire. Cependant, si vous lisez une poignée d’autres pages de manuel, vous rencontrerez quelque chose comme -a|-b, ce qui signifie que vous ne pouvez utiliser que -a ou -b dans une commande.

Sections d’une page de manuel

Vous verrez également diverses sections dans les pages de manuel qui se répètent encore et encore. En règle générale, vous verrez les sections « NOM », « SYNOPSIS », « DESCRIPTION », « EXEMPLES » et « VOIR AUSSI », toutes indiquées en majuscules pour plus de clarté. Les sections « OPTIONS » et « COMMANDES » seront souvent également présentes.

La plupart des sections sont de nature explicite. Vous pouvez généralement commencer par le haut de n’importe quelle page de manuel et obtenir un bref aperçu de son contenu avec les sections Nom, Synopsis et Description. Ensuite, vous pouvez parcourir ses options et exemples pour avoir un aperçu de l’utilisation courante.

Les terminaux utilisent souvent l’utilitaire less pour lire les pages de manuel, vous devriez donc pouvoir rechercher n’importe quelle phrase avec /.

Conclusion

Bien que les pages de manuel ne soient pas fantaisistes, elles contiennent une mine d’informations. Maintenant que vous êtes familiarisé avec la syntaxe de base trouvée dans la plupart des pages de manuel, vous pouvez facilement en utiliser une la prochaine fois que vous serez bloqué lors de l’utilisation d’un utilitaire.

N’oubliez pas non plus que man man est votre ami et couvrira tous les détails non abordés ici.

Cet article est-il utile ? Oui Non

Bouton retour en haut de la page

Adblock détecté

Veuillez désactiver votre bloqueur de publicités pour pouvoir visualiser le contenu de la page. Pour un site indépendant avec du contenu gratuit, c’est une question de vie ou de mort d’avoir de la publicité. Merci de votre compréhension! Merci