Ce site est en cours de création...

Merci de votre indulgence pendant cette (très longue) phase de mise en route… ^_^




Exporter la page au format Open Document

La commande man

Retour vers l'accueil de la catégorie commandes

Le statut de cette page est celui d'un brouillon / prise de notes…

Un doute sur une commande particulière ? Vous vous ne rappelez plus des options d’une commande ? La commande man (manual) permet d’afficher les informations relatives à cette commande. C’est la base de la documentation Unix-Linux. Une commande à ne pas oublier.


Ajouter les manpages en français

Sur la plupart des distributions, les «manpages» (ou pages de manuel) sont installées uniquement en anglais… Pour ajouter les manpages dans la version traduite en français (quand elle existe), il faut ajouter les paquets suivants :

  • manpages-fr
  • manpages-fr-extra
  • manpages-fr-dev (éventuellement, pour les développeurs…)

apt://manpages-fr, manpages-fr-extra


Lire les manpages

En console

Il suffit de précéder la commande pour laquelle on souhaite lire la page de manuel de la commande man :

user@machine:~$ man commande

Tapez la commande suivante à titre d'exemple pour comprendre :

man man

Cela vous affichera la page de manuel

Dans une interface graphique

Il existe une application qui permet de lire les manpages via une interface “graphique” ou plutôt “semi-graphique”. Cette application fait partie du paquet x11-apps qui installe divers utilitaires X. Elle permet également de “naviguer” dans la liste des manpages disponibles.

Vous pouvez lancer cette application via la commande xman.

Utilisation

Afficher l'aide

Pour afficher l'aide concernant l'interactivité dans une manpage, taper h ou H.

Quitter une manpage

Pour quitter la manpage, il suffit de taper q comme ”quit”. D'autres possibilités existent cependant :

  q  :q  Q  :Q  ZZ     Exit.

Se déplacer dans une manpage

  e  ^E  j  ^N  CR  *  Forward  one line   (or N lines).
  y  ^Y  k  ^K  ^P  *  Backward one line   (or N lines).
  f  ^F  ^V  SPACE  *  Forward  one window (or N lines).
  b  ^B  ESC-v      *  Backward one window (or N lines).
  z                 *  Forward  one window (and set window to N).
  w                 *  Backward one window (and set window to N).
  ESC-SPACE         *  Forward  one window, but don't stop at end-of-file.
  d  ^D             *  Forward  one half-window (and set half-window to N).
  u  ^U             *  Backward one half-window (and set half-window to N).
  ESC-)  RightArrow *  Left  one half screen width (or N positions).
  ESC-(  LeftArrow  *  Right one half screen width (or N positions).
  F                    Forward forever; like "tail -f".
  r  ^R  ^L            Repaint screen.
  R                    Repaint screen, discarding buffered input.
        ---------------------------------------------------
        Default "window" is the screen height.
        Default "half-window" is half of the screen height.

Faire des recherches sur un motif dans une manpage

  /pattern          *  Search forward for (N-th) matching line.
  ?pattern          *  Search backward for (N-th) matching line.
  n                 *  Repeat previous search (for N-th occurrence).
  N                 *  Repeat previous search in reverse direction.
  ESC-n             *  Repeat previous search, spanning files.
  ESC-N             *  Repeat previous search, reverse dir. & spanning files.
  ESC-u                Undo (toggle) search highlighting.
  &pattern          *  Display only matching lines
        ---------------------------------------------------
        Search patterns may be modified by one or more of:
        ^N or !  Search for NON-matching lines.
        ^E or *  Search multiple files (pass thru END OF FILE).
        ^F or @  Start search at FIRST file (for /) or last file (for ?).
        ^K       Highlight matches, but don't move (KEEP position).
        ^R       Don't use REGULAR EXPRESSIONS.

Mettre un peu de couleur dans les manpages

Il est possible de coloriser un peu les manpages en installant l'utilitaire most. Tout comme more et less, most est un programme de défilement qui affiche, une pleine page à la fois, le contenu d’un fichier sur un terminal. Une ligne d'état en bas de l'écran affiche le nom du fichier, le numéro de la première ligne affichée à l'écran et le pourcentage du fichier qui a déjà été affiché.

Une fois le paquet most installé sur votre distribution, vous pourrez l'utiliser à la place de less pour visualiser les fichiers texte en console :

most ~/mon_fichier.txt

Mais most va encore plus loin que less en ajoutant un minimum de couleurs et en tentant de détecter au mieux les types de fichiers.

Pour voir ce que donne une manpage lue avec most comme PAGER (une variable d'environnement), vous pouvez essayer la commande suivante :

PAGER=most man man

Pour que most soit définitivement utilisé comme PAGER et serve dès qu'il s'agit d'afficher du texte dans un terminal, il faut modifier votre fichier ~/profile (ou ~/bash_profile) pour y ajouter la ligne suivante :

export PAGER=most

Lors de votre prochain login, vous disposerez de la variable PAGER dans votre environnement. :-)

Liens


Liens externes