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 00:53:12 PST
Path: 
 archiver1.google.com!news1.google.com!newsfeed.stanford.edu!news.tele.dk!small.news.tele.dk!195.21.255.252!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: Sun, 12 May 2002 09:35:21 +0200
Organization: [Posted via] Inter.net Germany GmbH
Message-ID: <3CDE1B39.9060000@snafu.de>
References: <3CDD31D7.2060005@snafu.de>
 <5ee5b646.0205111029.3cde679@posting.google.com> <3CDD6BD7.5010503@snafu.de>
 <udrjg748esp7d@corp.supernews.com>
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit
X-Trace: news.eusc.inter.net 1021189991 7811 213.73.71.202 (12 May 2002
 07:53:11 GMT)
X-Complaints-To: abuse@eusc.inter.net
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:23916
Date: 2002-05-12T09:35:21+02:00
List-Id: <comp.lang.ada>

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