From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: (qmail 59749 invoked by alias); 26 Feb 2015 17:19:18 -0000 Mailing-List: contact gcc-patches-help@gcc.gnu.org; run by ezmlm Precedence: bulk List-Id: List-Archive: List-Post: List-Help: Sender: gcc-patches-owner@gcc.gnu.org Received: (qmail 56448 invoked by uid 89); 26 Feb 2015 17:18:07 -0000 Authentication-Results: sourceware.org; auth=none X-Virus-Found: No X-Spam-SWARE-Status: No, score=-2.1 required=5.0 tests=AWL,BAYES_00,RCVD_IN_DNSWL_LOW autolearn=ham version=3.3.2 X-HELO: smtp.eu.adacore.com Received: from mel.act-europe.fr (HELO smtp.eu.adacore.com) (194.98.77.210) by sourceware.org (qpsmtpd/0.93/v0.84-503-g423c35a) with (AES256-GCM-SHA384 encrypted) ESMTPS; Thu, 26 Feb 2015 17:18:01 +0000 Received: from localhost (localhost [127.0.0.1]) by filtered-smtp.eu.adacore.com (Postfix) with ESMTP id 6FE202CEACFE; Thu, 26 Feb 2015 18:17:56 +0100 (CET) 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 UPx1yt7Wy5jz; Thu, 26 Feb 2015 18:17:56 +0100 (CET) Received: from chelles.act-europe.fr (chelles.act-europe.fr [10.10.0.160]) by smtp.eu.adacore.com (Postfix) with ESMTP id 8B18A2CEACF9; Thu, 26 Feb 2015 18:17:55 +0100 (CET) Received: by chelles.act-europe.fr (Postfix, from userid 525) id 81B731EA55AB; Thu, 26 Feb 2015 18:17:55 +0100 (CET) Date: Thu, 26 Feb 2015 17:26:00 -0000 From: Arnaud Charlet To: David Malcolm Cc: Joseph Myers , Tom de Vries , gcc-patches@gcc.gnu.org, Arnaud Charlet Subject: Re: [Ada] convert GNAT doc to sphinx Message-ID: <20150226171755.GB19466@adacore.com> References: <20150220091720.GA16093@adacore.com> <54E9F787.4010704@mentor.com> <20150222180433.GB3798@adacore.com> <20150225111348.GB20964@adacore.com> <20150225112747.GC20964@adacore.com> <20150225154753.GA26463@adacore.com> <1424970457.8624.56.camel@surprise> MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: <1424970457.8624.56.camel@surprise> User-Agent: Mutt/1.5.21 (2010-09-15) X-SW-Source: 2015-02/txt/msg01637.txt.bz2 Thanks for your feedback, very useful! > How are you testing this? When getting the jit docs to work I had to > hack up the script somewhat to be able to test it on a development box > (e.g. to cut back "MANUALS" to just libcpp to speed up testing). That's a good question. Truth is that so far I'm not since I do not know how to test it :-) That's why I wanted to minimize my changes and was asking for help, since testing these changes is not very practical/easy. > Don't you also need to preserve the Makefile at this stage, and indeed > the .rst files? When we'll switch the script to using sphinx for GNAT docs, yes. For now the temporary state is that we're still building docs from the .texi files (now generated by sphinx). Certainly not ideal but it more or less does the job. > To get sphinx-generated HTML for the jit onto the gcc website, I needed > to patch the script in three places: > * the part above, > * to add an invocation of the Makefile, and > * to implement the copying up from the build location to the install > location (since the jit docs have nested subdirectories, plus .js > and .css files provided by sphinx). Makes sense. > Hope this is helpful It definitely is! Arno