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 970E638515CA; Thu, 20 Oct 2022 12:26:21 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 970E638515CA 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 86D8520656; Thu, 20 Oct 2022 12:26:20 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1666268780; 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=P9ASSX2Lo1tUnx8JGidK5X/v78ebFO7OqMBy9o/F0jo=; b=YNPgnJyQCXaC9d8Ob6PxomKWuE3NJvm138T1hmAxa/sCirbvv58Rs8GratyzFFBJC7B0Zf ZnGFMdRF6IJJup+44LRAXpYpG7J+N3JLpywTkVpBRLtaVfS/5eSWeBcypqZsTLfUh0UOJX H9U6Vmkome1OqwheeLkda3ZeGV+1ooc= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1666268780; 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=P9ASSX2Lo1tUnx8JGidK5X/v78ebFO7OqMBy9o/F0jo=; b=sKroenNvtVchDyYxa0x/zguyz1ZrL/+Jbb0v0Y2IQODOa0NF8GhVZaTOLrjVRtoIo/eByV swggb/uVTTdlSGAQ== 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 58FE713AF5; Thu, 20 Oct 2022 12:26:20 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id 0u7QFGw+UWP3IgAAMHmgww (envelope-from ); Thu, 20 Oct 2022 12:26:20 +0000 Message-ID: <05e91cf6-204e-4742-85ed-98b2a91b5c43@suse.cz> Date: Thu, 20 Oct 2022 14:26:19 +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 To: Xi Ruoyao , GCC Patches , GCC Development Cc: Sandra Loosemore , "Joseph S. Myers" , Bruce Dubbs , Pierre Labastie , "Douglas R. Reno" 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> <1d5c952d-5101-3c53-dfde-df139f67d1b4@suse.cz> Content-Language: en-US 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 13:55, Xi Ruoyao wrote: > On Thu, 2022-10-20 at 13:53 +0200, Martin Liška wrote: >> On 10/20/22 13:49, Xi Ruoyao wrote: >>> (CC our team members.) >>> >>> On Thu, 2022-10-20 at 13:27 +0200, Martin Liška wrote: >>>>> 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? >>> >>> No (texlive is much heavier than Sphinx).  But generally we expect man >>> pages and info pages. >>> >>> We can separate man and info into the second-time build in BLFS (we're >>> already doing this now for Go, Objective C, etc.), >> >> Do the same for GCC. >> >>> but I don't really >>> like to omit the man and info pages.. >> >> What should I do about it? We want to switch to a more modern documentation tool >> called Sphinx and yes, it will make packaging of the GCC more complicated. > > Nothing, I guess. We'll handle it on our side (if we finally decide to > ship the man/info tarballs we can generate them by ourselves). Good! > > I was just trying to find a simpler solution before beginning all the > work :). Sure, makes sense. Martin > > Thanks! >