dummy_foundation/lib/XML/DOM/Parser.pod
changeset 4 60053dab7e2a
parent 3 8b87ea768cb8
child 5 842a773e65f2
child 6 c34a018f3291
--- 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<XML::Parser>
-
-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<http://www.w3.org/TR/REC-DOM-Level-1>.
-See the L<XML::Parser> 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<NoExpand> 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<XML::DOM::Document> 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<KeepCDATA> 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<http://www.erols.com/enno/xsa.xml>.
-It uses LWP to download the file and then calls parse() on the resulting string.
-By default it will use a L<LWP::UserAgent> 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.