logo Debian Debian Debian-France Debian-Facile Debian-fr.org Forum-Debian.fr Debian ? Communautés logo inclusivité

Debian-facile

Bienvenue sur Debian-Facile, site d'aide pour les nouveaux utilisateurs de Debian.

Vous n'êtes pas identifié(e).


L'icône rouge permet de télécharger chaque page du wiki visitée au format PDF et la grise au format ODT → ODT PDF Export

Différences

Ci-dessous, les différences entre deux révisions de la page.

Lien vers cette vue comparative

Les deux révisions précédentes Révision précédente
Prochaine révision
Révision précédente
doc:systeme:man [15/09/2013 19:56]
MicP [Utilisation]
doc:systeme:man [15/01/2017 10:25] (Version actuelle)
nIQnutn [Remerciement :]
Ligne 1: Ligne 1:
-====== ​MAN ======+====== ​man ====== 
 +  * Objet : man 
 +  * Niveau requis : {{tag>​débutant avisé}} 
 +  * Commentaires : //Manuel d'​information des commandes Linux disponibles // 
 +  * Débutant, à savoir : [[:​doc:​systeme:​commandes:​le_debianiste_qui_papillonne|Utiliser GNU/Linux en ligne de commande, tout commence là !.]] :-) 
 +  * Suivi :  
 +    * Création par [[user>​smolski]] le 12-06-2010 
 +    * Testé le ... 2014 
 +  * Commentaires sur le forum : [[http://​debian-facile.org/​viewtopic.php?​id=2675 | Lien vers le forum concernant ce tuto]]((N'​hésitez pas à y faire part de vos remarques, succès, améliorations ou échecs !))
  
-Manuel d'​information des commandes Linux disponibles+ 
 + 
 +===== Syntaxe =====
  
 Syntaxe : Syntaxe :
    man <​commande>​    man <​commande>​
  
-Remplacer <​commande>​ par la commande dont vous désirez des informations.+Remplacer <​commande>​ par la commande dont vous désirez ​obtenir ​des informations. 
 + 
 +===== Utilisation ===== 
  
 Exemple : Exemple :
-   ​$ ​man cp+<code user>man cp</​code>​
  
 Nous obtenons : Nous obtenons :
  
-<code>+<file bash extrait du retour affiché par la commande ci-dessus>
 CP(1)                              Commandes ​                            CP(1) CP(1)                              Commandes ​                            CP(1)
  
Ligne 37: Ligne 50:
               archiver chaque fichier cible existant               archiver chaque fichier cible existant
 .../... .../...
-</code>+</file>
  
 ===== Utilisation ===== ===== Utilisation =====
 +
 Man est l'​interface de consultation des manuels de référence en ligne. Man est l'​interface de consultation des manuels de référence en ligne.
 +
 ==== Option man -u ==== ==== Option man -u ====
 +
 Rafraîchir la base de donnée du man : Rafraîchir la base de donnée du man :
-<​code ​bash>man -u</​code>​+<​code ​user>man -u</​code>​ 
 ==== Option man -f <​commande>​ ==== ==== Option man -f <​commande>​ ====
-Affiche, si elle est disponible, une courte description de la page de manuel.\\ ​+ 
 +Affiche, si elle est disponible, une courte description de la page de manuel ​de la commande.\\ 
 Équivalent à whatis.\\ ​ Équivalent à whatis.\\ ​
-Voir ''​man ​whatis''​ pour obtenir des précisions.+Voir ''​man whatis''​ pour obtenir des précisions.
  
-<​code ​bash+<​code ​user
-man -f man+man -f man
 man (1)              - Interface de consultation des manuels de référence en ligne man (1)              - Interface de consultation des manuels de référence en ligne
 man (7)              - Macros pour la mise en forme des pages de manuel man (7)              - Macros pour la mise en forme des pages de manuel
 </​code>​ </​code>​
 +
 +Donc, pour l'​interface "​man"​ :<code user>man 1 man</​code>​
 +Et pour la macro "​man"​ :<code user>man 7 man</​code>​
 +
 ==== Option man -k <mot clef> ==== ==== Option man -k <mot clef> ====
-Recherche la description courte et le nom des pages de manuel comportant le ''​mot-clé''​. 
  
-In french : +Recherche la description courte et le nom des pages de manuel dans lesquelles le ''​mot-clé''​ a été trouvé. 
-<​code>​ + 
-man -k which+<​code ​user
 +man -k which
 which (1)            - localise une commande which (1)            - localise une commande
 getcpu (2)           - determine CPU and NUMA node on which the calling thread is running getcpu (2)           - determine CPU and NUMA node on which the calling thread is running
Ligne 70: Ligne 92:
 URI::​WithBase (3pm)  - URIs which remember their base URI::​WithBase (3pm)  - URIs which remember their base
 </​code>​ </​code>​
 +
 ==== man [1-8] ==== ==== man [1-8] ====
 +
 Le tableau ​ ci-dessous ​ indique le numéro des sections de manuel ainsi que le type de pages qu’elles contiennent. Le tableau ​ ci-dessous ​ indique le numéro des sections de manuel ainsi que le type de pages qu’elles contiennent.
 ^  Num  ^  Description ​ ^ ^  Num  ^  Description ​ ^
Ligne 85: Ligne 109:
 === Exemple : === === Exemple : ===
  
-Issu de l'​option ''​-f''​ précédente : +<code user>​man ​-f cpgr 
- +   cpgr (8)             - copy with locking the given file to the password or group file.</​code>​
-   cpgr (8)             - copy with locking the given file to the password or group file.+
 Le chiffre ''​(8)''​ indique que la commande ''​cpgr''​ est réservée à l'​usage de root, le super-utilisateur (administrateur) du système. Le chiffre ''​(8)''​ indique que la commande ''​cpgr''​ est réservée à l'​usage de root, le super-utilisateur (administrateur) du système.
 +
 +==== Conventions pour écrire des "​man-pages"​ ====
 +<code user>man man-pages</​code>​
  
 ==== Astuce ==== ==== Astuce ====
 +
 === man pages non traduites : === === man pages non traduites : ===
-Visualiser ​les man pages dans leur version non traduite peut permettre d'​éviter les erreurs de traductions,​ d'​interprétations et les omissions.\\ ​ + 
-Pour cela, il suffit simplement de modifier la variable ''​LANG''​ juste avant l'​appel de la commande ''​man''​.\\  +Visualiser ​une "man page" ​dans sa version non traduite peut permettre d'​éviter les erreurs de traductions,​ d'​interprétations et les omissions.\\ ​
-Mais avant de modifier cette variable, il vaudra mieux la sauvegarder afin de pouvoir la restaurer.+
  
 La ligne de commande suivante vous permettra de visualiser la page ''​man''​ de la commande ''​locale''​ dans la langue par défaut de votre installation. La ligne de commande suivante vous permettra de visualiser la page ''​man''​ de la commande ''​locale''​ dans la langue par défaut de votre installation.
-<code bash>man locale</​code>​+<​code ​user>man locale</​code>​ 
 +<​file ​bash extrait du retour de la commande ci-dessus> 
 +LOCALE(1) ​                                             Debian GNU/​Linux ​                                             LOCALE(1) 
 + 
 +NOM 
 +       ​locale - Récupérer des informations des paramètres régionaux 
 + 
 +SYNOPSIS 
 +       ​locale [ -a | -m] 
 + 
 +       ​locale [ -ck ] nom... 
 + 
 +DESCRIPTION 
 +       Le programme locale affiche des informations pour la localisation (NdT : la localisation est aussi appelée paramètres 
 +       ​régionaux,​ ou « locale » en anglais) en cours, ou pour toutes les localisations,​ sur la sortie standard. 
 +... 
 +</​file>​ 
 +La ligne de commande suivante vous permettra de visualiser la page ''​man''​ de la commande ''​locale''​ dans sa version et sa langue originale (POSIX). 
 +<code user>man -L C locale</​code>​ 
 +<file bash extrait du retour de la commande ci-dessus>​ 
 +LOCALE(1) ​                                             Debian GNU/​Linux ​                                             LOCALE(1) 
 + 
 +NAME 
 +       ​locale - Get locale-specific information. 
 + 
 +SYNOPSIS 
 +       ​locale [ -a | -m] 
 + 
 +       ​locale [ -ck ] name... 
 + 
 +DESCRIPTION 
 +       The locale program writes information about the current locale environment,​ or all locales, to standard output. 
 +.... 
 +</​file>​ 
 + 
 + 
 +===== Pages man en couleur ===== 
 +Pour pouvoir profiter de la coloration syntaxique des pages man, ajoutez ces lignes à la fin de votre fichier **~/​.bashrc** ou dans un des scripts qui seront lancés par **~/​.bashrc** (par exemple, le fichier **~/​.bash_functions**) 
 +<code user>#########​ pages man en couleur 
 +man() { 
 +   ​env ​                                      \ 
 +   ​LESS_TERMCAP_mb=$(printf "​\e[1;​31m"​) ​     \ 
 +   ​LESS_TERMCAP_md=$(printf "​\e[1;​38;​5;​74m"​) \ 
 +   ​LESS_TERMCAP_me=$(printf "​\e[0m"​) ​        \ 
 +   ​LESS_TERMCAP_se=$(printf "​\e[0m"​) ​        \ 
 +   ​LESS_TERMCAP_so=$(printf "​\e[1;​44;​33m"​) ​  \ 
 +   ​LESS_TERMCAP_ue=$(printf "​\e[0m"​) ​        \ 
 +   ​LESS_TERMCAP_us=$(printf "​\e[1;​32m"​) ​     \ 
 +   man "​$@"​ 
 +
 +</​code>​ 
 +===== Version française des pages de manuel ===== 
 + 
 +<code root>​apt-get install manpages-fr manpages-fr-extra</​code>​
  
-La ligne de commande suivante vous permettra de visualiser la page ''​man''​ de la commande ''​locale''​ sans que leur contenu soit traduit (POSIX). 
-<code bash>​langTmp=$LANG;​ LANG=C; man locale; LANG=$langTmp</​code>​ 
 ===== Remerciement : ===== ===== Remerciement : =====
  
doc/systeme/man.1379267761.txt.gz · Dernière modification: 15/09/2013 19:56 par MicP

Pied de page des forums

Propulsé par FluxBB