Provided by: man2html-base_1.6g-16_amd64 
NUME
man2html - formatează o pagină de manual în html
SUMAR
man2html [opţuni] [fişier]
DESCRIERE
man2html converteşte o pagină de manual aşa cum se găseşte în fişier (sau intrarea standard (stdin), în
caz că argumentul fişier lipseşte, sau argumentul "-" este folosit) din stilul man nroff în html, şi
tipăreşte rezultatul la ieşirea standard (stdout). Suportă tbl dar nu ştie de eqn. Starea de ieşire este
0. Dacă ceva merge eronat, o pagină de eroare este tipărită la ieşirea standard (stdout).
Poate fi folosit ca un utilitar de sine stătător, dar este în 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ă legături pentru următoarele construcţii:
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"
(Primele din acestea pot fi modificate cu opţiuni - vezi mai jos.) Nici o verificare nu este făcută -
legăturile generate nu trebuie să existe. De asemenea, este generat un cuprins cu legături interne spre
diverse secţiuni, astfel încât este mai uşor pentru cineva să se descurce în paginile mari de manual ca
bash(1).
OPŢIUNI
Când se citeşte de la intrarea standard, nu este întotdeauna clar cum să se facă expansiunea .so.
Opţiunea -D permite unui script să definească directorul de lucru.
-D cale
Elimină ultimele două părţi din cale, şi face un chdir(dir) înainte de a începe conversia.
Opţiunea -E permite generarea uşoară a mesajelor de eroare dintr-un script cgi.
-E şir Produce o pagină de eroare conţinând mesajul de eroare dat.
Forma generală a unei legături 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. Părţile acestei legături sunt configurate folosind diverse opţiuni.
-h Configurează metodă:cele_cgi ca http://localhost. Această opţiune 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ă opţiune este implicită.
Pe o maşină care nu rulează httpd, se poate folosi lynx pentru a naviga prin paginile de manual, folosind
metoda lynxcgi. Când un demon http rulează, lynx, sau orice alt navigator, poate fi folosit pentru a
naviga prin paginile de manual, folosind metoda http. Opţiunea -l (pentru `lynxcgi') selectează
comportamentul precedent. Cu ea, cale_cgi este /home/httpd.
În general, un script cgi poate fi apelat prin
<cale_la_script>/<mai_multă_cale>?<cerere>
ş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, generăm legături cu `?' drept separator în
mod implicit. Opţiunea -p (de la eng. `path' (cale)) selectează '/' ca separator, în timp ce opţiunea -q
(de la eng. `query'(cerere)) selectează '?' ca separator.
Opţiunea -H gazdă va specifica gazda care va fi folosită (în loc de localhost). Un script cgi ar putea
folosi
man2html -H $SERVER_NAME
dacă variabila SERVER_NAME este configurată. Aceasta ar permite maşinii să se comporte ca un server şi să
exporte pagini de manual.
ERORI
Sunt multe euristici. Rezultatul nu va fi întotdeauna perfect. Metoda lynxcgi nu va funcţiona dacă lynx a
fost compilat fără a selecta suport pentru ea. Ar putea fi probleme de securitate.
VEZI ŞI
lynx(1), man(1) 1 Ianuarie 1998 man2html(1)