Rodent of Unusual Size wrote, On 20/03/2003 16.19:
Nicola Ken Barozzi wrote:
The need: javadocs on site The situation: all site goes in CVS The drawback: javadocs in CVS suck Proposed Solution: javadocs go on site and not in CVS
can the docs be reproduced locally into the same usable format as they exist on the site, using a tool that anyone reading the docs would automatically have? or is the tool something that must be obtained separately, or would the generation into usable form require manual steps not documented for users?
It's part of the standard JDK, totally documented.
But
- one must download the source, which is usually not the case - the regular docs ususally link to the javadocs - it's convenient to be able to reference javadocs in mails and have all look at them in the discussion
For example, if you look at the ant mailing list, you will find users complaining that they don't find them online BTW IIRC.
--
Nicola Ken Barozzi [EMAIL PROTECTED]
- verba volant, scripta manent -
(discussions get forgotten, just code remains)
---------------------------------------------------------------------
--------------------------------------------------------------------- To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
