1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
|
man2html(1) General Commands Manual man2html(1)
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). Sup-
porta tbl, ma non conosce eqn. Lo stato di uscita `e 0. Se qualcosa va male viene stampata
su stdout una pagina di errore.
Pu`o essere usato come utilit`a stand-alone, ma `e 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 `e il motore da troff a html scritto da Richard Verhoeven
(rcb5@win.tue.nl). Esso aggiunge dei collegamenti ipertestuali per i seguenti costrutti:
l l. 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`o 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`u
facile effettuare ricerche personalizzate in pagine di manuale grandi come bash(1).
OPZIONI
Quando si legge da stdin non `e sempre chiaro come effettuare l'espansione
L'opzione -D permette a uno script di definire ladirectory 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 `e verificato.
La forma generale di un collegamento ipertestuale creato per una man page di riferimento `e
<method:cgipath><man2htmlpath><separator><manpage>
con un valore predefinito come mostrato sopra. Le parti di questo collegamento ipertes-
tuale sono impostate usando le varie opzioni.
-h Set method:cgipath to http://localhost. Questo `e 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 `e /cgi-bin/man/man2html.
-p Imposta '/' come separatore.
-q Imposta '?' come separatore. Questo `e il valore predefinito.
-r Usa percorsi html relativi, invece dei percorsi cgi-bin.
Su una macchina, senza eseguire httpd, si pu`o usare lynx per navigare le man page, usando
il metodo lynxcgi. Quando `e attivo qualche demone http, lynx, o qualunque altro browser,
pu`o 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 cgi-
path `e /home/httpd.
In generale, uno script cgi pu`o 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'e 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 sepa-
ratore.
L'opzione -H host specificher`a l'host da usare (invece di localhost). Uno script cgi pu`o
usare
man2html -H $SERVER_NAME
se `e impostata la variabile SERVER_NAME . Questo permetter`a alla propria macchina di com-
portarsi come un server ed esportare man page.
BUG
Ci sono molti fattori difficilmente prevedibili. L'output potrebbe non essere sempre per-
fetto. Il metodo lynxcgi non funzioner`a se lynx `e 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)
|