From: John Haugabook <johnhaugab...@gmail.com>

One of the tips was mentioned in "[PATCH 1/4] cygwin: faq-programming-6.21 add 
5 required packages", which is the error:
"""""""""""""""
could not find ParserDetails.ini in /usr/share/perl5/vendor_perl/5.40/XML/SAX
Can't locate XML/SAX/Expat.pm in @INC (you may need to install the 
XML::SAX::Expat module) (@INC entries checked: 
/usr/local/lib/perl5/site_perl/5.40/x86_64-cygwin-threads 
/usr/local/share/perl5/site_perl/5.40 
/usr/lib/perl5/vendor_perl/5.40/x86_64-cygwin-threads 
/usr/share/perl5/vendor_perl/5.40 /usr/lib/perl5/5.40/x86_64-cygwin-threads 
/usr/share/perl5/5.40) at /usr/share/perl5/vendor_perl/5.40/XML/SAX.pm line 147.
"""""""""""""""

and running:
> perl -MXML::SAX -e 'XML::SAX-&gt;add_parser(q(XML::SAX::Expat)); 
> XML::SAX-&gt;save_parsers()'

will resolve this error. But note - out of the several times I've gone through 
the installation, I have had to run this command twice. All all but one of the 
installs it did not throw the error for some reason.

In the case that someone is using a similar OS (Windows 10 and 11), 
architecture (x64-based PC), and/or version of cygwin (3.6.3) for building 
cygwin from newlib-cygwin, this commit may prevent those errors from occurring.

Signed-off-by: John Haugabook <johnhaugab...@gmail.com>
---
 winsup/doc/faq-programming.xml | 12 ++++++++++++
 1 file changed, 12 insertions(+)

diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml
index fa3f097a9..093d05940 100644
--- a/winsup/doc/faq-programming.xml
+++ b/winsup/doc/faq-programming.xml
@@ -736,6 +736,18 @@ Otherwise, if you are trying to duplicate a cygwin release 
then you should
 download the corresponding source package
 (<literal>cygwin-x.y.z-n-src.tar.bz2</literal>). </para> 
 
+<para>
+<emphasis role='bold'>Tip:</emphasis> ensure Perl's XML::SAX module knows 
+about installed parsers by running:
+</para>
+<screen>perl -MXML::SAX -e 'XML::SAX-&gt;add_parser(q(XML::SAX::Expat)); 
XML::SAX-&gt;save_parsers()'</screen>
+
+<para>
+in the cygwin terminal. If an error appears, stating: 
+<code>could not find ParserDetails.ini ...</code>, then running the command 
+once more should resolve this.
+</para>
+
 <para>You <emphasis>must</emphasis> build cygwin in a separate directory from
 the source, so create something like a <literal>build/</literal> directory.
 Assuming you checked out the source to
-- 
2.49.0.windows.1

Reply via email to