From: Charles Hixson <charleshixson@earthling.net>
Subject: Re: javadoc => adadoc?
Date: 1998/08/03
Date: 1998-08-03T00:00:00+00:00 [thread overview]
Message-ID: <35C5DAC4.F68DA421@earthling.net> (raw)
In-Reply-To: 6q4k5q$10uo$1@mdnews.btv.ibm.com
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
next prev parent reply other threads:[~1998-08-03 0:00 UTC|newest]
Thread overview: 15+ messages / expand[flat|nested] mbox.gz Atom feed top
1998-07-31 0:00 javadoc => adadoc? nelson
1998-08-01 0:00 ` Matthew Heaney
1998-08-01 0:00 ` nabbasi
1998-08-03 0:00 ` Norman H. Cohen
1998-08-03 0:00 ` Charles Hixson [this message]
1998-08-04 0:00 ` Robert Dewar
1998-08-04 0:00 ` Larry Kilgallen
1998-08-04 0:00 ` Norman H. Cohen
1998-08-04 0:00 ` Brian Rogoff
1998-08-04 0:00 ` Charles Hixson
1998-08-17 0:00 ` Peter Hermann
1998-08-17 0:00 ` Corey Minyard
1998-08-18 0:00 ` Charles Hixson
1998-08-19 0:00 ` Samuel Tardieu
1998-08-26 0:00 ` Simon Wright
replies disabled
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox