https://sourceware.org/git/gitweb.cgi?p=newlib-cygwin.git;h=7f8813808adcad794ee3de9d27a117ed4213b2df
commit 7f8813808adcad794ee3de9d27a117ed4213b2df
Author: John Haugabook <johnhaugab...@gmail.com>
AuthorDate: Mon Jun 30 17:32:02 2025 -0400
Commit: Corinna Vinschen <cori...@vinschen.de>
CommitDate: Wed Jul 2 14:37:25 2025 +0200
cygwin: faq-programming-6.21 add 5 required packages
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 the error was resolved, and the install completed.
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 <johnhaugab...@gmail.com>
Diff:
---
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 a834298599d7..2ac6d0d8a8cd 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
