Re: Q: Generating Documenation from Ada Sources?

[Michael Erdmann <Michael.Erdmann@snafu.de>]

Robert Dewar wrote:
> Michael Erdmann <Michael.Erdmann@snafu.de> wrote in message news:<3CDD31D7.2060005@snafu.de>...
> 
>>I am looking for open source tools which are
>>generating documentation out of package
>>specifications.
>>Such a tools sould not just list the items
>>in the specification but also extract the
>>comments belonging to these items into a
>>resonable format.
>>
>>Who knows more about the topic?
>>
>>Michael
> 
> 
> 
> For a well written Ada spec, it would seem that the unix tool cat would
> do what you want, or possibly something like gnathtml. I think you need
> to be a whole lot more specific about what you are looking for. What else
> is there in a spec except items and comments?


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!


Michael