Update of /cvsroot/perl-xml/perl-xml-faq
In directory sc8-pr-cvs1:/tmp/cvs-serv6306
Modified Files:
perl-xml-faq.xml
Log Message:
- added question re ParserDetails.ini error
Index: perl-xml-faq.xml
===================================================================
RCS file: /cvsroot/perl-xml/perl-xml-faq/perl-xml-faq.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -d -r1.14 -r1.15
--- perl-xml-faq.xml 14 Dec 2003 09:24:20 -0000 1.14
+++ perl-xml-faq.xml 6 Jan 2004 08:57:05 -0000 1.15
@@ -895,6 +895,65 @@
</answer>
</qandaentry>
+ <qandaentry id="parserdetails.ini">
+ <question>
+ <para>"could not find ParserDetails.ini"</para>
+ </question>
+ <answer>
+
+ <para>A number of people have reported encountering the error "could not
+ find ParserDetails.ini in ..." when installing or attempting to use
+ <classname>XML::SAX</classname>. <filename>ParserDetails.ini</filename>
+ is used by <classname>XML::SAX::ParserFactory</classname> to determine
+ which SAX parser modules are installed. It should be created by the
+ <classname>XML::SAX</classname> installation script and should be updated
+ automatically by the install script for each SAX parser module.</para>
+
+ <itemizedlist mark="bullet">
+
+ <listitem><para>If you are installing <classname>XML::SAX</classname>
+ manually you must run <filename>Makefile.PL</filename>. Unpacking the
+ tarball and copying the files into your Perl lib directory will not
+ work.</para></listitem>
+
+ <listitem><para>During the initial installation, if you are asked whether
+ <filename>ParserDetails.ini</filename> should be updated, always say yes.
+ If you say no, the file will not be created.</para></listitem>
+
+ <listitem><para>If you are using ActivePerl, the following command should
+ resolve the problem: </para>
+
+ <programlisting><![CDATA[
+ppm install http://theoryx5.uwinnipeg.ca/ppms/XML-SAX.ppd
+ ]]></programlisting>
+
+ </listitem>
+
+ </itemizedlist>
+
+ <para>Once you have successfully installed
+ <classname>XML::SAX</classname>, you should consider installing a module
+ such as <classname>XML::SAX::Expat</classname> or
+ <classname>XML::LibXML</classname> to replace the slower pure-Perl parser
+ bundled with SAX.</para>
+
+ <para>If you are packaging <classname>XML::SAX</classname> in an
+ alternative distribution format (such as RPM), your post-install script
+ should check if <filename>ParserDetails.ini</filename> exists and if it
+ doesn't, run this command:</para>
+
+ <programlisting><![CDATA[
+perl -MXML::SAX -e "XML::SAX->add_parser(q(XML::SAX::PurePerl))->save_parsers()"
+ ]]></programlisting>
+
+ <para>Don't unconditionally run this command, or users who re-install
+ <classname>XML::SAX</classname> may find that any fast SAX parser they
+ have installed will be replaced as the default by the pure-Perl
+ parser.</para>
+
+ </answer>
+ </qandaentry>
+
</qandadiv>
<qandadiv id="xslt"><title>XSLT Support</title>
|
