From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from esa3.mentor.iphmx.com (esa3.mentor.iphmx.com [68.232.137.180]) by sourceware.org (Postfix) with ESMTPS id BEAC3385043C; Thu, 20 Oct 2022 15:35:27 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org BEAC3385043C Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=codesourcery.com Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mentor.com X-IronPort-AV: E=Sophos;i="5.95,199,1661846400"; d="scan'208";a="84949342" Received: from orw-gwy-01-in.mentorg.com ([192.94.38.165]) by esa3.mentor.iphmx.com with ESMTP; 20 Oct 2022 07:35:18 -0800 IronPort-SDR: NJAio2L2dML2whs7c74AXlvTwYtdny5h1UEeqj12YX6HAiIdUcZ55BRVqSusJgAF+H6S03Vbks h9zMWpnG5OlklXVmm9zmnssZB1NJoFLrSPUXpz/CB/8Pud1km7JZLegFnbBLN2NMuOxL/V6pvW k5BPiOiO0utMMzCqW2r+RbN5LA0JhKWeszJXEhR3rCobK4FhHhUHhgqCMtsFRmjxdqXi6TH5Yh gk01Nqv+m/+F8Gra225XHkhJJcDIXNMy+X5WaBcS/L7++xEAENzeNH4mwCmg7ym74KVN2CPuZ2 1oo= Date: Thu, 20 Oct 2022 15:35:11 +0000 From: Joseph Myers X-X-Sender: jsm28@digraph.polyomino.org.uk To: =?ISO-8859-15?Q?Martin_Li=A8ka?= CC: Xi Ruoyao , GCC Patches , GCC Development , "Sandra Loosemore" Subject: Re: Announcement: Porting the Docs to Sphinx - 9. November 2022 In-Reply-To: <7bae16bc-9069-4964-a80e-7ebff82e007e@suse.cz> Message-ID: 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> User-Agent: Alpine 2.22 (DEB 394 2020-01-19) MIME-Version: 1.0 Content-Type: multipart/mixed; boundary="-1152306461-1480406025-1666280111=:71947" X-Originating-IP: [137.202.0.90] X-ClientProxiedBy: svr-ies-mbx-15.mgc.mentorg.com (139.181.222.15) To svr-ies-mbx-10.mgc.mentorg.com (139.181.222.10) X-Spam-Status: No, score=-3110.6 required=5.0 tests=BAYES_00,HEADER_FROM_DIFFERENT_DOMAINS,KAM_DMARC_STATUS,SPF_HELO_PASS,SPF_PASS,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 List-Id: ---1152306461-1480406025-1666280111=:71947 Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: 8BIT 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. -- Joseph S. Myers joseph@codesourcery.com ---1152306461-1480406025-1666280111=:71947--