From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out2.suse.de (smtp-out2.suse.de [195.135.220.29]) by sourceware.org (Postfix) with ESMTPS id 41FB13856156; Thu, 20 Oct 2022 11:27:49 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 41FB13856156 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=pass 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 5CACD1FD05; Thu, 20 Oct 2022 11:27:48 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1666265268; 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=eCBF2Ff+6KqpxPV33c+E+cGbprv3+puoNhNQJCHxpe8=; b=ldo9t0rNBE/zDwMeJeEepWzrSbqfEI00B6dJmv7Li6bn41wWO/zObbC+T/PN75XCK7fMyy EuSISSI2rRwTnM3fcFeOkR5GXZj1NIeMuBzjAqYYADaSZ7RsU2rlkj2phlNO+q+yjZwqWA nQNLlzwYaykPlBmJFbTYfhDVQwEE49c= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1666265268; 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=eCBF2Ff+6KqpxPV33c+E+cGbprv3+puoNhNQJCHxpe8=; b=HrEIAh/4NsCgOZjAIBihFJ++OaVssfgAw6KHCSCXGe3gfWYdYc3uj9LSPQA1GmbraHZqcA UUMC2dgC71dFNYCw== 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 3234813494; Thu, 20 Oct 2022 11:27:48 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id VM+UCrQwUWPmfwAAMHmgww (envelope-from ); Thu, 20 Oct 2022 11:27:48 +0000 Message-ID: <7bae16bc-9069-4964-a80e-7ebff82e007e@suse.cz> Date: Thu, 20 Oct 2022 13:27:47 +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: Xi Ruoyao , GCC Patches , GCC Development Cc: Sandra Loosemore , "Joseph S. Myers" 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> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= In-Reply-To: <494cee6fc68c06e039f46c3d6f8331a32e81ab5e.camel@linuxfromscratch.org> Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit X-Spam-Status: No, score=-5.7 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,KAM_EU,NICE_REPLY_A,SPF_HELO_NONE,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: On 10/20/22 04:26, Xi Ruoyao wrote: > On Mon, 2022-10-17 at 15:28 +0200, Martin Liška wrote: >> Hello. >> >> Based on the very positive feedback I was given at the Cauldron Sphinx Documentation 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. >> >> The reason I'm sending the email now is that I was waiting for latest Sphinx release (5.3.0) that >> simplifies reference format for options and results in much simpler Option summary section ([1]) >> >> The current GCC master (using Sphinx 5.3.0) converted docs can be seen here: >> https://splichal.eu/scripts/sphinx/ >> >> If you see any issues with the converted documentation, or have a feedback 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. Various other distros will have to face it too. The proper solution is a multi-build package (gcc:doc) which can be built later in the dependency chain. Btw. do you also provide PDF documentation in your system? > > Could generated man and info pages be provided as a tarball on > gcc.gnu.org or ftp.gnu.org? Not planning doing that. Cheers, Martin