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

NOM

       man2html - formate une page de manuel en html

SYNOPSIS

       man2html [options] [fichier]

DESCRIPTION

       man2html  convertit  une  page de manuel telle que trouvee dans fichier
       (ou l'entree standard stdin si aucun argument fichier n'est donne ou si
       l'argument << - >> est donne) a partir du format nroff (celui des pages
       de manuels) vers un format html et affiche le resultat  sur  la  sortie
       standard  (stdout).   man2html  supporte  tbl(1) mais ne connait rien a
       propos de eqn(1).  Le code de sortie est 0. Si quelque  chose  va  mal,
       une page d'erreur est affichee sur la sortie standard stdout.

       Cette  commande  peut  etre  utilisee  seule  mais a ete principalement
       concue pour etre un  auxiliaire  afin  que  les  utilisateurs  puissent
       naviguer  dans  les  pages  de  manuel  avec  un  navigateur html comme
       lynx(1), xmosaic(1) ou netscape(1).

       La plus grande partie de  man2html  est  l'engin  << troff-vers-html >>
       ecrit   par   Richard   Verhoeven  (rcb5@win.tue.nl).   Il  ajoute  des
       hyperliens aux constructions suivantes :

       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"

       (La premiere de celles-ci peut etre ajustee par des options - voir plus
       loin.)   Aucune  consultation n'est effectuee - les liens generes n'ont
       pas besoin d'exister. Un index avec des hyperliens  internes  vers  les
       diverses  sections est egalement cree rendant plus facile la navigation
       dans les grandes pages comme bash(1).

OPTIONS

       Lorsqu'on lit a partir de stdin,  il  n'est  pas  toujours  evident  de
       savoir  comment se fait l'expansion .so. L'option -D permet a un script
       de definir le repertoire de travail.

       -D chemin
              Retire les deux derniers  elements  du  chemin  et  effectue  un
              changement  de repertoire courant chdir(dir) avant de debuter la
              conversion.

       L'option -E option facilite  la  production  de  messages  d'erreurs  a
       partir de scripts cgi.

       -E cha^ine
              Produire  en  sortie  une  page  d'erreur  contenant  le message
              d'erreur donne.

       La forme generale d'un hyperlien genere pour  referencer  une  page  de
       manuel est

              <method:cgipath><man2htmlpath><separator><manpage>

       qui  est  d'ailleurs la forme par defaut. Les elements de cet hyperlien
       sont positionnes en utilisant diverses options.

       -h     Positionner  method:cgipath  a   http://localhost.    C'est   le
              comportement par defaut.

       -H h^ote[.domaine][:port]
              Positionner method:cgipath a http://h^ote.domaine:port.

       -l     Positionner method:cgipath a lynxcgi:/home/httpd.

       -L dir Positionner method:cgipath a lynxcgi:dir.

       -M man2htmlpath
              Positionner  le  chemin  vers man2html a utiliser. La valeur par
              defaut est /cgi-bin/man/man2html.

       -p     Positionner le separateur a << / >>.

       -q     Positionner le separateur a << ? >>. C'est la valeur par defaut.

       -r     Utiliser des chemins html relatifs plutot que les  chemins  cgi-
              bin.

       Sur  une machine sur laquelle httpd ne tourne pas, vous pouvez utiliser
       lynx pour naviguer dans les pages de manuel  en  utilisant  la  methode
       lynxcgi.   Lorsqu'un  demon  http  est en service, vous pouvez utiliser
       lynx ou n'importe quel autre navigateur pour  parcourir  les  pages  de
       manuel  en utilisant la methode http.  L'option -l (pour << lynxcgi >>)
       selectionne ce fonctionnement.  Avec elle, le chemin cgi par defaut est
       /home/httpd.

       En general, un script cgi peut etre appele de la facon suivante

              <path_to_script>/<more_path>?<query>

       et  les  variables  d'environnement  PATH_INFO  et  QUERY_STRING seront
       positionnees respectivement a <more_path> et <query>.  Puisque  lynxcgi
       ne  gere  pas  l'element  PATH_INFO, nous allons generer des hyperliens
       avec  << ? >>  comme  separateur  par  defaut.    L'option   -p   (pour
       << path >>) selectionne << / >> comme separateur, alors que l'option -q
       (for << query >>) selectionne << ? >>.

       L'option -H host specifiera l'hote a utiliser (a la  place  localhost).
       Un script cgi pourra utiliser

              man2html -H $SERVER_NAME

       si  la  variable  SERVER_NAME  est  positionnee. Cela permettra a votre
       machine de fonctionner en tant que  serveur  et  d'exporter  les  pages
       manuel.

BOGUES

       Il y a beaucoup d'heuristiques. La sortie produite ne sera pas toujours
       parfaite. La methode lynxcgi ne fonctionnera pas si lynx a ete  compile
       sans le support de celle-ci. Il peut y avoir des problemes de securite.

VOIR AUSSI

       lynx(1), man(1)

TRADUCTION

       Ce  document  est  une traduction realisee par Alain Portal <aportal AT
       univ-montp2 DOT fr> le 1er juin 2005 et mise a jour le 7 novembre 2005.

       L'equipe de traduction a fait le maximum pour realiser  une  adaptation
       francaise de qualite. La version anglaise la plus a jour de ce document
       est      toujours       consultable       via       la       commande :
       << LANG=en man 1 man2html >>.   N'hesitez  pas a signaler a l'auteur ou
       au traducteur, selon le cas, toute erreur dans cette page de manuel.