Provided by:
man2html-base_1.6g-6_i386 
NUME
man2html - formateaz o pagin de manual in html
SUMAR
man2html [opuni] [fisier]
DESCRIERE
man2html converteste o pagin de manual asa cum se gseste in fi,sier (sau
intrarea standard (stdin), in caz c argumentul fisier lipseste, sau
argumentul "-" este folosit) din stilul man nroff in html, si tipreste
rezultatul la iesirea standard (stdout). Suport tbl dar nu stie de eqn.
Starea de iesire este 0. Dac ceva merge eronat, o pagin de eroare este
tiprit la iesirea standard (stdout).
Poate fi folosit ca un utilitar de sine stttor, dar este in principal
conceput ca un auxiliar, pentru a permite utilizatorilor s navigheze
prin paginile de manual folosind un navigator html ca lynx(1),
xmosaic(1) sau netscape(1).
Partea principal a man2html este motorul troff-to-html scris de Richard
Verhoeven (rcb5@win.tue.nl). Adaug legturi pentru urmtoarele
construcii:
foo(3x) "http://localhost/cgi-bin/man/man2html?3x+foo"
method://sir "method://sir"
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"
(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 incat este mai usor pentru cineva s se descurce in
paginile mari de manual ca bash(1).
OPIUNI
Cand se citeste de la intrarea standard, nu este intotdeauna clar cum s
se fac expansiunea .so. Opiunea -D permite unui script s defineasc
directorul de lucru.
-D cale
Elimin ultimele dou pri din cale, si face un chdir(dir) inainte
de a incepe conversia.
Opiunea -E permite generarea usoar a mesajelor de eroare dintr-un
script cgi.
-E ,sir Produce o pagin de eroare coninand mesajul de eroare dat.
Forma general a unei legturi generate pentru o referin la o pagin de
manual este
<metod:cale_cgi><cale_man2html><separator><pagin_man>
cu o form implicit ca mai sus. Prile acestei legturi sunt configurate
folosind diverse opiuni.
-h Configureaz metod:cele_cgi ca http://localhost. Aceast opiune
este implicit.
-H gazd[.domeniu][:port]
Configureaz metod:cale_cgi ca http://gazd.domeniu:port.
-l Configureaz metod:cale_cgi ca lynxcgi:/home/httpd.
-L dir Configureaz metod:cale_cgi ca lynxcgi:dir.
-M cale_man2html
Configureaz cale_man2html care va fi folosit. Implicit ea este
/cgi-bin/man/man2html.
-p Configureaz separatorul ca '/'.
-q Configureaz separatorul ca '?'. Aceast opiune este implicit.
Pe o masin care nu ruleaz httpd, se poate folosi lynx pentru a naviga
prin paginile de manual, folosind metoda lynxcgi. Cand 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
/home/httpd.
In general, un script cgi poate fi apelat prin
<cale_la_script>/<mai_mult_cale>?<cerere>
si variabilele de mediu PATH_INFO si QUERY_STRING vor fi configurate ca
<mai_mult_cale> si respectiv <cere>. Din moment ce lynxcgi nu trateaz
partea PATH_INFO, generm legturi cu `?' drept separator in mod
implicit. Opiunea -p (de la eng. `path' (cale)) selecteaz '/' ca
separator, in timp ce opiunea -q (de la eng. `query'(cerere)) selecteaz
'?' ca separator.
Opiunea -H gazd va specifica gazda care va fi folosit (in loc de
localhost). Un script cgi ar putea folosi
man2html -H $SERVER_NAME
dac variabila SERVER_NAME este configurat. Aceasta ar permite masinii s
se comporte ca un server si s exporte pagini de manual.
ERORI
Sunt multe euristici. Rezultatul nu va fi intotdeauna perfect. Metoda
lynxcgi nu va funciona dac lynx a fost compilat fr a selecta suport
pentru ea. Ar putea fi probleme de securitate.
VEZI ,SI
lynx(1), man(1)
1 Ianuarie 1998 man2html(1)