From mboxrd@z Thu Jan  1 00:00:00 1970
X-Spam-Checker-Version: SpamAssassin 3.4.4 (2020-01-24) on polar.synack.me
X-Spam-Level: 
X-Spam-Status: No, score=-1.9 required=5.0 tests=BAYES_00 autolearn=ham
	autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 103376,41cdd08c4c779b88
X-Google-Attributes: gid103376,public
X-Google-ArrivalTime: 2002-05-12 01:12:53 PST
From: "Dr. Michael Paus" <paus@ib-paus.com>
Newsgroups: comp.lang.ada
Subject: Re: Q: Generating Documenation from Ada Sources?
Date: Sun, 12 May 2002 10:12:52 +0200
Organization: 1&1 Internet AG
Message-ID: <3CDE2404.5030008@ib-paus.com>
References: <3CDD31D7.2060005@snafu.de>
 <5ee5b646.0205111029.3cde679@posting.google.com> <3CDD6BD7.5010503@snafu.de>
 <udrjg748esp7d@corp.supernews.com> <3CDE1B39.9060000@snafu.de>
NNTP-Posting-Host: p508307a5.dip0.t-ipconnect.de
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-Trace: news.online.de 1021191173 2091 80.131.7.165 (12 May 2002 08:12:53
 GMT)
X-Complaints-To: abuse@online.de
NNTP-Posting-Date: 12 May 2002 08:12:53 GMT
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US;
 rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
Path: 
 archiver1.google.com!news1.google.com!newsfeed.stanford.edu!skynet.be!skynet.be!newsfeed00.sul.t-online.de!newsfeed01.sul.t-online.de!t-online.de!news.belwue.de!news.uni-ulm.de!rz.uni-karlsruhe.de!schlund.de!news.online.de!not-for-mail
Xref: archiver1.google.com comp.lang.ada:23917
Date: 2002-05-12T08:12:53+00:00
List-Id: <comp.lang.ada>

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