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 A007E383B403; Tue, 1 Jun 2021 07:31:23 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org A007E383B403 Authentication-Results: sourceware.org; dmarc=none (p=none dis=none) header.from=suse.cz Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=mliska@suse.cz Received: from imap.suse.de (imap-alt.suse-dmz.suse.de [192.168.254.47]) (using TLSv1.2 with cipher ECDHE-ECDSA-AES128-GCM-SHA256 (128/128 bits)) (No client certificate requested) by smtp-out1.suse.de (Postfix) with ESMTPS id 5952F21920; Tue, 1 Jun 2021 07:31:22 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1622532682; 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=deJt8aH/pN+6/BkTNm10SsoMvV9Whdpx46wgvsEPHnI=; b=GxPqdHMS8bJYXcKxx9LmGL7Wcm0wzMJvUi4Fyj+sG01gu9+kiAFE9+DD7AYJBfgetGgORv DVa8k3xWYD2pQq4/WwOgC0Pl3hTk8ojbOgYXUK7VlJ9xbYOL/+uVYG+FDatUcV6TJH58p5 MtS7kELBKRsY5FFfaK4d1RCxD9fFIjQ= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1622532682; 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=deJt8aH/pN+6/BkTNm10SsoMvV9Whdpx46wgvsEPHnI=; b=ul6LmUq4oOPKqXu9LDqeNNNJO6K+9JECCtUO+RnyJ635eZH1ExJNnQCq7NdohyPRNdD3G1 UjLsQJkxYaaD2FDw== Received: from imap3-int (imap-alt.suse-dmz.suse.de [192.168.254.47]) by imap.suse.de (Postfix) with ESMTP id 9B165118DD; Tue, 1 Jun 2021 07:31:21 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1622532681; 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=deJt8aH/pN+6/BkTNm10SsoMvV9Whdpx46wgvsEPHnI=; b=mDPAVD6B/MYIdenZQyi9j0RsE19In/N2F3JKuJ3cAAybuCPTUoRFDuUZWV+iPiUJX7swbM YvuKqyz+OsFd43qnSrHEAClMkCBcXC+EmXw3vTT8pFO5joSrdU8wQQlFyHSLxW/TIrva7W TI8mcpBxtk2nkdPKzj466HJRUgmgJdc= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1622532681; 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=deJt8aH/pN+6/BkTNm10SsoMvV9Whdpx46wgvsEPHnI=; b=1Ufgswx6TqC2Y6thYVMv3fxmYWdsYY55qtPfT/VhJ6u6eC+jzfmGG6rqiO2esoaqAusx0O +kSzuyVf4dvh8kAQ== Received: from director2.suse.de ([192.168.254.72]) by imap3-int with ESMTPSA id 2WTJJEnitWAQIwAALh3uQQ (envelope-from ); Tue, 01 Jun 2021 07:31:21 +0000 Subject: Re: GCC documentation: porting to Sphinx To: Michael Matz Cc: David Malcolm , gcc-patches@gcc.gnu.org, GCC Development , "Joseph S. Myers" References: <1446990946.2994.192.camel@surprise> <1a22bc37-3d48-132f-a3d5-219471cd443c@suse.cz> <3a2a573b-5185-fff5-f9da-6e5e39953ad6@suse.cz> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= Message-ID: Date: Tue, 1 Jun 2021 09:31:21 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.10.2 MIME-Version: 1.0 In-Reply-To: Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 8bit Authentication-Results: imap.suse.de; none X-Spam-Level: X-Spam-Score: -0.37 X-Spamd-Result: default: False [-0.37 / 100.00]; ARC_NA(0.00)[]; RCVD_VIA_SMTP_AUTH(0.00)[]; FROM_HAS_DN(0.00)[]; TO_DN_SOME(0.00)[]; TO_MATCH_ENVRCPT_ALL(0.00)[]; MIME_GOOD(-0.10)[text/plain]; RCPT_COUNT_FIVE(0.00)[5]; DKIM_SIGNED(0.00)[suse.cz:s=susede2_rsa,suse.cz:s=susede2_ed25519]; NEURAL_HAM_SHORT(-1.00)[-1.000]; RCVD_NO_TLS_LAST(0.10)[]; FROM_EQ_ENVFROM(0.00)[]; MIME_TRACE(0.00)[0:+]; R_MIXED_CHARSET(0.63)[subject]; RCVD_COUNT_TWO(0.00)[2]; MID_RHS_MATCH_FROM(0.00)[] X-Spam-Status: No, score=-5.1 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=ham autolearn_force=no version=3.4.2 X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on server2.sourceware.org X-BeenThere: gcc@gcc.gnu.org X-Mailman-Version: 2.1.29 Precedence: list List-Id: Gcc mailing list List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Tue, 01 Jun 2021 07:31:25 -0000 On 5/31/21 5:49 PM, Michael Matz wrote: > Hello Martin, > > On Mon, 31 May 2021, Martin Liška wrote: > >> I've made quite some progress with the porting of the documentation and >> I would like to present it to the community now: >> https://splichal.eu/scripts/sphinx/ >> >> Note the documentation is automatically ([1]) generated from texinfo with a >> GitHub workflow ([2]). > > One other thing I was recently thinking about, in the Spinx vs. texinfo > discussion: locally available documentation browsable/searchable in > terminal with info(1) (or equivalents). Yes, that's handy. > I think the above (i.e. > generating .rst from the texinfo file) would immediately nullify all my > worries. So, just to be extra sure: your proposal now is to generate the > .rst files, and that .texinfo remains the maintained sources, right? No, .texinfo files will be gone. However, Sphinx can output to info format: https://www.sphinx-doc.org/en/master/man/sphinx-build.html#cmdoption-sphinx-build-M And I've just added the generated Info pages here: https://splichal.eu/scripts/sphinx/ Hope it helps? Martin > > > Ciao, > Michael. >