6.45. Man-DB-2.4.4

6.45.1. Installation de Man-DB

Vous devez faire quatre ajustements aux sources de Man-DB.

Le premier modifie la place des pages de manuel traduites fournies avec Man-DB, afin qu'elles soient accessibles avec les locales traditionnelle et UTF-8 :

mv man/de{_DE.88591,}
mv man/es{_ES.88591,}
mv man/it{_IT.88591,}
mv man/ja{_JP.eucJP,}
sed -i 's,\*_\*,??,' man/Makefile.in

Le second changement est une substitution sed pour effacer les lignes « /usr/man » et « /usr/local/man » dans le fichier man_db.conf pour empêcher les résultats redondants lors de l'utilisation des programmes comme whatis :

sed -i -e '\%\t/usr/man%d' -e '\%\t/usr/local/man%d' src/man_db.conf.in

Le troisième changement précise les programmes que Man-DB doit pouvoir trouver lors de l'exécution, mais qui n'ont pas encore été installés :

cat >> include/manconfig.h.in << "EOF"
#define WEB_BROWSER "exec /usr/bin/lynx"
#define COL "/usr/bin/col"
#define VGRIND "/usr/bin/vgrind"
#define GRAP "/usr/bin/grap"
EOF

Le programme col fait partie du paquet Util-linux, lynx est un navigateur web en mode texte (voir BLFS pour les instructions d'installation), vgrind convertit des sources de programme en entrée Groff, et grap est utile pour présenter des graphes dans des documents Groff. Les programmes vgrind et grap ne sont normalement pas nécessaires pour visualiser les pages de manuel. Ils ne font pas partie de LFS ou de BLFS, mais vous devriez pouvoir les installer vous-même après avoir fini LFS si vous le souhaitez.

Finalement, appliquez un correctif aux sources pour corriger des erreurs de sortie si la page de man est prématurément annulée en tapant la touche 'q'.

patch -Np1 -i ../man-db-2.4.4-fixes-1.patch

Préparez la compilation de man-DB :

./configure --prefix=/usr --enable-mb-groff --disable-setuid

Compilez le paquet :

make

Ce paquet n'est pas fourni avec une suite de tests.

Installez le paquet :

make install

Certains paquets fournissent des pages de man UTF-8 que cette version de man n'est pas capable d'afficher. Le script suivant permettra à certaines d'entre elles d'être converties dans les codages attendus montrés dans la table ci-dessous. Man-DB s'attend à ce que les pages de manuel soit dans les codages de la table, et les convertira au besoin dans l'encodage de la locale actuelle quand ils les affichera, afin qu'elles s'affichent en locales UTF-8 et traditionelle. Ce script étant conçu ici pour une utilisation limitée pendant la compilation du système, pour des données publiques, nous n'allons pas nous ennuyer à vérifier les erreurs, ni utiliser un nom de fichier temporaire imprévisible :

cat >> convert-mans << "EOF"
#!/bin/sh -e
FROM="$1"
TO="$2"
shift ; shift
while [ $# -gt 0 ]
do
        FILE="$1"
        shift
        iconv -f "$FROM" -t "$TO" "$FILE" >.tmp.iconv
        mv .tmp.iconv "$FILE"
done
EOF
install -m755 convert-mans  /usr/bin

Vous pouvez trouver des informations supplémentaires sur la compression des pages de man et d'info dans le livre BLFS sur http://www.linuxfromscratch.org/blfs/view/cvs/postlfs/compressdoc.html.

mkdir -p /usr/share/man/fr
cp -rv man? /usr/share/man/fr

mv man7/iso_8859-7.7{,X}
convert-mans UTF-8 ISO-8859-1 man?/*.?
mv man7/iso_8859-7.7{X,}
make install