From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out2.suse.de (smtp-out2.suse.de [IPv6:2001:67c:2178:6::1d]) by sourceware.org (Postfix) with ESMTPS id AB538385042A; Thu, 20 Oct 2022 15:50:10 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org AB538385042A Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=fail smtp.mailfrom=suse.cz Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by smtp-out2.suse.de (Postfix) with ESMTPS id 7D6C71FA0C; Thu, 20 Oct 2022 15:50:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1666281009; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=w3ZFLZ0Maa+cRstolgnS7vQzidxF75FC7wzUUdVsSyI=; b=pKSllGGfrdJsmLX2JttbmsqYBopYDN2MWSdVQ492xREdKQ2f+sP37p8impMjIkPZ+1SRa8 2ic4o9HoE1FOY3deBsmhbma4AOJcwwePDeDQVeVXtlWGrpyfc/obcnHFxE1CQsWU8sW/ty 8L4eouQln088LLuo7kLAUgPODFKAphA= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1666281009; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc: mime-version:mime-version:content-type:content-type: content-transfer-encoding:content-transfer-encoding: in-reply-to:in-reply-to:references:references; bh=w3ZFLZ0Maa+cRstolgnS7vQzidxF75FC7wzUUdVsSyI=; b=NPNSRgsV+WsL5UJivzGPOPhzsKp7hfop6WGigof6n9sDdLWD05ZumBtcKFLAOMK9L7cDHn hVO6jEVK8dgSXgCA== Received: from imap2.suse-dmz.suse.de (imap2.suse-dmz.suse.de [192.168.254.74]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits) key-exchange X25519 server-signature ECDSA (P-521) server-digest SHA512) (No client certificate requested) by imap2.suse-dmz.suse.de (Postfix) with ESMTPS id 5D63713494; Thu, 20 Oct 2022 15:50:09 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id MJLIFTFuUWNMEgAAMHmgww (envelope-from ); Thu, 20 Oct 2022 15:50:09 +0000 Message-ID: <2a4347ab-40a1-2afc-f48c-6d8290afb7c6@suse.cz> Date: Thu, 20 Oct 2022 17:50:08 +0200 MIME-Version: 1.0 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:102.0) Gecko/20100101 Thunderbird/102.3.3 Subject: Re: Announcement: Porting the Docs to Sphinx - 9. November 2022 Content-Language: en-US To: Joseph Myers Cc: Xi Ruoyao , GCC Patches , GCC Development , Sandra Loosemore References: <9975b774-46d7-8870-fd92-498f5ec50ab4@suse.cz> <9ea57a95-fefe-81a3-848e-ede0893f5b61@suse.cz> <8198573b-89e2-a232-3e33-0e5c4153c112@suse.cz> <494cee6fc68c06e039f46c3d6f8331a32e81ab5e.camel@linuxfromscratch.org> <7bae16bc-9069-4964-a80e-7ebff82e007e@suse.cz> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= In-Reply-To: Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-6.1 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,RCVD_IN_DNSWL_LOW,SPF_HELO_NONE,SPF_SOFTFAIL,TXREP autolearn=ham autolearn_force=no version=3.4.6 X-Spam-Checker-Version: SpamAssassin 3.4.6 (2021-04-09) on server2.sourceware.org List-Id: On 10/20/22 17:35, Joseph Myers wrote: > On Thu, 20 Oct 2022, Martin Liška wrote: > >>> Could generated man and info pages be provided as a tarball on >>> gcc.gnu.org or ftp.gnu.org? >> >> Not planning doing that. > > Release tarballs (but not snapshots) currently include the info files and > man pages, via gcc_release running a build with > --enable-generated-files-in-srcdir before building the tarball. > > I think they should continue to do so. This means: > > (a) --enable-generated-files-in-srcdir needs to cause those files to be > generated in the source directory, as it does at present. > > (b) gcc_release, for building a release but not a snapshot, needs to give > an error if Sphinx is missing or too old and so those files weren't built > properly (and thus people running gcc_release to build a release tarball > will need new-enough Sphinx). > > (c) It needs to be verified that building and installing from such a > release tarball works even if Sphinx is missing or too old - that is, that > it installs the prebuilt info / man files rather than giving an error or > failing to install them. > > Also, but not strictly part of the release issue: > > (d) Builds with missing or old Sphinx should work regardless of whether > such files are in the source directory - but if they aren't in the source > directory, the effect of missing or old Sphinx (detected at configure > time) should be to disable building and installing documentation. All right Joseph, is it something you're willing to help me once we start using Sphinx? Apparently, there will be many consequent steps after we switch. Cheers, Martin