This is the mail archive of the
gcc@gcc.gnu.org
mailing list for the GCC project.
Re: use of sphinx/rest as source for GNAT doc
- From: Arnaud Charlet <charlet at adacore dot com>
- To: Jeff Law <law at redhat dot com>
- Cc: gcc at gcc dot gnu dot org, Arnaud Charlet <charlet at adacore dot com>
- Date: Fri, 23 May 2014 18:01:30 +0200
- Subject: Re: use of sphinx/rest as source for GNAT doc
- Authentication-results: sourceware.org; auth=none
- References: <20140523152346 dot GA14154 at adacore dot com> <537F6FC2 dot 2000001 at redhat dot com>
Thanks for the quick feedback!
> Given the long term maintenance issues around texlive/texinfo,
> investigation of other formats is wise. The fact that sphinx can
> generate .texi files is a huge win from a flexibility standpoint.
Indeed. We've been looking for a possible replacement format for
texinfo for years at AdaCore with no success, and have finally found
sphinx and started using it. After several years of experience with sphinx
I must say we are very pleased.
> I'd support this as a pilot for converting the entire project. The
> generated .texi files should have some kind of comment marker
> indicating they are generated from the .rst files and how to
> recreate them so that other maintainers can DTRT with the Ada docs
> as necessary.
Yes, definitely. We would provide all means to use sphinx directly as an
option (e.g. sphinx Makefiles or support files) so that everyone can
do e.g. 'make texinfo' or 'make html <other formats>' if they want to.
Arno