Re: use of sphinx/rest as source for GNAT doc

2014-05-26 Thread Jose E. Marchesi
On 05/23/14 09:23, Arnaud Charlet wrote: > At AdaCore, we have switched most of our product documentation the > rest/sphinx format: http://sphinx-doc.org/ > which provides most of the advantages of texinfo (text format, > can generate output in multiple formats, supported by fr

Re: use of sphinx/rest as source for GNAT doc

2014-05-26 Thread Florian Weimer
On 05/23/2014 08:47 PM, Arnaud Charlet wrote: - the GNAT doc source would be in rest format (.rst files) instead of texinfo (.texi files) What about the preprocessor for the VMS specifics? Will it go away? Yes, we are about to baseline VMS maintenance, and the VMS specific doc will go aw

Re: use of sphinx/rest as source for GNAT doc

2014-05-23 Thread Arnaud Charlet
> >- the GNAT doc source would be in rest format (.rst files) instead > > of texinfo (.texi files) > > What about the preprocessor for the VMS specifics? Will it go away? Yes, we are about to baseline VMS maintenance, and the VMS specific doc will go away in any case. > >- we would still prov

Re: use of sphinx/rest as source for GNAT doc

2014-05-23 Thread Florian Weimer
On 05/23/2014 05:23 PM, Arnaud Charlet wrote: - the GNAT doc source would be in rest format (.rst files) instead of texinfo (.texi files) What about the preprocessor for the VMS specifics? Will it go away? - we would still provide .texi files, generated automatically by the sphinx too

Re: use of sphinx/rest as source for GNAT doc

2014-05-23 Thread David Malcolm
On Fri, 2014-05-23 at 17:23 +0200, Arnaud Charlet wrote: > At AdaCore, we have switched most of our product documentation the > rest/sphinx format: http://sphinx-doc.org/ > which provides most of the advantages of texinfo (text format, > can generate output in multiple formats, supported by free so

Re: use of sphinx/rest as source for GNAT doc

2014-05-23 Thread Arnaud Charlet
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

Re: use of sphinx/rest as source for GNAT doc

2014-05-23 Thread Jeff Law
On 05/23/14 09:23, Arnaud Charlet wrote: At AdaCore, we have switched most of our product documentation the rest/sphinx format: http://sphinx-doc.org/ which provides most of the advantages of texinfo (text format, can generate output in multiple formats, supported by free software), as well as ad