HTML::Parse - Depreciated

SYNOPSIS

        use HTML::Parse;
        $h = parse_htmlfile("test.html");
        print $h->dump;
        $h = parse_html("<p>Some more <i>italic</i> text", $h);
        $h->delete;

        print parse_htmlfile("index.html")->as_HTML;  # tidy up markup in a file

DESCRIPTION

       Disclaimer: This module is only provided for backwards
       compatibility with earlier versions of this library.  New
       code shold use the HTML::Parser and HTML::TreeBuilder
       modules directly.

       The HTML::Parse module provides functions to parse HTML
       documents.  There are two functions exported by this
       module:

       parse_html($html, [$obj])
           This function is really just a synonym for
           $obj->parse($html) and $obj is assumed to be a
           subclass of HTML::Parser.  Refer to the HTML::Parser
           manpage for more documentation.

           The $obj will default to an internally created
           HTML::TreeBuilder object configured with
           strict_comment() turned on.  This class implements a
           parser that builds (and is) a HTML syntax tree with
           HTML::Element objects as nodes.

           The return value from parse_html() is $obj.

       parse_htmlfile($file, [$obj])
           Same as parse_html(), but obtains HTML text from the
           named file.

           Returns undef if the file could not be opened, or $obj
           otherwise.

       When a HTML::TreeBuilder object is created, the following
       variables control how parsing takes place:

       $HTML::Parse::IMPLICIT_TAGS
           Setting this variable to true will instruct the parser
           to try to deduce implicit elements and implicit end
           tags.  If this variable is false you get a parse tree
           that just reflects the text as it stands.  Might be
           useful for quick & dirty parsing.  Default is true.

       $HTML::Parse::IGNORE_UNKNOWN
           This variable contols whether unknow tags should be
           represented as elements in the parse tree.  Default is
           true.

       $HTML::Parse::IGNORE_TEXT
           Do not represent the text content of elements.  This
           saves space if all you want is to examine the
           structure of the document.  Default is false.

       $HTML::Parse::WARN
           Call warn() with an apropriate message for syntax
           errors.  Default is false.

SEE ALSO

       the HTML::Parser manpage, the HTML::TreeBuilder manpage,
       the HTML::Element manpage

COPYRIGHT

       Copyright 1995-1996 Gisle Aas. All rights reserved.

       This library is free software; you can redistribute it
       and/or modify it under the same terms as Perl itself.

AUTHOR

       Gisle Aas <aas@sn.no>