This is the mail archive of the
gcc-patches@gcc.gnu.org
mailing list for the GCC project.
Re: [Ada] convert GNAT doc to sphinx
- From: Mike Stump <mikestump at comcast dot net>
- To: David Malcolm <dmalcolm at redhat dot com>, Arnaud Charlet <charlet at adacore dot com>
- Cc: Joseph Myers <joseph at codesourcery dot com>, Tom de Vries <Tom_deVries at mentor dot com>, GCC Patches <gcc-patches at gcc dot gnu dot org>
- Date: Thu, 26 Feb 2015 10:25:05 -0800
- Subject: Re: [Ada] convert GNAT doc to sphinx
- Authentication-results: sourceware.org; auth=none
- References: <20150220091720 dot GA16093 at adacore dot com> <54E9F787 dot 4010704 at mentor dot com> <20150222180433 dot GB3798 at adacore dot com> <alpine dot DEB dot 2 dot 10 dot 1502251100480 dot 4161 at digraph dot polyomino dot org dot uk> <20150225111348 dot GB20964 at adacore dot com> <alpine dot DEB dot 2 dot 10 dot 1502251115250 dot 4161 at digraph dot polyomino dot org dot uk> <20150225112747 dot GC20964 at adacore dot com> <alpine dot DEB dot 2 dot 10 dot 1502251535230 dot 12077 at digraph dot polyomino dot org dot uk> <20150225154753 dot GA26463 at adacore dot com> <1424970457 dot 8624 dot 56 dot camel at surprise>
On Feb 26, 2015, at 9:07 AM, David Malcolm <dmalcolm@redhat.com> wrote:
>> We'll need a more recent version of sphinx than
>> 1.0 though (at least 1.2.2, or even better, 1.3b2 which is the version we use
>> at AdaCore).
>
> The specific version of sphinx in use for gcc.gnu.org is 1.0.8
So, if people check in the generated files, then I think we should just bump the version required up to one that works well. The people that want to regen will need to ensure they update, but that seems reasonable.
> gcc/doc/install.texi currently has:
>
> @item Sphinx version 1.0 (or later)
>
> Necessary to regenerate @file{jit/docs/_build/texinfo} from the @file{.rst}
> files in the directories below @file{jit/docs}.
>
> so that too would need updating if you want to bump the minimum
> requirement.