Re: [Ada] convert GNAT doc to sphinx

2015-03-03 Thread Arnaud Charlet
As discussed last year, we've converted the GNAT main documentation (gnat_rm.texi and gnat_ugn.texi) to reST/sphinx, so the master doc can now be found under gcc/ada/doc. there is an empty directory left in SVN: gcc/ada/doc/share/_static ok to remove? No, this (empty currently) directory

Re: [Ada] convert GNAT doc to sphinx

2015-03-03 Thread Matthias Klose
On 02/20/2015 10:17 AM, Arnaud Charlet wrote: > As discussed last year, we've converted the GNAT main documentation > (gnat_rm.texi and gnat_ugn.texi) to reST/sphinx, so the master doc > can now be found under gcc/ada/doc. there is an empty directory left in SVN: gcc/ada/doc/share/_static ok t

Re: [Ada] convert GNAT doc to sphinx

2015-02-26 Thread Mike Stump
On Feb 26, 2015, at 9:07 AM, David Malcolm 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 gene

Re: [Ada] convert GNAT doc to sphinx

2015-02-26 Thread David Malcolm
On Wed, 2015-02-25 at 16:47 +0100, Arnaud Charlet wrote: > > > I've added a -I gcc/gcc/ada/doc/gnat_ugn there, that's as far as my > > > knowledge goes for this script so I hope this is enough. > > > > Well, since by default the find command deletes all files except those > > known to be documenta

Re: [Ada] convert GNAT doc to sphinx

2015-02-26 Thread Arnaud Charlet
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

Re: [Ada] convert GNAT doc to sphinx

2015-02-25 Thread Joseph Myers
On Wed, 25 Feb 2015, Arnaud Charlet wrote: > > So you need to update the > > find command therein not to remove anything that's part of the sources for > > this documentation, and possibly update -I options for building manuals as > > well. > > I've added a -I gcc/gcc/ada/doc/gnat_ugn there, that

Re: [Ada] convert GNAT doc to sphinx

2015-02-25 Thread Joseph Myers
On Wed, 25 Feb 2015, Arnaud Charlet wrote: > > See the existing code to handle Sphinx documentation for the JIT. > > That's a good reference. 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). 1.0 is appa

Re: [Ada] convert GNAT doc to sphinx

2015-02-25 Thread Arnaud Charlet
> > I've added a -I gcc/gcc/ada/doc/gnat_ugn there, that's as far as my > > knowledge goes for this script so I hope this is enough. > > Well, since by default the find command deletes all files except those > known to be documentation sources, you need at least to change it not to > delete those

Re: [Ada] convert GNAT doc to sphinx

2015-02-25 Thread Richard Biener
On Sun, Feb 22, 2015 at 8:15 PM, Arnaud Charlet wrote: >> Your patch removes these arguments to dircategory: >> ... >> $ git show bf5dffd3a47fe12ace71fe48e87cfb1b9ada1344 | grep dircategory >> +@dircategory >> -@dircategory GNU Ada tools >> -@dircategory GNU Ada tools >> +@dircategory >> ... > > W

Re: [Ada] convert GNAT doc to sphinx

2015-02-25 Thread Arnaud Charlet
> So you need to update the > find command therein not to remove anything that's part of the sources for > this documentation, and possibly update -I options for building manuals as > well. I've added a -I gcc/gcc/ada/doc/gnat_ugn there, that's as far as my knowledge goes for this script so I hope

Re: [Ada] convert GNAT doc to sphinx

2015-02-25 Thread Joseph Myers
On Wed, 25 Feb 2015, Arnaud Charlet wrote: > > > Two .png files were missing, now added: > > > > > > 2015-02-22 Arnaud Charlet > > > > > > * doc/gnat_ugn/project-manager-figure.png, > > > doc/gnat_ugn/rtlibrary-structure.png: New. > > > > The maintainer-scripts

Re: [Ada] convert GNAT doc to sphinx

