Errors in building the documentation prevent compilation from completing properly

[Jon Turney]

On 19/10/2022 18:57, Denis Excoffier wrote:
> Hello,
> 
> Currently i have docbook2X not working on my system (a perl problem
> that i don't know how to repair, but in a few months i will reinstall completely
> this C:\Cygwin64 which dates back to 2019).
> 
> This means that /usr/share/docbook2X and /usr/bin/docbook2x-texi are missing.
> Consequently, no *.info* file is produced.
> 
> Nevertheless, i tried to compile cygwin from sources (newlib-cygwin-3.3.6.tar.bz2),
> knowing that "Normally, building ignores any errors in building the documentation"
> (see https://cygwin.com/faq.html#faq.programming.building-cygwin)

The behaviour was changed by [1], but unfortunately the documentation 
change that contains has not yet been published.

Use the configure option '--disable-doc'.

[1] 
https://cygwin.com/git/?p=newlib-cygwin.git;a=commitdiff;h=f4a26ececa180cec70c41b6dd2082ff730f92065

> 
> However, in order to 'make' and then 'make install' properly, i had to apply the following
> easy patch (below).
> 
> Hope this helps,
> 
> Regards,
> 
> Denis Excoffier.
> 
> 
> diff -uNr o/newlib-cygwin/winsup/doc/Makefile.am p/newlib-cygwin/winsup/doc/Makefile.am
> --- o/newlib-cygwin/winsup/doc/Makefile.am	2022-09-05 13:09:51.000000000 +0200
> +++ p/newlib-cygwin/winsup/doc/Makefile.am	2022-10-19 14:00:03.052557100 +0200
> @@ -61,7 +61,7 @@
>   
>   install-info-local: cygwin-ug-net.info cygwin-api.info
>   	@$(MKDIR_P) $(DESTDIR)$(infodir)
> -	$(INSTALL_DATA) *.info* $(DESTDIR)$(infodir)
> +	-$(INSTALL_DATA) *.info* $(DESTDIR)$(infodir)

Ignoring errors here is (and always was) a terrible idea, frankly.

>   
>   install-etc:
>   	@$(MKDIR_P) $(DESTDIR)$(sysconfdir)/postinstall
> @@ -141,7 +141,7 @@
>   
>   # this generates a custom charmap for docbook2x-texi which has a mapping for ®
>   charmap:
> -	cp /usr/share/docbook2X/charmaps/texi.charmap charmap
> +	-cp /usr/share/docbook2X/charmaps/texi.charmap charmap
>   	echo "ae (R)" >>charmap
>   
>   intro2man.stamp: intro.xml man.xsl