From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp2.tsag.net (smtp2.tsag.net [208.118.68.91]) by sourceware.org (Postfix) with ESMTPS id 588CE3856DD9; Thu, 20 Oct 2022 02:27:10 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 588CE3856DD9 Authentication-Results: sourceware.org; dmarc=pass (p=quarantine dis=none) header.from=linuxfromscratch.org Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=linuxfromscratch.org Received: from linuxfromscratch.org (rivendell.linuxfromscratch.org [208.118.68.85]) (user=smtprelay@linuxfromscratch.org mech=PLAIN bits=0) by smtp2.tsag.net with ESMTP id 29K2R1Tu026414-29K2R1Tw026414 (version=TLSv1.2 cipher=ECDHE-RSA-AES256-GCM-SHA384 bits=256 verify=NO); Wed, 19 Oct 2022 20:27:02 -0600 Received: from [192.168.3.164] (unknown [36.44.140.67]) by linuxfromscratch.org (Postfix) with ESMTPSA id ACBB81C3396; Thu, 20 Oct 2022 02:26:59 +0000 (GMT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/simple; d=linuxfromscratch.org; s=cert4; t=1666232821; bh=wOyrkZXyAtb43NfJu0S0j1LsHnC4cwLrxMRO9USmrEU=; h=Subject:From:To:Cc:Date:In-Reply-To:References; b=cLaQOsdHWXSGQyuzW+M956KAfwo0t/lVPZErf0iHF6vts2HwkgRzkVuADMQB4N5Kp U4TadSCayY7IrOrBT5XGs5kOGIEyFyUyHegkiDI42Fkypha1R7AjiNIBj/a7cJRWAL 3aCKxIgOQj2AsZN0fRgWQwi0GiX5pbYgPNcQZnkjRZh3fWBfRLfFibJrRBDnEUKmLT RrhdJo/KCshFk3ELq8gb1Vf1RuzPp8Q1W0zzlb6cg1Wd0cSBYMkzkPW6l7QPfdOFgH tVryjCSnbMheMvAK+k5LHqwn575fk/LnWEvRDTNrRtNX3lW8NywnCb0DJDuwimV4z9 8dgeAlsUMnSSA== Message-ID: <494cee6fc68c06e039f46c3d6f8331a32e81ab5e.camel@linuxfromscratch.org> Subject: Re: Announcement: Porting the Docs to Sphinx - 9. November 2022 From: Xi Ruoyao To: Martin =?gb2312?Q?Li=810=948ka?= , GCC Patches , GCC Development Cc: Sandra Loosemore , "Joseph S. Myers" Date: Thu, 20 Oct 2022 10:26:54 +0800 In-Reply-To: <8198573b-89e2-a232-3e33-0e5c4153c112@suse.cz> References: <9975b774-46d7-8870-fd92-498f5ec50ab4@suse.cz> <9ea57a95-fefe-81a3-848e-ede0893f5b61@suse.cz> <8198573b-89e2-a232-3e33-0e5c4153c112@suse.cz> Content-Type: text/plain; charset="UTF-8" Content-Transfer-Encoding: quoted-printable User-Agent: Evolution 3.46.0 MIME-Version: 1.0 X-FEAS-Auth-User: smtprelay@linuxfromscratch.org X-FEAS-DKIM: Valid Authentication-Results: smtp2.tsag.net; dkim=pass header.i=@linuxfromscratch.org; dmarc=pass header.from=linuxfromscratch.org X-FE-Policy-ID: 0:14:3:linuxfromscratch.org X-Spam-Status: No, score=-1.6 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,KAM_EU,SPF_HELO_NONE,SPF_PASS 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: On Mon, 2022-10-17 at 15:28 +0200, Martin Li=C5=A1ka wrote: > Hello. >=20 > Based on the very positive feedback I was given at the Cauldron Sphinx Do= cumentation BoF, > I'm planning migrating the documentation on 9th November. There are still= some minor comments > from Sandra when it comes to the PDF output, but we can address that once= the conversion is done. >=20 > The reason I'm sending the email now is that I was waiting for latest Sph= inx release (5.3.0) that > simplifies reference format for options and results in much simpler Optio= n summary section ([1]) >=20 > The current GCC master (using Sphinx 5.3.0) converted docs can be seen he= re: > https://splichal.eu/scripts/sphinx/ >=20 > If you see any issues with the converted documentation, or have a feedbac= k about it, > please reply to this email. Ouch. This will be very painful for Linux From Scratch. We'll need to add 23 Python modules to build the documentation, while we only have 88 packages in total currently... And we don't want to omit GCC documentation in our system. Could generated man and info pages be provided as a tarball on gcc.gnu.org or ftp.gnu.org?