Come posso visualizzare direttamente una pagina man?

Sto scrivendo una pagina man per un programma che sto confezionando. Come posso visualizzare il file manpage che ho creato, per verificare se va bene? C'è un modo per passare il mio file direttamente al mancomando invece di farlo cercare nelle manpage installate per nome?

Ho provato a fare cose del genere man myprog.1e, man < myprog.1in entrambi i casi, ho riscontrato un errore nel dire che la pagina man non è stata trovata.

man ha un'opzione per leggere un file locale: -l

-l, --local-file

Attiva la modalità `local '. Formatta e visualizza i file manuali locali invece di cercare nella raccolta manuale del sistema. Ogni argomento della pagina del manuale verrà interpretato come un file sorgente nroff nel formato corretto. Non viene prodotto alcun file cat.

Se '-' è elencato come uno degli argomenti, l'input verrà preso dallo stdin. Quando questa opzione non viene utilizzata e man non riesce a trovare la pagina richiesta, prima di visualizzare il messaggio di errore, tenta di agire come se fosse stata fornita questa opzione, usando il nome come nome file e cercando una corrispondenza esatta.

Quindi puoi visualizzare in anteprima i tuoi lavori in corso con:

man -l /path/to/manfile.1

Il modo "vecchia scuola", per i sistemi che precedono l' -lopzione, è

nroff -man filename | more -s

L'ho usato semplicemente

man ./path/to/man.1

Devi includere una barra nel percorso, altrimenti cerca nelle directory di sistema. Funziona su sistemi Linux e OS X che ho (quest'ultimo non ha -l).

$ cd /tmp
$ cp /usr/share/man/man1/ls.1 .
$ man ls.1
No manual entry for ls.1
$ man ./ls.1     # works

Su Solaris, il -Mpassaggio a mansovrascriverà il percorso di ricerca per le pagine man: -

man -M path/to/man myprog

Il file manpage deve risiedere in una sottodirectory appropriata corrispondente alla sezione e al linguaggio di mark-up, ad esempio: path/to/man/man1/myprog.1per una pagina man nroff nella sezione 1.