Provided by: man2html-base_1.6g-6_i386 bug

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)