2015-02-25 Thread Arnaud Charlet
> > Two .png files were missing, now added: > > > > 2015-02-22 Arnaud Charlet > > > > * doc/gnat_ugn/project-manager-figure.png, > > doc/gnat_ugn/rtlibrary-structure.png: New. > > The maintainer-scripts/update_web_docs_svn script is still producing > errors

Re: [Ada] convert GNAT doc to sphinx

2015-02-25 Thread Joseph Myers
On Sun, 22 Feb 2015, Arnaud Charlet wrote: > Two .png files were missing, now added: > > 2015-02-22 Arnaud Charlet > > * doc/gnat_ugn/project-manager-figure.png, > doc/gnat_ugn/rtlibrary-structure.png: New. The maintainer-scripts/update_web_docs_svn scr

Re: [Ada] convert GNAT doc to sphinx

2015-02-23 Thread Tom de Vries
On 22-02-15 21:48, Arnaud Charlet wrote: I didn't see a question here: ... As for the @dircategory I do not know, I couldn't find a proper documentation for this node other than: http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Installing-Dir-Entries.html#index-dircategory which is in

Re: [Ada] convert GNAT doc to sphinx

2015-02-22 Thread Arnaud Charlet
> I didn't see a question here: > ... > As for the @dircategory I do not know, I couldn't find a proper documentation > for this node other than: > http://www.gnu.org/software/texinfo/manual/texinfo/html_node/Installing-Dir-Entries.html#index-dircategory > which is incomplete. > ... > > Could you

Re: [Ada] convert GNAT doc to sphinx

2015-02-22 Thread Tom de Vries
On 22-02-15 20:15, Arnaud Charlet wrote: Well OK but these are automatically generated now, and this doesn't really answer my question about the documentation of @dircategory. I didn't see a question here: ... As for the @dircategory I do not know, I couldn't find a proper documentation for thi

Re: [Ada] convert GNAT doc to sphinx

2015-02-22 Thread Arnaud Charlet
> Your patch removes these arguments to dircategory: > ... > $ git show bf5dffd3a47fe12ace71fe48e87cfb1b9ada1344 | grep dircategory > +@dircategory > -@dircategory GNU Ada tools > -@dircategory GNU Ada tools > +@dircategory > ... Well OK but these are automatically generated now, and this doesn't

Re: [Ada] convert GNAT doc to sphinx

2015-02-22 Thread Tom de Vries
On 22-02-15 19:04, Arnaud Charlet wrote: 2015-02-20 Arnaud Charlet * gnat_rm.texi, gnat_ugn.texi: Now automatically generated from sphinx in the doc directory. * doc: New directory containing sphinx versions of gnat_rm and gnat_ugn Hi, I'm obser

Re: [Ada] convert GNAT doc to sphinx

2015-02-22 Thread Arnaud Charlet
> >2015-02-20 Arnaud Charlet > > > > * gnat_rm.texi, gnat_ugn.texi: Now automatically generated > > from > > sphinx in the doc directory. > > * doc: New directory containing sphinx versions of gnat_rm and > > gnat_ugn > > Hi, > > I'm observing: > ... > s

Re: [Ada] convert GNAT doc to sphinx

2015-02-22 Thread Tom de Vries
On 20-02-15 10:17, Arnaud Charlet wrote: Tested on x86_64-pc-linux-gnu, committed on trunk. 2015-02-20 Arnaud Charlet * gnat_rm.texi, gnat_ugn.texi: Now automatically generated from sphinx in the doc directory. * doc: New directory containing sphinx versions of gn

[Ada] convert GNAT doc to sphinx

2015-02-20 Thread Arnaud Charlet
As discussed last year, we've converted the GNAT main documentation (gnat_rm.texi and gnat_ugn.texi) to reST/sphinx, so the master doc can now be found under gcc/ada/doc. We're keeping automatically generated .texi files for now under gcc/ada so that people only having texinfo tools can still gene