Le 02/01/2015 20:49, Rabbi David Botton a écrit :
I've started work on a new tool, Gnoga_Doc, it will parse Ada code to
As the creator of AIDE (Ada Instant Dev Environment), in the early 200x (http://sr.sriviere.info), I had a nice toolchains for technical docs (TeXINFO based), which gracefully include beautiful doc generated from sources (with tags and a lexer/parser), thanks to AdaDoc (old french school project on sourceforge) and a TeXINFO driver I wrote for it.
But the AdaDoc grammar was not fully compliant with Ada95 (cover only 80%) and obviously completly out of date now, as AIDE 1.04 (GNAT 3.15p based).
This is why I was digging around GnatDoc (so... with ASIS) to avoid the grammar problem. After all, ASIS is ideal to generate docs from sources.
I discover also Sphinx and all the toolchains associated as it appears AdaCore has dropped TeXINFO for these new Python based tools.
The only current Spec -> Doc tool that exists for Ada 2005/2012 is GPS / gnatdoc and I don't like the results nor that it depends on Asis which is generally not available on the FSF compilers.
For my information :- What is the problem in the outputs of GnatDoc/Sphinx ? (I've only seen PDF outputs... good at first glance)
- I wonder if Ludovic allways maintain ASIS for Gnat in Debian ?I'll look into Gnoga_Doc with interest. It could be fine to be able, in the future, to mix technical writing (hand write docs) with automatically generated docs, all that with a pure Ada toolchains.
ReStructuredText format (I must admit it's simpler than TeXINFO syntax), Sphinx (looks very powerfull with its html, man, pdf and even LaTeX outputs... good for formulas.... Maths expressions are handled... this is mandatory, I think, for technical docs.
Mixing Gnoga_Doc with this could be a path to dig... I don't know what you have planned for Gnoga Docs at the whole...
Anyway, I was not aware ASIS was not embedded in GNAT ! It should ! Thanks to you to point this... (sorry for my english, I'm 'rusted') -- Stéphane Rivière Ile d'Oléron - France Freiburg Im Breisgau - Deutschland
smime.p7s
Description: Signature cryptographique S/MIME
------------------------------------------------------------------------------ Dive into the World of Parallel Programming! The Go Parallel Website, sponsored by Intel and developed in partnership with Slashdot Media, is your hub for all things parallel software development, from weekly thought leadership blogs to news, videos, case studies, tutorials and more. Take a look and join the conversation now. http://goparallel.sourceforge.net
_______________________________________________ Gnoga-list mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/gnoga-list
