NAME

       XML::Handler::BuildDOM - PerlSAX handler that creates XML::DOM document structures

SYNOPSIS

        use XML::Handler::BuildDOM;
        use XML::Parser::PerlSAX;

        my $handler = new XML::Handler::BuildDOM (KeepCDATA => 1);
        my $parser = new XML::Parser::PerlSAX (Handler => $handler);

        my $doc = $parser->parsefile ("file.xml");

DESCRIPTION

       XML::Handler::BuildDOM creates XML::DOM document structures (i.e. XML::DOM::Document) from
       PerlSAX events.

       This class used to be called XML::PerlSAX::DOM prior to libxml-enno 1.0.1.

   CONSTRUCTOR OPTIONS
       The XML::Handler::BuildDOM constructor supports the following options:

       •   KeepCDATA => 1

           If set to 0 (default), CDATASections will be converted to regular text.

       •   Document => $doc

           If undefined, start_document will extract it from Element or DocType (if set),
           otherwise it will create a new XML::DOM::Document.

       •   Element => $elem

           If undefined, it is set to Document. This will be the insertion point (or parent) for
           the nodes defined by the following callbacks.

       •   DocType => $doctype

           If undefined, start_document will extract it from Document (if possible).  Otherwise
           it adds a new XML::DOM::DocumentType to the Document.