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.3 required=5.0 tests=BAYES_00,FREEMAIL_FROM,
	INVALID_MSGID autolearn=no autolearn_force=no version=3.4.4
X-Google-Language: ENGLISH,ASCII-7-bit
X-Google-Thread: 103376,3334f982144a667d
X-Google-Attributes: gid103376,public
From: Charles Hixson <charleshixson@earthling.net>
Subject: Re: javadoc => adadoc?
Date: 1998/08/03
Message-ID: <35C5DAC4.F68DA421@earthling.net>#1/1
X-Deja-AN: 377521571
Content-Transfer-Encoding: 7bit
References: <6ptlbe$k3$1@nnrp1.dejanews.com> <6pvslq$poo@drn.newsguy.com>
 <6q4k5q$10uo$1@mdnews.btv.ibm.com>
Content-Type: text/plain; charset=us-ascii
Organization: http://extra.newsguy.com
Mime-Version: 1.0
Newsgroups: comp.lang.ada
Date: 1998-08-03T00:00:00+00:00
List-Id: <comp.lang.ada>

Norman H. Cohen wrote:
> 
> nabbasi@earthlink.net wrote in message <6pvslq$poo@drn.newsguy.com>...
	/* snip */ 
> The true benefit of javadoc is the automated generation of hypertext
> documentation that can be viewed with a browser.  Indices by package, by
> class, and by method name, as well as links to related pages (e.g. from the
	/* snip */ 
> -- Norman Cohen
And the main disadvantage of javadoc is that once a person gets a html
document, one is apt to be satisfied with that as having done the job of
documentation.  Unfortunately, this doesn't work so well except in a few
restricted contexts.  There is no global index, for example...just TRY
to turn javaDoc documentation into something that is useful off-line (it
can be done, but it isn't easy, at least not with the tools that I have
available!).
-- 
Charles Hixson	charleshixson@earthling.net
(510) 464-7733	or chixso@mtc.dst.ca.us