diff -r 8b87ea768cb8 -r 60053dab7e2a dummy_foundation/lib/XML/DOM/Parser.pod --- a/dummy_foundation/lib/XML/DOM/Parser.pod Wed Jun 03 18:33:51 2009 +0100 +++ /dev/null Thu Jan 01 00:00:00 1970 +0000 @@ -1,66 +0,0 @@ -=head1 NAME - -XML::DOM::Parser - An XML::Parser that builds XML::DOM document structures - -=head1 SYNOPSIS - - use XML::DOM; - - my $parser = new XML::DOM::Parser; - my $doc = $parser->parsefile ("file.xml"); - -=head1 DESCRIPTION - -XML::DOM::Parser extends L - -The XML::Parser module was written by Clark Cooper and -is built on top of XML::Parser::Expat, -which is a lower level interface to James Clark's expat library. - -XML::DOM::Parser parses XML strings or files -and builds a data structure that conforms to the API of the Document Object -Model as described at L. -See the L manpage for other additional properties of the -XML::DOM::Parser class. -Note that the 'Style' property should not be used (it is set internally.) - -The XML::Parser B option is more or less supported, in that it will -generate EntityReference objects whenever an entity reference is encountered -in character data. I'm not sure how useful this is. Any comments are welcome. - -As described in the synopsis, when you create an XML::DOM::Parser object, -the parse and parsefile methods create an L object -from the specified input. This Document object can then be examined, modified and -written back out to a file or converted to a string. - -When using XML::DOM with XML::Parser version 2.19 and up, setting the -XML::DOM::Parser option B to 1 will store CDATASections in -CDATASection nodes, instead of converting them to Text nodes. -Subsequent CDATASection nodes will be merged into one. Let me know if this -is a problem. - -=head1 Using LWP to parse URLs - -The parsefile() method now also supports URLs, e.g. I. -It uses LWP to download the file and then calls parse() on the resulting string. -By default it will use a L that is created as follows: - - use LWP::UserAgent; - $LWP_USER_AGENT = LWP::UserAgent->new; - $LWP_USER_AGENT->env_proxy; - -Note that env_proxy reads proxy settings from environment variables, which is what I need to -do to get thru our firewall. If you want to use a different LWP::UserAgent, you can either set -it globally with: - - XML::DOM::Parser::set_LWP_UserAgent ($my_agent); - -or, you can specify it for a specific XML::DOM::Parser by passing it to the constructor: - - my $parser = new XML::DOM::Parser (LWP_UserAgent => $my_agent); - -Currently, LWP is used when the filename (passed to parsefile) starts with one of -the following URL schemes: http, https, ftp, wais, gopher, or file (followed by a colon.) -If I missed one, please let me know. - -The LWP modules are part of libwww-perl which is available at CPAN.