[PATCH 1/5] cygwin: faq-programming-6.21 add 5 required packages

[johnhaugabook@gmail.com]

From: John Haugabook <johnhaugabook@gmail.com>

Add 5 additional packages; for build: libtool; for dumper utility: libiconv, libiconv2; for documentation: perl-XML-SAX-Expat, docbook-utils. When building from a sandbox environment on Windows 11 using the packages currently listed in faq 6.21, I got the below error after calling "make":
"""""""""""""""
make[3]: Leaving directory '/home/WDAGUtilityAccount/build-newlib/x86_64-pc-cygwin/winsup/testsuite'
Making all in doc
make[3]: Entering directory '/home/WDAGUtilityAccount/build-newlib/x86_64-pc-cygwin/winsup/doc'
  GEN      Makefile.dep
  GEN      cygwin-ug-net/cygwin-ug-net.pdf
  GEN      cygwin-api/cygwin-api.pdf
  GEN      cygwin-api/cygwin-api.html
  etc...
  GEN      cygwin-api.info
could not find ParserDetails.ini in /usr/share/perl5/vendor_perl/5.40/XML/SAX
warning : xmlAddEntity: invalid redeclaration of predefined entity 'lt'
sh: line 1: /usr/bin/iconv: No such file or directory
-: warning: document without nodes
  GEN      cygwin-ug-net.info
could not find ParserDetails.ini in /usr/share/perl5/vendor_perl/5.40/XML/SAX
warning : xmlAddEntity: invalid redeclaration of predefined entity 'lt'
docbook2texi://refentry[@id='proc']/refnamediv: section is too deep
docbook2texi://refsect1[@id='proc-desc']: section is too deep
etc...
sh: line 1: /usr/bin/iconv: No such file or directory
-: warning: document without nodes
make[3]: *** [Makefile:721: cygwin-ug-net.info] Error 141
make[3]: Leaving directory '/home/WDAGUtilityAccount/build-newlib/x86_64-pc-cygwin/winsup/doc'
make[2]: *** [Makefile:398: all-recursive] Error 1
make[2]: Leaving directory '/home/WDAGUtilityAccount/build-newlib/x86_64-pc-cygwin/winsup'
make[1]: *** [Makefile:9464: all-target-winsup] Error 2
make[1]: Leaving directory '/home/WDAGUtilityAccount/build-newlib'
make: *** [Makefile:883: all] Error 2
"""""""""""""""

Added the packages: libtool, libiconv, libiconv2, perl-XML-SAX-Expat, and docbook-utils. Ran "make" again, and got another 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.
"""""""""""""""

which "[PATCH 3/4] cygwin: faq-programming-6.21 install tips" addresses, but after running command:
> perl -MXML::SAX -e 'XML::SAX->add_parser(q(XML::SAX::Expat)); XML::SAX->save_parsers()'

the error was resolved, and the install completed. But note - out of the several times I've gone through the installation, I have had to run this command twice; all but one of the installs failed for some reason.

In the case that someone is using a similar OS (Windows 10 and 11), architecture (x64-based PC), and/or verions of cygwin (3.6.3) for building cygwin from newlib-cygwin, this commit may prevent those errors from occuring. Additionally sorting the packages makes it easier to go down the list when selecting from the "Select Packages" GUI window from setup-x86_64.exe, making sure all packages have been checked.

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

diff --git a/winsup/doc/faq-programming.xml b/winsup/doc/faq-programming.xml
index a83429859..4daeb7079 100644
--- a/winsup/doc/faq-programming.xml
+++ b/winsup/doc/faq-programming.xml
@@ -676,17 +676,18 @@ rewriting the runtime library in question from specs...
 <answer>
 
 <para>First, you need to make sure you have the necessary build tools
-installed; you at least need <literal>gcc-g++</literal>,
-<literal>make</literal>, <literal>automake</literal>,
-<literal>autoconf</literal>, <literal>git</literal>, <literal>perl</literal>,
-<literal>cocom</literal> and <literal>patch</literal>.
+installed; you at least need <literal>autoconf</literal>,
+<literal>automake</literal>, <literal>cocom</literal>,
+<literal>gcc-g++</literal>, <literal>git</literal>,
+<literal>libtool</literal>, <literal>make</literal>,
+<literal>patch</literal>, and <literal>perl</literal>.
 </para>
 
 <para>
 Additionally, building the <code>dumper</code> utility requires
-<literal>gettext-devel</literal>, <literal>libiconv-devel</literal>, <literal>libzstd-devel</literal> and
-<literal>zlib-devel</literal>.  Building this program can be disabled with the
-<literal>--disable-dumper</literal> option to <literal>configure</literal>.
+<literal>gettext-devel</literal>, <literal>libiconv</literal>,
+<literal>libiconv-devel</literal>, <literal>libiconv2</literal>,
+<literal>libzstd-devel</literal>, and <literal>zlib-devel</literal>.
 </para>
 
 <para>
@@ -702,10 +703,11 @@ option to <literal>configure</literal>.
 
 <para>
 Building the documentation also requires the <literal>dblatex</literal>,
-<literal>docbook2X</literal>, <literal>docbook-xml45</literal>,
-<literal>docbook-xsl</literal>, and <literal>xmlto</literal> packages.  Building
-the documentation can be disabled with the <literal>--disable-doc</literal>
-option to <literal>configure</literal>.
+<literal>docbook-utils</literal>, <literal>docbook-xml45</literal>,
+<literal>docbook-xsl</literal>, <literal>docbook2X</literal>,
+<literal>perl-XML-SAX-Expat</literal>, and <literal>xmlto</literal>
+packages. Building the documentation can be disabled with the 
+<literal>--disable-doc</literal> option to <literal>configure</literal>.
 </para>
 
 <para>Next, check out the Cygwin sources from the
-- 
2.49.0.windows.1