NAME

    html2plain.pl - HTML to plain text converter
    

SYNOPSIS

    html2plain.pl [options] [source directory ...]

  Options:

    --html-ext                HTML file identifying filename extension
    --out-ext                 output filename extension
    --out-dir                 output directory
    --N-per-out-dir           # of records per output directory
    --source-encoding         the encoding of the HTML files
    --[no]assert-html         assert that the document is HTML
    --[no]symbolic-char-entities-to-chars
                              convert symbolic character entities to UTF-8
                              characters
    --[no]numerical-char-entities-to-chars
                              convert numerical character entities to UTF-8
                              characters
    --[no]clean-whitespace    remove redundant whitespace
    --[no]assert-assumptions  assert that the document is in UTF-8 and contains
                              before actually converting to plain text
    --help                    brief help message
    --man                     full documentation
    --[no]warnings            warnings output flag
    

OPTIONS

--html-ext
    Sets the HTML file identifying filename extension. 
    Default value: 'html'.
--out-ext
    Sets the output filename extension. 
    Default value: 'plain'.
--out-dir
    Sets the output directory. Default value: '.'.
--N-per-out-dir
    Sets the # of records per output directory. Default value: 1000.
--source-encoding
    Specifies the encoding of the HTML files. Default value undef,
    which means that the encoding is guessed for each document.
--[no]assert-html
    Specifies whether it is asserted that the document actually looks like
    HTML before trying to convert. Default: yes.
--[no]symbolic-char-entities-to-chars
    Specifies whether symbolic character entities are converted to 
    UTF-8 characters. Default: yes.
--[no]numerical-char-entities-to-chars
    Specifies whether numerical character entities are converted to 
    UTF-8 characters. Default: yes.
--[no]clean-whitespace
    Specifies whether redundant whitespace is removed from the output.
    Default: yes.
--[no]assert-assumptions
    Specifies whether assumptions about the source are validated before
    trying to convert (that it is in UTF-8 (converted to internally) and
    contains no '\0's. Default: yes.
--help
    Prints a brief help message and exits.
--man
    Prints the manual page and exits.
--[no]warnings
    Output (or suppress) warnings. Default value: yes.

DESCRIPTION

    Goes recursively through the HTML files under the source directory
    and converts their textual content to plain text files. 
    The output is in UTF-8.