From mboxrd@z Thu Jan  1 00:00:00 1970
Return-Path: <charlet@eu.adacore.com>
Received: from smtp.eu.adacore.com (mel.act-europe.fr [194.98.77.210])
 by sourceware.org (Postfix) with ESMTPS id 387933857824;
 Tue, 29 Jun 2021 15:54:26 +0000 (GMT)
DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 387933857824
Authentication-Results: sourceware.org;
 dmarc=none (p=none dis=none) header.from=adacore.com
Authentication-Results: sourceware.org; spf=pass smtp.mailfrom=eu.adacore.com
Received: from localhost (localhost [127.0.0.1])
 by filtered-smtp.eu.adacore.com (Postfix) with ESMTP id F257A812E5;
 Tue, 29 Jun 2021 17:54:24 +0200 (CEST)
X-Virus-Scanned: Debian amavisd-new at eu.adacore.com
Received: from smtp.eu.adacore.com ([127.0.0.1])
 by localhost (smtp.eu.adacore.com [127.0.0.1]) (amavisd-new, port 10024)
 with ESMTP id jDy1EcykH9ZK; Tue, 29 Jun 2021 17:54:24 +0200 (CEST)
Received: from chelles.localdomain (chelles.act-europe.fr
 [IPv6:2a02:2ab8:224:1:d6be:d9ff:fef8:4565])
 by smtp.eu.adacore.com (Postfix) with ESMTP id BF6E6812E3;
 Tue, 29 Jun 2021 17:54:24 +0200 (CEST)
Received: by chelles.localdomain (Postfix, from userid 525)
 id 936CB1EA0081; Tue, 29 Jun 2021 17:54:24 +0200 (CEST)
Date: Tue, 29 Jun 2021 17:54:24 +0200
From: Arnaud Charlet <charlet@adacore.com>
To: Martin Li??ka <mliska@suse.cz>
Cc: Joseph Myers <joseph@codesourcery.com>,
 GCC Development <gcc@gcc.gnu.org>, gcc-patches@gcc.gnu.org,
 David Malcolm <dmalcolm@redhat.com>
Subject: Re: GCC documentation: porting to Sphinx
Message-ID: <20210629155424.GB26232@adacore.com>
References: <8641dc55-5412-fbd7-bafd-13604311f5ad@suse.cz>
 <alpine.DEB.2.22.394.2106101645050.424830@digraph.polyomino.org.uk>
 <e92d2ce5-59a0-ff65-bbfc-27072a452bfa@suse.cz>
 <alpine.DEB.2.22.394.2106111544150.479659@digraph.polyomino.org.uk>
 <5ffe3e32-ece0-a1b4-1fcf-e35177fa80b5@suse.cz>
 <alpine.DEB.2.22.394.2106231551380.13671@digraph.polyomino.org.uk>
 <87489d9a-44e2-411c-3f3a-534d07e78b95@suse.cz>
 <0866a0ea-c846-ea5e-ac7a-d1c8f106cc45@suse.cz>
 <20210628102305.GA31328@adacore.com>
 <d6142991-04da-3e36-06e7-88412d8d855a@suse.cz>
MIME-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
In-Reply-To: <d6142991-04da-3e36-06e7-88412d8d855a@suse.cz>
User-Agent: Mutt/1.5.21 (2010-09-15)
X-Spam-Status: No, score=-4.4 required=5.0 tests=BAYES_00, KAM_DMARC_STATUS,
 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 <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: Tue, 29 Jun 2021 15:54:27 -0000

> >In particular can you explain the motivation behind all the changes in the
> >gcc/ada/doc directory?
> 
> Sure:
> 1) All Sphinx manuals live in a directory where index page is called index.rst. That's why
> I moved e.g. this: gcc/ada/doc/{gnat_rm.rst => gnat_rm/index.rst}
> 2) I moved latex_elements.py to ada_latex_elements.py as it clashes with Sphinx global variable
> you modify in Sphinx config files
> 3) I created a shared Ada config (adabaseconf.py) that extends doc/baseconf.py and sets what
> is shared in between 3 Ada manuals.
> 4) gnu_free_documentation_license.rst is taken from $root/doc/

OK, this is really lots of changes, if we could minimize these changes
that would be best (and sorry but posting a link to a tarball also doesn't
help reviews, it was actually better with a link to a git repo previously...
At least the Ada part itself shouldn't be too big in particular once
simplified so could be posted standalone).

Arno