Errors in building the documentation prevent compilation from completing properly

Errors in building the documentation prevent compilation from completing properly

[Denis Excoffier]

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)

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)
 
 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

Re: 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

Re: Errors in building the documentation prevent compilation from completing properly

[Denis Excoffier]

> On 2022-10-20 12:29, Jon Turney wrote:
> 
> 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'.

For me, '--disable-doc' makes no difference with the unpatched code. Same errors. Sorry.

Regards,

Denis Excoffier.

Re: Errors in building the documentation prevent compilation from completing properly

[Denis Excoffier]

> On 2022-10-20 19:46, Denis Excoffier wrote:
> 
>> On 2022-10-20 12:29, Jon Turney wrote:
>> 
>> 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'.
> 
> For me, '--disable-doc' makes no difference with the unpatched code. Same errors. Sorry.
> 
With cygwin-3.4.0-0.1, '--disable-doc’ now works as expected. Thank you.

Denis Excoffier.