From: John Haugabook <johnhaugab...@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 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> --- 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
