Re: Q: Generating Documenation from Ada Sources?

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

Randy Brukardt wrote:
> 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. 

I gues this is important to note, that i have to come up with
some kind of convention how the text is formated in order to
map the text into docbook.

I am wondering if it makes sense to add the commentary text already
in tagged format into the source. Any experiences on this?

Regards
    M.Erdmann