ADEMAN2HTML(1)              General Commands Manual             ADEMAN2HTML(1)



NAME
       ademan2html - convert man page sources to HTML

SYNOPSIS
       ademan2html  [  -V  |  --version  ] [ -v | --verbose | -d level | --de-
       bug=level ] [ -h | --help ] [ -p | --paths ] [  -n  |  --simulate  ]  [
       --full ]

DESCRIPTION
       Ademan2html  reads  man  page sources (see man(7)) and converts them to
       HTML. It calls nroff(1) to convert from man page source to a  formatted
       plaintext  that uses CTRL-H-based escape sequences for bold and italic.
       Ademan2html then converts this to HTML.

CONFIGURATION
       None.

OPTIONS
       -d level, --debug=level  Determines how verbose this program  will  be.
                                The  message types displayed for the different
                                values of level are as follows: 0 displays  no
                                messages;  1  displays only errors, 2 displays
                                errors and warnings; 3 displays errors,  warn-
                                ings and informational messages; higher values
                                display errors, warnings,  informational  mes-
                                sages and various messages intended for debug-
                                ging.  The default is 2.

       -h, --help               Displays a brief usage message.

       -p, --paths              Lists the compiled-in paths of  various  files
                                and  directories  that this program uses.  -n,
                                --simulate Some external  commands  that  this
                                program  runs may be displayed rather than ac-
                                tually executed.  BEWARE:  different  programs
                                implement  different  levels of simulation; so
                                this option may work perfectly; on  the  other
                                hand it may do nothing at all!

       -v, --verbose            Equivalent to -d 3.

       -V, --version            Prints the program's version number and exits.

       --full                   Encode  the  generated HTML in a standard HTML
                                prologue and epilogue.

EXIT STATUS
       On success ademan2html returns zero. On failure it returns non-zero and
       displays a diagnostic message.

FILES
       None.

ENVIRONMENT VARIABLES
       PATH                     Used to locate nroff(1)).

EXAMPLES
              zcat /usr/share/man/man1/ls.1.gz | ../bin/ademan2html --full > ~/public_html/ls.html

CAVEATS
       None.

STANDARDS
       This  manual  page  documents  version ADE_APP_TOKEN_RELEASE_ID of ade-
       man2html.

SEE ALSO
       nroff(1), man(1), man(7), ade-config(1)

AUTHOR
       ADE_APP_TOKEN_AUTHOR_NAME <ADE_APP_TOKEN_AUTHOR_EMAIL>

COPYRIGHT & DISTRIBUTION POLICY
       Copyright (C) 2004-ADE_APP_TOKEN_RELEASE_YEAR ADE_APP_TOKEN_AUTHOR_NAME

       This program is free software; you can redistribute it and/or modify it
       under  the  terms of the GNU General Public License as published by the
       Free Software Foundation; either version 2 of the License, or (at  your
       option) any later version.

       This  program  is  distributed  in the hope that it will be useful, but
       WITHOUT ANY  WARRANTY;  without  even  the  implied  warranty  of  MER-
       CHANTABILITY  or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU General
       Public License for more details.

       You should have received a copy of the GNU General Public License along
       with this program; if not, write to the Free Software Foundation, Inc.,
       675 Mass Ave, Cambridge, MA 02139, USA.



                        ADE_APP_TOKEN_RELEASE_DATE_MAN          ADEMAN2HTML(1)