[perl-xml-cvs] CVS: perl-xml-faq perl-xml-faq.xml,1.14,1.15

[Grant M. <gr...@us...>]

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>