Provided by: man2html_1.6f-3_i386 bug

NOM

       man2html - formate une page de manuel en html

SYNOPSIS

       man2html [options] [fichier]

DESCRIPTION

       man2html  convertit  une  page de manuel telle que trouvée dans fichier
       (ou l’entrée standard stdin si aucun argument fichier n’est donné ou si
       l’argument  « - »  est donné) à partir du format nroff (celui des pages
       de manuels) vers un format html et affiche le résultat  sur  la  sortie
       standard  (stdout).   man2html  supporte  tbl(1) mais ne connaît rien à
       propos de eqn(1).  Le code de sortie est 0. Si quelque  chose  va  mal,
       une page d’erreur est affichée sur la sortie standard stdout.

       Cette  commande  peut  être  utilisée  seule  mais a été principalement
       conçue pour être 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 » écrit
       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 première de celles-ci peut être ajustée par des options - voir plus
       loin.)   Aucune  consultation n’est effectuée - les liens générés n’ont
       pas besoin d’exister. Un index avec des hyperliens  internes  vers  les
       diverses  sections est également créé rendant plus facile la navigation
       dans les grandes pages comme bash(1).

OPTIONS

       Lorsqu’on lit à partir de stdin,  il  n’est  pas  toujours  évident  de
       savoir  comment se fait l’expansion .so. L’option -D permet à un script
       de définir le répertoire de travail.

       -D chemin
              Retire les deux derniers  éléments  du  chemin  et  effectue  un
              changement  de répertoire courant chdir(dir) avant de débuter la
              conversion.

       L’option -E option facilite  la  production  de  messages  d’erreurs  à
       partir de scripts cgi.

       -E chaîne
              Produire  en  sortie  une  page  d’erreur  contenant  le message
              d’erreur donné.

       La forme générale d’un hyperlien généré pour  référencer  une  page  de
       manuel est

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

       qui  est  d’ailleurs la forme par défaut. Les éléments de cet hyperlien
       sont positionnés en utilisant diverses options.

       -h     Positionner  method:cgipath  à   http://localhost.    C’est   le
              comportement par défaut.

       -H hte[.domaine][:port]
              Positionner method:cgipath à http://hte.domaine:port.

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

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

       -M man2htmlpath
              Positionner  le  chemin  vers man2html à utiliser. La valeur par
              défaut est /cgi-bin/man/man2html.

       -p     Positionner le séparateur à « / ».

       -q     Positionner le séparateur à « ? ». C’est la valeur par défaut.

       -r     Utiliser des chemins html relatifs plutôt 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  méthode
       lynxcgi.   Lorsqu’un  démon  http  est en service, vous pouvez utiliser
       lynx ou n’importe quel autre navigateur pour  parcourir  les  pages  de
       manuel  en  utilisant  la méthode http.  L’option -l (pour « lynxcgi »)
       sélectionne ce fonctionnement.  Avec elle, le chemin cgi par défaut est
       /home/httpd.

       En général, un script cgi peut être appelé de la façon suivante

              <path_to_script>/<more_path>?<query>

       et  les  variables  d’environnement  PATH_INFO  et  QUERY_STRING seront
       positionnées respectivement à <more_path> et <query>.  Puisque  lynxcgi
       ne  gère  pas  l’élément  PATH_INFO, nous allons générer des hyperliens
       avec « ? » comme séparateur par défaut.  L’option  -p  (pour  « path »)
       sélectionne   « / »  comme  séparateur,  alors  que  l’option  -q  (for
       « query ») sélectionne « ? ».

       L’option -H host spécifiera l’hôte à utiliser (à la  place  localhost).
       Un script cgi pourra utiliser

              man2html -H $SERVER_NAME

       si  la  variable  SERVER_NAME  est  positionnée. Cela permettra à 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 méthode lynxcgi ne fonctionnera pas si lynx a été  compilé
       sans le support de celle-ci. Il peut y avoir des problèmes de sécurité.

VOIR AUSSI

       lynx(1), man(1)

TRADUCTION

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

       L’équipe de traduction a fait le maximum pour réaliser  une  adaptation
       française de qualité. La version anglaise la plus à jour de ce document
       est toujours consultable via la commande :  « LANG=en man 1 man2html ».
       N’hésitez  pas  à  signaler  à l’auteur ou au traducteur, selon le cas,
       toute erreur dans cette page de manuel.