Man-1.5p

Le paquet Man contient des programmes de recherche et de visualisation de pages man.

Temps de construction approximatif: 0,1 SBU
Espace disque requis: 2,9 Mo
L'installation dépend de: Bash, Binutils, Coreutils, Gawk, GCC, Glibc, Grep, Make et Sed

Installation de Man

Deux ajustements doivent être effectués sur les sources de Man.

Le premier est une substitution sed pour ajouter l'option -R à la variable PAGER de façon à ce que les séquences d'échappement soient correctement gérées par Less :

sed -i 's@-is@&R@g' configure

La seconde est aussi une substitution sed décommentant la ligne « MANPATH /usr/man » dans le fichier man.conf pour supprimer les résultats redondants lors de l'utilisation de programmes comme whatis :

sed -i 's@MANPATH./usr/man@#&@g' src/man.conf.in

Préparez la compilation de Man :

./configure -confdir=/etc

Voici la signification des options de configure :

-confdir=/etc

Ceci indique au programme man de rechercher le fichier de configuration man.conf dans le répertoire /etc.

Compilez le paquet :

make

Installez-le :

make install
[Note]

Note

Si vous travaillez sur un terminal qui ne supporte pas les attributs de texte comme la couleur ou l'emphase, vous pouvez désactiver les séquences d'échappement « Select Graphic Rendition (SGR) » en modifiant le fichier man.conf et en ajoutant l'option -c à la variable NROFF. Si vous utilisez plusieurs types de terminaux pour un ordinateur, il serait mieux d'ajouter de façon sélective la variable d'environnement GROFF_NO_SGR pour les terminaux qui ne supportent pas SGR.

Si l'ensemble de caractères de la locale utilise les caractères 8 bits, recherchez la ligne commençant avec « NROFF » dans /etc/man.conf et vérifiez qu'elle correspond à la suivante :

NROFF  /usr/bin/nroff -Tlatin1 -mandoc

Notez que « latin1 » devrait être utilisé même s'il ne s'agit pas de l'ensemble de caractères de la locale. La raison en est que, suivant la spécification, groff n'a aucun moyen de présenter les caractères en dehors de l'ISO 8859-1 sans quelques codes d'échappement étranges. En formatant les pages man, groff pense qu'elles sont dans le codage ISO 8859-1 et le commutateur -Tlatin1 indique à groff d'utiliser le même codage pour la sortie. Comme groff ne recode pas les caractères en entrée, le résultat formaté est réellement dans le même codage qu'en entrée et est, du coup, utilisable en entrée par un paginateur.

Ceci ne résout pas le problème du programme bogué man2dvi pour les pages man localisés dans des locales autres que ISO 8859-1. De plus, cela ne fonctionne pas avec des ensembles de caractères multi-octets. Le premier problème n'a pas de solution. Le second n'a pas d'importance car l'installation LFS ne supporte pas les ensembles de caractères multi-octets.

Des informations supplémentaires concernant la compression des pages man et info sont disponibles dans le livre BLFS sur http://www.linuxfromscratch.org/blfs/view/cvs/postlfs/compressdoc.html.

Contenu de Man

Programmes installés: apropos, makewhatis, man, man2dvi, man2html et whatis

Descriptions courtes

apropos

Cherche dans la base de données whatis et affiche les descriptions courtes des commandes systèmes contenant une chaîne donnée

makewhatis

Construit la base de données whatis ; elle lit toutes les pages man comprises dans MANPATH et, pour chaque page, écrit le nom et une courte description dans la base de données whatis

man

Formate et affiche la page man demandée en ligne

man2dvi

Convertit une page man au format dvi

man2html

Convertit une page man au format HTML

whatis

Recherche dans la base de données whatis et affiche les descriptions courtes des commandes système contenant un mot clé donné comme un mot séparé