X-Recipient: archive-cygwin AT delorie DOT com
X-Original-To: cygwin AT cygwin DOT com
Delivered-To: cygwin AT cygwin DOT com
DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 7126038561B8
Authentication-Results: sourceware.org; dmarc=none (p=none dis=none)
 header.from=dronecode.org.uk
Authentication-Results: sourceware.org; spf=none smtp.mailfrom=dronecode.org.uk
Authentication-Results: btinternet.com;
 auth=pass (PLAIN) smtp.auth=jonturney AT btinternet DOT com;
 bimi=skipped
X-SNCR-Rigid: 62E573CC0CD61E1A
X-Originating-IP: [81.129.146.151]
X-OWM-Source-IP: 81.129.146.151 (GB)
X-OWM-Env-Sender: jonturney AT btinternet DOT com
X-VadeSecure-score: verdict=clean score=0/300, class=clean
X-RazorGate-Vade: gggruggvucftvghtrhhoucdtuddrgedvfedrfeeliedgvddvucetufdoteggodetrfdotffvucfrrhhofhhilhgvmecuueftkffvkffujffvgffngfevqffopdfqfgfvnecuuegrihhlohhuthemuceftddunecusecvtfgvtghiphhivghnthhsucdlqddutddtmdenucfjughrpefkffggfgfuvfhfhfgjtgfgsehtjeertddtfeejnecuhfhrohhmpeflohhnucfvuhhrnhgvhicuoehjohhnrdhtuhhrnhgvhiesughrohhnvggtohguvgdrohhrghdruhhkqeenucggtffrrghtthgvrhhnpeehudeuveeujeeujeegueefhedttdekvedtudeileefteetfeefjeejudekfefggfenucffohhmrghinheptgihghifihhnrdgtohhmnecukfhppeekuddruddvledrudegiedrudehudenucevlhhushhtvghrufhiiigvpedtnecurfgrrhgrmhephhgvlhhopegludelvddrudeikedruddruddtiegnpdhinhgvthepkedurdduvdelrddugeeirdduhedupdhmrghilhhfrhhomhepjhhonhdrthhurhhnvgihsegurhhonhgvtghouggvrdhorhhgrdhukhdpnhgspghrtghpthhtohepvddprhgtphhtthhopegthihgfihinhesffgvnhhishdqgfigtghofhhfihgvrhdrohhrghdprhgtphhtthhopegthihgfihinhestgihghifihhnrdgtohhm
X-RazorGate-Vade-Verdict: clean 0
X-RazorGate-Vade-Classification: clean
Message-ID: <ee940ded-db00-2543-0de8-552e2c40c30b@dronecode.org.uk>
Date: Thu, 20 Oct 2022 11:29:39 +0100
MIME-Version: 1.0
User-Agent: Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:102.0) Gecko/20100101
 Thunderbird/102.3.3
Subject: Re: Errors in building the documentation prevent compilation from
 completing properly
To: Denis Excoffier <cygwin AT Denis-Excoffier DOT org>,
        The Cygwin Mailing List <cygwin AT cygwin DOT com>
References: <FD4CA95F-913A-44F3-97C9-7AD076E8A991 AT Denis-Excoffier DOT org>
Content-Language: en-GB
From: Jon Turney <jon DOT turney AT dronecode DOT org DOT uk>
In-Reply-To: <FD4CA95F-913A-44F3-97C9-7AD076E8A991@Denis-Excoffier.org>
X-Spam-Status: No, score=-3570.2 required=5.0 tests=BAYES_00, FORGED_SPF_HELO,
 KAM_DMARC_STATUS, KAM_LAZY_DOMAIN_SECURITY, NICE_REPLY_A, RCVD_IN_DNSWL_NONE,
 SPF_HELO_PASS, SPF_NONE, TXREP autolearn=no autolearn_force=no version=3.4.6
X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on
 server2.sourceware.org
X-BeenThere: cygwin AT cygwin DOT com
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: General Cygwin discussions and problem reports <cygwin.cygwin.com>
List-Unsubscribe: <https://cygwin.com/mailman/options/cygwin>,
 <mailto:cygwin-request AT cygwin DOT com?subject=unsubscribe>
List-Archive: <https://cygwin.com/pipermail/cygwin/>
List-Post: <mailto:cygwin AT cygwin DOT com>
List-Help: <mailto:cygwin-request AT cygwin DOT com?subject=help>
List-Subscribe: <https://cygwin.com/mailman/listinfo/cygwin>,
 <mailto:cygwin-request AT cygwin DOT com?subject=subscribe>
Content-Transfer-Encoding: 7bit
Content-Type: text/plain; charset="us-ascii"; Format="flowed"
Errors-To: cygwin-bounces+archive-cygwin=delorie DOT com AT cygwin DOT com
Sender: "Cygwin" <cygwin-bounces+archive-cygwin=delorie DOT com AT cygwin DOT com>

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 &reg;
>   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


-- 
Problem reports:      https://cygwin.com/problems.html
FAQ:                  https://cygwin.com/faq/
Documentation:        https://cygwin.com/docs.html
Unsubscribe info:     https://cygwin.com/ml/#unsubscribe-simple