incubator-general mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Nicola Ken Barozzi <nicola...@apache.org>
Subject Re: cvs commit: incubator-site/build/site/projects/altrmi/api/org/apache/altrmi/server/impl/socket AbstractCompleteSocketStreamServer.html AbstractPartialSocketStreamServer.html CompleteSocketCustomStreamPipedBinder.html CompleteSocketCustomStreamPipedConnection.html CompleteSocketCustomStreamServer.html
Date Thu, 20 Mar 2003 15:36:52 GMT


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                   nicolaken@apache.org
             - verba volant, scripta manent -
    (discussions get forgotten, just code remains)
---------------------------------------------------------------------


---------------------------------------------------------------------
To unsubscribe, e-mail: general-unsubscribe@incubator.apache.org
For additional commands, e-mail: general-help@incubator.apache.org


Mime
View raw message