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,327f3e801a405191
X-Google-Attributes: gid103376,public
X-Google-ArrivalTime: 2002-01-15 21:45:02 PST
Path: 
 archiver1.google.com!news1.google.com!newsfeed.stanford.edu!news-spur1.maxwell.syr.edu!news.maxwell.syr.edu!dispose.news.demon.net!news.demon.co.uk!demon!pogner.demon.co.uk!zap!not-for-mail
From: Simon Wright <simon@pushface.org>
Newsgroups: comp.lang.ada
Subject: Re: "Javadoc" for Ada
Date: 13 Jan 2002 20:29:45 +0000
Organization: Pushface
Message-ID: <x7vsn9aro3q.fsf@smaug.pushface.org>
References: <3C413630.A2CEB446@concentric.net>
 <msb08.31577$si4.3961096417@newssvr14.news.prodigy.com>
NNTP-Posting-Host: localhost
X-NNTP-Posting-Host: pogner.demon.co.uk:158.152.70.98
X-Trace: news.demon.co.uk 1011159856 nnrp-13:5662 NO-IDENT
 pogner.demon.co.uk:158.152.70.98
X-Complaints-To: abuse@demon.net
NNTP-Posting-Date: 13 Jan 2002 20:29:45 GMT
X-Newsreader: Gnus v5.7/Emacs 20.7
Xref: archiver1.google.com comp.lang.ada:18956
Date: 2002-01-13T20:29:45+00:00
List-Id: <comp.lang.ada>

tmoran@acm.org writes:

>   We too have a homegrown utility for documentation.  It parses so in
> addition to copying specs and comments, it can link types to their
> declarations and uses, as well as parents and children.  It generates
> an intermediate form so that a "mail-merge" kind of operation can
> override/expand the mechanically generated stuff with manually
> created text, to create input to the final .rtf/.htm generator.
>   How do other people handle the problem?

That sounds neat (though for informal use I'd find gnathtml more than
adequate).

We're generating code frameworks (well, at the higher levels of the
architecture) from UML, so we're generating documentation from the
model.