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 19:05:59 PST Path: archiver1.google.com!news1.google.com!sn-xit-02!sn-post-01!supernews.com!corp.supernews.com!not-for-mail From: "Randy Brukardt" Newsgroups: comp.lang.ada Subject: Re: Q: Generating Documenation from Ada Sources? Date: Sat, 11 May 2002 21:05:25 -0500 Organization: Posted via Supernews, http://www.supernews.com Message-ID: References: <3CDD31D7.2060005@snafu.de> <5ee5b646.0205111029.3cde679@posting.google.com> <3CDD6BD7.5010503@snafu.de> X-Newsreader: Microsoft Outlook Express 4.72.3612.1700 X-MimeOLE: Produced By Microsoft MimeOLE V4.72.3719.2500 X-Complaints-To: newsabuse@supernews.com Xref: archiver1.google.com comp.lang.ada:23914 Date: 2002-05-11T21:05:25-05:00 List-Id: 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. What it does is preprocess the specifications into an intermediate file, which can be updated manually to correct mistakes, add links and formatting, and the like. There is also some tools for merging files (so that new versions of packages don't lose the hand-work from previous versions). I thought about making a GUI for it, and making it available as a tool, but I didn't think there was likely to be enough demand to make it worthwhile. If you don't find something else, drop me a line and we can discuss making it available to you. Randy Brukardt.