Man-1.5o

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

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

Installation de Man

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

Le premier est un correctif qui permet à Man de mieux fonctionner avec les nouvelles versions de Groff. En particulier, les pages man s'afficheront maintenant sur la largeur complète du terminal au lieu d'être limité à 80 caractères :

patch -Np1 -i ../man-1.5o-80cols-1.patch

Le second 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

Le troisième 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

Pour désactiver les séquences d'échappement SGR (Select Graphic Rendition), éditez le fichier man.conf et ajoutez l'option -c à la variable NROFF.

Si l'ensemble de caractères utilise des caractères sur 8 bits, recherchez la ligne commençant par « NROFF » dans /etc/man.conf et vérifiez qu'elle ressemble à ce qui suit :

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é