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 995D43850413; Mon, 28 Jun 2021 10:44:44 +0000 (GMT) DMARC-Filter: OpenDMARC Filter v1.4.1 sourceware.org 995D43850413 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 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 6841222400; Mon, 28 Jun 2021 10:44:43 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1624877083; 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=JlgP+trWD4A8A/WiVeH0PnrIPqqcEuNCdKTqZtgA6AQ=; b=a80J3hfJkok6Uybv/o7GDmf+qdMxoSz3vLdzr5J3vmsXj2ptbDlS+XRMUX1InH+zR+qqOq Uda4m464HJT7+Dry8FZBnmbO82J3JJEE5yhdHoKZrsen2iObDxPRKii+78Co5XLPoKgOA6 KBTrsgeSM7SUIIA3Nfn2lFgPfidxT10= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1624877083; 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=JlgP+trWD4A8A/WiVeH0PnrIPqqcEuNCdKTqZtgA6AQ=; b=SPBk41XLMlLnWtO5Qrj2mTXuosMhIS9cBmd/FSJWPM+KG2YL63zq/gJFlwtzL1CDE60pj7 /fcP2w2wnr5ZBnBw== Received: from imap3-int (imap-alt.suse-dmz.suse.de [192.168.254.47]) by imap.suse.de (Postfix) with ESMTP id 3E87811906; Mon, 28 Jun 2021 10:44:43 +0000 (UTC) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_rsa; t=1624877083; 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=JlgP+trWD4A8A/WiVeH0PnrIPqqcEuNCdKTqZtgA6AQ=; b=a80J3hfJkok6Uybv/o7GDmf+qdMxoSz3vLdzr5J3vmsXj2ptbDlS+XRMUX1InH+zR+qqOq Uda4m464HJT7+Dry8FZBnmbO82J3JJEE5yhdHoKZrsen2iObDxPRKii+78Co5XLPoKgOA6 KBTrsgeSM7SUIIA3Nfn2lFgPfidxT10= DKIM-Signature: v=1; a=ed25519-sha256; c=relaxed/relaxed; d=suse.cz; s=susede2_ed25519; t=1624877083; 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=JlgP+trWD4A8A/WiVeH0PnrIPqqcEuNCdKTqZtgA6AQ=; b=SPBk41XLMlLnWtO5Qrj2mTXuosMhIS9cBmd/FSJWPM+KG2YL63zq/gJFlwtzL1CDE60pj7 /fcP2w2wnr5ZBnBw== Received: from director2.suse.de ([192.168.254.72]) by imap3-int with ESMTPSA id h7ZLDhuo2WBHCQAALh3uQQ (envelope-from ); Mon, 28 Jun 2021 10:44:43 +0000 Subject: Re: GCC documentation: porting to Sphinx To: Arnaud Charlet Cc: Joseph Myers , GCC Development , gcc-patches@gcc.gnu.org, David Malcolm References: <3a2a573b-5185-fff5-f9da-6e5e39953ad6@suse.cz> <8641dc55-5412-fbd7-bafd-13604311f5ad@suse.cz> <5ffe3e32-ece0-a1b4-1fcf-e35177fa80b5@suse.cz> <87489d9a-44e2-411c-3f3a-534d07e78b95@suse.cz> <0866a0ea-c846-ea5e-ac7a-d1c8f106cc45@suse.cz> <20210628102305.GA31328@adacore.com> From: =?UTF-8?Q?Martin_Li=c5=a1ka?= Message-ID: Date: Mon, 28 Jun 2021 12:44:43 +0200 User-Agent: Mozilla/5.0 (X11; Linux x86_64; rv:78.0) Gecko/20100101 Thunderbird/78.11.0 MIME-Version: 1.0 In-Reply-To: <20210628102305.GA31328@adacore.com> Content-Type: text/plain; charset=utf-8; format=flowed Content-Language: en-US Content-Transfer-Encoding: 7bit X-Spam-Status: No, score=-4.6 required=5.0 tests=BAYES_00, DKIM_SIGNED, DKIM_VALID, DKIM_VALID_AU, DKIM_VALID_EF, KAM_SHORT, 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: Mon, 28 Jun 2021 10:44:46 -0000 On 6/28/21 12:23 PM, Arnaud Charlet wrote: >> I've got something that is very close to be a patch candidate that can be >> eventually merged. Right now, the patches are available here: >> https://gcc.gnu.org/git/gitweb.cgi?p=gcc.git;a=log;h=refs/users/marxin/heads/sphinx-v3 > > FWIW I would prefer to review the changes posted here directly with all > the details. Sure, I'm going to send a proper patch set in an hour or so. As mentioned, I won't be able to attach some of the patches as they will exceed 1MB email limit. > > 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/ > That's lots of moving files around, so I'd like > to understand why and make sure these are not gratuituous changes, since > move files around is always tricky and I'd rather not have to undo it > later in case this causes troubles or have unexpected consequences. Hope I explained all the reasonable changes? > > Otherwise, glad to see the switch to sphinx finally moving in gcc! You're welcome. I would be interested in testing your PRO configuration (based on Gnat_Build_Type, see get_gnat_build_type) and I'm curious if you're fine with Sphinx template change? It will be the same as for other manuals. Cheers, Martin > > Arno >