Re: Q: Generating Documenation from Ada Sources?

["Randy Brukardt" <randy@rrsoftware.com>]

Michael Erdmann wrote in message <3CDD6BD7.5010503@snafu.de>...
>The point is that Ada spec. come along with coments which expalains
certain aspects of
>an interface.
>I like to generate from the *.ads file a docbook (sgml) formated manual
page which
>contains the explanatory text. This mean for example the package name
goes into the
>section name, the description into a paragraph, the spec. it self goes
into
>a program listing section.
>
>I guess i am not the first one having such a problem!


We developed such a tool for creating the Claw documents (it outputs
HTML and .RTF for WinHelp), but its not open source and its rather tied
to our Claw coding conventions. What it does is preprocess the
specifications into an intermediate file, which can be updated manually
to correct mistakes, add links and formatting, and the like. There is
also some tools for merging files (so that new versions of packages
don't lose the hand-work from previous versions). I thought about making
a GUI for it, and making it available as a tool, but I didn't think
there was likely to be enough demand to make it worthwhile.

If you don't find something else, drop me a line and we can discuss
making it available to you.

                Randy Brukardt.