From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <matz@suse.de>
Received: from mx2.suse.de (mx2.suse.de [195.135.220.15])
 by sourceware.org (Postfix) with ESMTPS id 3A936384F010;
 Mon, 31 May 2021 15:49:31 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.3.2 sourceware.org 3A936384F010
Authentication-Results: sourceware.org;
 dmarc=none (p=none dis=none) header.from=suse.de
Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=matz@suse.de
X-Virus-Scanned: by amavisd-new at test-mx.suse.de
DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.de; s=susede2_rsa;
 t=1622476170; h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc:
 mime-version:mime-version:content-type:content-type:
 in-reply-to:in-reply-to:references:references;
 bh=oRVkp4aahoid5mM6SVw+TuNWp4KxrW4HYCquQp/lrdc=;
 b=LVx5UCGO/Oz9N81W5D+cJu/W5/9iSAkx7n88oEcnOwdZPF4hGQ1+58LeLwY/30vtYLPefS
 guaTqqajg/vhj8VFZVvEwoLWrEnOc3N/NcTkmay/y97g2evQ1edBMMnKa8BlPnY7+XRWoP
 nT+54yL7dUojvYp4jB62vD1CsbujV8Y=
DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.de;
 s=susede2_ed25519; t=1622476170;
 h=from:from:reply-to:date:date:message-id:message-id:to:to:cc:cc:
 mime-version:mime-version:content-type:content-type:
 in-reply-to:in-reply-to:references:references;
 bh=oRVkp4aahoid5mM6SVw+TuNWp4KxrW4HYCquQp/lrdc=;
 b=JJXpOjBRmMHxbp/UJ8RAd2afkir52uXpdD0v6mFJyD6LjucSH+Wi4MWAKicxvpEAt6BoIo
 OxMeZ76x2cl7atDA==
Received: from relay2.suse.de (unknown [195.135.221.27])
 by mx2.suse.de (Postfix) with ESMTP id 0768AB4AF;
 Mon, 31 May 2021 15:49:30 +0000 (UTC)
Date: Mon, 31 May 2021 15:49:29 +0000 (UTC)
From: Michael Matz <matz@suse.de>
To: =?ISO-8859-15?Q?Martin_Li=A8ka?= <mliska@suse.cz>
cc: David Malcolm <dmalcolm@redhat.com>, gcc-patches@gcc.gnu.org, 
 GCC Development <gcc@gcc.gnu.org>, 
 "Joseph S. Myers" <joseph@codesourcery.com>
Subject: Re: GCC documentation: porting to Sphinx
In-Reply-To: <3a2a573b-5185-fff5-f9da-6e5e39953ad6@suse.cz>
Message-ID: <alpine.LSU.2.22.394.2105311544020.16702@wotan.suse.de>
References: <1446990946.2994.192.camel@surprise>
 <e7f490fc-ab76-5bc5-5e94-1d9f00f34b62@suse.cz>
 <1a22bc37-3d48-132f-a3d5-219471cd443c@suse.cz>
 <3a2a573b-5185-fff5-f9da-6e5e39953ad6@suse.cz>
User-Agent: Alpine 2.22 (LSU 394 2020-01-19)
MIME-Version: 1.0
X-Spam-Status: No, score=-3.1 required=5.0 tests=BAYES_00, DKIM_SIGNED,
 DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, KAM_EU, RCVD_IN_MSPIKE_H3,
 RCVD_IN_MSPIKE_WL, SPF_HELO_NONE, SPF_PASS,
 TXREP autolearn=no autolearn_force=no version=3.4.2
X-Spam-Checker-Version: SpamAssassin 3.4.2 (2018-09-13) on
 server2.sourceware.org
Content-Type: text/plain; charset=utf-8
Content-Transfer-Encoding: 8BIT
X-Content-Filtered-By: Mailman/MimeDel 2.1.29
X-BeenThere: gcc@gcc.gnu.org
X-Mailman-Version: 2.1.29
Precedence: list
List-Id: Gcc mailing list <gcc.gcc.gnu.org>
List-Unsubscribe: <https://gcc.gnu.org/mailman/options/gcc>,
 <mailto:gcc-request@gcc.gnu.org?subject=unsubscribe>
List-Archive: <https://gcc.gnu.org/pipermail/gcc/>
List-Post: <mailto:gcc@gcc.gnu.org>
List-Help: <mailto:gcc-request@gcc.gnu.org?subject=help>
List-Subscribe: <https://gcc.gnu.org/mailman/listinfo/gcc>,
 <mailto:gcc-request@gcc.gnu.org?subject=subscribe>
X-List-Received-Date: Mon, 31 May 2021 15:49:34 -0000

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).  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?


Ciao,
Michael.