6.47. Man-1.5o

Il pacchetto Man contiene programmi per trovare e vedere pagine di manuale.

Tempo approssimativo di costruzione: 0.1 SBU

Spazio su disco richiesto: 1.9MB

L'installazione di Man dipende da: Bash, Binutils, Coreutils, Gawk, GCC, Glibc, Grep, Make, Sed

6.47.1. Installazione di Man

Bisogna fare tre aggiustamenti ai sorgenti di Man.

Il primo è una patch che permette a Man di lavorare meglio con versioni recenti di Groff. In particolare, le pagine man ora appariranno usando tutta l'ampiezza del terminale invece di essere limitate a 80 caratteri:

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

Il secondo è una sostituzione sed per aggiungere lo switch -R alla variabile PAGER in modo che le sequenze di escape siano gestite correttamente da Less:

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

Anche il terzo è una sostituzione sed per commentare la linea “MANPATH /usr/man” nel file man.conf per prevenire risultati ridondanti quando si usano programmi come whatis:

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

Preparare Man per la compilazione:

./configure -confdir=/etc

Significato delle opzioni di configurazione:

-confdir=/etc

Questa dice al programma man di cercare il file di configurazione man.conf nella directory /etc.

Compilare il pacchetto:

make

Installare il pacchetto:

make install
[Nota]

Nota

Per disabilitare la sequenza di escape SGR (Select Graphic Rendition), si deve editare il file man.conf e aggiungere lo switch -c alla variabile NROFF.

Se il proprio set caratteri usa caratteri a 8-bit, cercare la linea che inizia con “NROFF” in /etc/man.conf, e verificare che appaia come segue:

NROFF  /usr/bin/nroff -Tlatin1 -mandoc

Notare che bisogna usare “latin1” anche se non è il set di caratteri della propria localizzazione. La ragione è che, stando alle specifiche, groff non ha modo di scrivere caratteri fuori ISO-8859-1 senza qualche strano codice escape, e quindi le pagine di manuale localizzate diventerebbero poco leggibili . Durante la formattazione delle pagine di manuale, groff pensa che siano nella codifica ISO-8859-1 e questo switch -Tlatin1 dice a groff di usare la stessa codifica per l'output. Poiché groff non fa registrazione dei caratteri di input, il risultato formattato è davvero nella stessa codifica dell'input (sebbene groff non sappia che non è ISO-8859-1) e quindi è utilizzabile come input per un pager.

Questo suggerimento non risolve il problema del programma man2dvi non funzionante per pagine di manuale localizzate con localizzazioni non-ISO-8859-1. Inoltre non funziona affatto con set caratteri multibyte. Il primo problema non ha attualmente una soluzione. Del secondo non ci si preoccupa perché l'installazione LFS comunque non supporta appropriatamente set caratteri multibyte.

Ulteriori informazioni riguardo alla compressione delle pagine man e info si possono trovare nel libro BLFS su http://www.linuxfromscratch.org/blfs/view/cvs/postlfs/compressdoc.html.

6.47.2. Contenuti di Man

Programmi installati: apropos, makewhatis, man, man2dvi, man2html e whatis

Brevi descrizioni

apropos

Cerca nel database whatis e visualizza le descrizioni brevi dei comandi di sistema che contengono una data stringa.

makewhatis

Costruisce il database whatis. Legge tutte le pagine manuale nel percorso di man e per ciascuna pagina scrive il nome e una breve descrizione nel database whatis.

man

Formatta e visualizza le pagine manuale on-line richieste.

man2dvi

Converte una pagina manuale in formato dvi.

man2html

Converte una pagina manuale in html.

whatis

Cerca nel database whatis e visualizza le descrizioni brevi dei comandi di sistema che contengono una data parola chiave come parola separata.