Re: Q: Generating Documenation from Ada Sources?

["Dr. Michael Paus" <paus@ib-paus.com>]

Michael Erdmann wrote:
> 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?

It sounds as if you are looking for something like JavaDoc (for Ada).
Hava you tried AdaBrowse? (http://home.datacomm.ch/t_wolf/tw/ada95/adabrowse/)
I have not had the time to try it out but it is supposed to do what you want.

Michael