From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from smtp-out1.suse.de (smtp-out1.suse.de [195.135.220.28]) by sourceware.org (Postfix) with ESMTPS id 6E78F3856157; Thu, 20 Oct 2022 11:53:10 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 6E78F3856157 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-out1.suse.de (Postfix) with ESMTPS id 45FBD33A84; Thu, 20 Oct 2022 11:53:09 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1666266789; 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=MDUAYftwMHGwljuCrHo0ib+U3sHcbqxrq2lML8wI7hU=; b=EJrSpRWRnqWSIMihRUlsxezQyFPc0b6YWfrkaWQfQRy0JK8HTMjlh21xrUCMOJcQYmTScQ Z9QuLVPblC2KQkcilsgkJXv0/mXAAZGIvPgoQ9fScnTL1nokvj0fMNGOFT3IsZdgyKC0KE JXQbG97S3tM1KrzyTK1h0wryJ4Q/4Fc= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1666266789; 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=MDUAYftwMHGwljuCrHo0ib+U3sHcbqxrq2lML8wI7hU=; b=HwunnH19GiBnwL82kEK2sB3sy5JAm3r9Ab0Km1jDl1J9AusPl3QwnlXqkjgZ0ZqjjaE5pz zg3BcFcAqc5WZbCA== 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 0F2D813494; Thu, 20 Oct 2022 11:53:09 +0000 (UTC) Received: from dovecot-director2.suse.de ([192.168.254.65]) by imap2.suse-dmz.suse.de with ESMTPSA id iRG3AqU2UWOdEAAAMHmgww (envelope-from ); Thu, 20 Oct 2022 11:53:09 +0000 Message-ID: <1d5c952d-5101-3c53-dfde-df139f67d1b4@suse.cz> Date: Thu, 20 Oct 2022 13:53: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: 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> 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=-5.9 required=5.0 tests=BAYES_00,DKIM_SIGNED,DKIM_VALID,DKIM_VALID_AU,DKIM_VALID_EF,NICE_REPLY_A,SPF_HELO_NONE,SPF_PASS,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: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. Martin > >>> Could generated man and info pages be provided as a tarball on >>> gcc.gnu.org or ftp.gnu.org? >> >> Not planning doing that.