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 09:53:44 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 Newsgroups: comp.lang.ada Subject: Re: Q: Generating Documenation from Ada Sources? Date: Sun, 12 May 2002 17:23:13 +0200 Organization: [Posted via] Inter.net Germany GmbH Message-ID: <3CDE88E1.70107@snafu.de> References: <3CDD31D7.2060005@snafu.de> <5ee5b646.0205111029.3cde679@posting.google.com> <3CDD6BD7.5010503@snafu.de> <3CDE1B39.9060000@snafu.de> <3CDE2404.5030008@ib-paus.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii; format=flowed Content-Transfer-Encoding: 7bit X-Trace: news.eusc.inter.net 1021222424 22367 213.73.65.178 (12 May 2002 16:53:44 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:23930 Date: 2002-05-12T17:23:13+02:00 List-Id: Dr. Michael Paus wrote: > 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. > Thanks i have tried it. What i am interested is more centered on processing text in the source. Your browser does not care about the contents of the comments. It is left to the used to build in tags or not. What i am looking for i a tool which maps the relevant part of the coments in a package spec. and transforms this into a docbook document. In order to do so such a program requieres certain key words. Theretically the comment in the source could already contain docbook format but i dont like the idea, since the comments are getting unreadable. I gues what i am looking for i a tool which is abble to retrieve sections identified by headlines from normal and to convert it into docbook format. Copying in the specification of a procedure is the minor part of it. Any way, adabrowser is based on asis, which requieres that the module is compilable which i cannot gurantee. Michael > Michael >