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
|
'\" t
.\" Man page for man2html
.\" aeb, 980101
.\"
.\" Traducere de Ovidiu Constantin <ovidiu.soft@xnet.ro>
.TH man2html 1 "1 Ianuarie 1998"
.SH NUME
man2html \- formateaz o pagin de manual n html
.SH SUMAR
man2html [opuni] [fiier]
.SH DESCRIERE
.B man2html
convertete o pagin de manual aa cum se gsete n
.I fiier
(sau intrarea standard (stdin), n caz c argumentul fiier lipsete,
sau argumentul "-" este folosit) din stilul man nroff n html, i
tiprete rezultatul la ieirea standard (stdout). Suport tbl dar nu
tie de eqn. Starea de ieire este 0. Dac ceva merge eronat, o pagin
de eroare este tiprit la ieirea standard (stdout).
Poate fi folosit ca un utilitar de sine stttor, dar este n principal
conceput ca un auxiliar, pentru a permite utilizatorilor s navigheze
prin paginile de manual folosind un navigator html ca
.BR lynx (1),
.BR xmosaic (1)
sau
.BR netscape (1).
.\" (Vezi
.\" .BR man (1)
.\" pentru informaii despre cum s navighezi prin paginile de manual cu
.\" .BR man2html .
.\" De obicei este suficient adugarea "MANHTMLPAGER=/usr/bin/lynx"
.\" la mediu.)
Partea principal a
.B man2html
este motorul troff-to-html scris de Richard Verhoeven (rcb5@win.tue.nl).
Adaug legturi pentru urmtoarele construcii:
.LP
.TS
l l.
foo(3x) "http://localhost/cgi-bin/man/man2html?3x+foo"
method://ir "method://ir"
www.nume.gazd "http://www.nume.gazd"
ftp.nume.gazd "ftp://ftp.nume.gazd"
nume@gazd "mailto:nume@gazd"
<string.h> "file:/usr/include/string.h"
.TE
.LP
(Primele din acestea pot fi modificate cu opiuni - vezi mai jos.) Nici
o verificare nu este fcut - legturile generate nu trebuie s existe.
De asemenea, este generat un cuprins cu legturi interne spre diverse
seciuni, astfel nct este mai uor pentru cineva s se descurce n
paginile mari de manual ca
.BR bash (1).
.SH OPIUNI
Cnd se citete de la intrarea standard, nu este ntotdeauna clar cum s
se fac expansiunea .so. Opiunea \-D permite unui script s defineasc
directorul de lucru.
.LP
.TP
.B \-\^D cale
Elimin ultimele dou pri din cale, i face un
\fIchdir\fP(\fIdir\fP) nainte de a ncepe conversia.
.LP
Opiunea \-E permite generarea uoar a mesajelor de eroare dintr-un
script cgi.
.LP
.TP
.B \-\^E ir
Produce o pagin de eroare coninnd mesajul de eroare dat.
.LP
Forma general a unei legturi generate pentru o referin la o pagin
de manual este
.IP
<metod:cale_cgi><cale_man2html><separator><pagin_man>
.LP
cu o form implicit ca mai sus. Prile acestei legturi sunt
configurate folosind diverse opiuni.
.TP
.B \-\^h
Configureaz metod:cele_cgi ca http://localhost. Aceast opiune este implicit.
.TP
.BI \-\^H " gazd[.domeniu][:port]"
Configureaz metod:cale_cgi ca
.RI http:// gazd.domeniu:port .
.TP
.B \-\^l
Configureaz metod:cale_cgi ca
.RI lynxcgi: /home/httpd .
.TP
.BI \-\^L " dir"
Configureaz metod:cale_cgi ca
.RI lynxcgi: dir .
.TP
.BI \-\^M " cale_man2html"
Configureaz cale_man2html care va fi folosit. Implicit ea este
.IR /cgi-bin/man/man2html .
.TP
.B \-\^p
Configureaz separatorul ca '/'.
.TP
.B \-\^q
Configureaz separatorul ca '?'. Aceast opiune este implicit.
.LP
Pe o main care nu ruleaz
.BR httpd ,
se poate folosi
.B lynx
pentru a naviga prin paginile de manual, folosind metoda lynxcgi. Cnd
un demon http ruleaz, lynx, sau orice alt navigator, poate fi folosit
pentru a naviga prin paginile de manual, folosind metoda http. Opiunea
\-l (pentru `lynxcgi') selecteaz comportamentul precedent. Cu ea,
cale_cgi este \fI/home/httpd\fP.
n general, un script cgi poate fi apelat prin
.IP
<cale_la_script>/<mai_mult_cale>?<cerere>
.LP
i variabilele de mediu PATH_INFO i QUERY_STRING vor fi configurate ca
<mai_mult_cale> i respectiv <cere>. Din moment ce lynxcgi nu trateaz
partea PATH_INFO, generm legturi cu `?' drept separator n mod
implicit. Opiunea \-p (de la eng. `path' (cale)) selecteaz '/' ca
separator, n timp ce opiunea \-q (de la eng. `query'(cerere))
selecteaz '?' ca separator.
Opiunea \-H \fIgazd\fP va specifica gazda care va fi folosit (n loc
de \fIlocalhost\fP). Un script cgi ar putea folosi
.IP
man2html \-H $SERVER_NAME
.LP
dac variabila SERVER_NAME este configurat. Aceasta ar permite mainii
s se comporte ca un server i s exporte pagini de manual.
.SH ERORI
Sunt multe euristici. Rezultatul nu va fi ntotdeauna perfect. Metoda
lynxcgi nu va funciona dac lynx a fost compilat fr a selecta suport
pentru ea. Ar putea fi probleme de securitate.
.SH "VEZI I"
.BR lynx (1),
.BR man (1)
|
