From: Grant McLean <grantm@us...> - 2003-09-09 09:35:14
Update of /cvsroot/perl-xml/xml-simple/lib/XML/Simple
In directory sc8-pr-cvs1:/tmp/cvs-serv31417/lib/XML/Simple
- fixed link to Perl XML FAQ
- added Q+A re deprecation of ParserOpts option
RCS file: /cvsroot/perl-xml/xml-simple/lib/XML/Simple/FAQ.pod,v
retrieving revision 1.4
retrieving revision 1.5
diff -u -d -r1.4 -r1.5
--- FAQ.pod 13 Jun 2003 10:28:05 -0000 1.4
+++ FAQ.pod 9 Sep 2003 09:35:11 -0000 1.5
@@ -126,7 +126,7 @@
If you're looking for a recommendation, I'd suggest you look at the Perl-XML
@@ -623,6 +623,23 @@
If you would prefer empty elements to be represented as empty strings or the
undefined value, set the 'suppressempty' option to '' or undef respectively.
+=head2 Why is ParserOpts deprecated?
+The C<ParserOpts> option is a remnant of the time when XML::Simple only worked
+with the XML::Parser API. Its value is completely ignored if you're using a
+SAX parser, so writing code which relied on it would bar you from taking
+advantage of SAX.
+Even if you are using XML::Parser, it is seldom necessary to pass options to
+the parser object. A number of people have written to say they use this option
+to set XML::Parser's C<ProtocolEncoding> option. Don't do that, it's wrong,
+Wrong, WRONG! Fix the XML document so that it's well-formed and you won't have
+Having said all of that, as long as XML::Simple continues to support the
+XML::Parser API, this option will not be removed. There are currently no plans
+to remove support for the XML::Parser API.