NOME

       man2html - formatta una pagina di manuale in html

SINTASSI

       man2html [options] [file]

DESCRIZIONE

       man2html  converte  una  pagina  di  manuale che si trova in file (o standard input (stdin); nel caso non
       venga fornito alcun file come argomento, o sia indicato "-", come argomento) dallo  stile  man  nroff  in
       html,  e  stampa  il risultato in standard output (stdout). Supporta tbl, ma non conosce eqn. Lo stato di
       uscita è 0. Se qualcosa va male viene stampata su stdout una pagina di errore.

       Può essere usato come utilità stand-alone, ma è pensato principalmente come ausilio per  permettere  agli
       utenti di navigare le proprie man page usando un browser html come lynx(1), xmosaic(1) o netscape(1).

       La   parte   principale  di  man2html  è  il  motore  da  troff  a  html  scritto  da  Richard  Verhoeven
       (rcb5@win.tue.nl). Esso aggiunge dei collegamenti ipertestuali per i seguenti costrutti:

       foo(3x)           "http://localhost/cgi-bin/man/man2html?3x+foo"
       method://string   "method://string"
       www.host.name     "http://www.host.name"
       ftp.host.name     "ftp://ftp.host.name"
       name@host         "mailto:name@host"
       <string.h>        "file:/usr/include/string.h"

       (Il primo di questi può essere controllato  dalle  opzioni  -  vedere  sotto).  Non  viene  fatto  nessun
       controllo - i collegamenti generati non sono necessari o indispensabili. Inoltre viene generato un indice
       con   collegamenti  interni  alle  varie  sezioni,  in  modo  che  sia  più  facile  effettuare  ricerche
       personalizzate in pagine di manuale grandi come bash(1).

OPZIONI

       Quando si legge da stdin non è sempre chiaro come effettuare l'espansione .so . L'opzione -D  permette  a
       uno script di definire la directory di lavoro.

       -D pathname
              Estrae le ultime due parti dal percorso, ed esegue chdir(dir) prima di iniziare la conversione.

       L'opzione -E permette una facile generazione di messaggi di errore da uno script cgi.

       -E string
              Genera una pagina di errore contenente il messaggio di errore che si è verificato.

       La forma generale di un collegamento ipertestuale creato per una man page di riferimento è

              <method:cgipath><man2htmlpath><separator><manpage>

       con  un  valore  predefinito  come  mostrato  sopra.  Le  parti  di questo collegamento ipertestuale sono
       impostate usando le varie opzioni.

       -h     Set method:cgipath to http://localhost. Questo è il valore predefinito.

       -H host[.domain][:port]
              Set method:cgipath to http://host.domain:port.

       -l     Set method:cgipath to lynxcgi:/home/httpd.

       -L dir Set method:cgipath to lynxcgi:dir.

       -M man2htmlpath
              Imposta il man2htmlpath da usare. Il valore predefinito è /cgi-bin/man/man2html.

       -p     Imposta '/' come separatore.

       -q     Imposta '?' come separatore. Questo è il valore predefinito.

       -r     Usa percorsi html relativi, invece dei percorsi cgi-bin.

       Su una macchina, senza eseguire httpd, si può usare lynx per navigare  le  man  page,  usando  il  metodo
       lynxcgi.  Quando  è  attivo  qualche  demone  http, lynx, o qualunque altro browser, può essere usato per
       navigare le man page, usando il metodo http. L'opzione -l  (per  `lynxcgi')  seleziona  il  comportamento
       precedente. Con esso, il valore predefinito di cgipath è /home/httpd.

       In generale, uno script cgi può essere chiamato da

              <path_to_script>/<more_path>?<query>

       e  le  variabili  d'ambiente PATH_INFO e QUERY_STRING verranno impostate rispettivamente in <more_path> e
       <query>. Poiché lynxcgi non gestisce la parte PATH_INFO, vengono generati collegamenti ipertestualil  con
       `?'  come  separatore  predefinito.  L'opzione  -p  (per  `path')  seleziona  '/' come separatore, mentre
       l'opzione -q (per `query') seleziona '?' come separatore.

       L'opzione -H host specificherà l'host da usare (invece di localhost). Uno script cgi può usare

              man2html -H $SERVER_NAME

       se è impostata la variabile SERVER_NAME . Questo permetterà alla propria macchina di comportarsi come  un
       server ed esportare man page.

BUG

       Ci  sono molti fattori difficilmente prevedibili. L'output potrebbe non essere sempre perfetto. Il metodo
       lynxcgi non funzionerà se lynx è stato compilato senza  selezionare  il  supporto  per  quest'ultimo.  Ci
       potrebbero essere problemi di sicurezza.

VEDERE ANCHE

       lynx(1), man(1)

                                                 1 gennaio 1998                                      man2html(1)