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-11 12:03:23 PST
Path: 
 archiver1.google.com!news1.google.com!newsfeed.stanford.edu!news-spur1.maxwell.syr.edu!news.maxwell.syr.edu!unlisys!news.snafu.de!news.eusc.inter.net!boavista!nobody
From: Michael Erdmann <Michael.Erdmann@snafu.de>
Newsgroups: comp.lang.ada
Subject: Re: Q: Generating Documenation from Ada Sources?
Date: Sat, 11 May 2002 21:07:03 +0200
Organization: [Posted via] Inter.net Germany GmbH
Message-ID: <3CDD6BD7.5010503@snafu.de>
References: <3CDD31D7.2060005@snafu.de>
 <5ee5b646.0205111029.3cde679@posting.google.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-Trace: news.eusc.inter.net 1021143801 488 213.73.65.77 (11 May 2002 19:03:21
 GMT)
X-Complaints-To: abuse@eusc.inter.net
To: Robert Dewar <dewar@gnat.com>
User-Agent: Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.0rc1) Gecko/20020417
X-Accept-Language: en-us, en
Xref: archiver1.google.com comp.lang.ada:23907
Date: 2002-05-11T21:07:03+02:00
List-Id: <comp.lang.ada>

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