Mailing-List: contact general-help@incubator.apache.org; run by ezmlm
Precedence: bulk
Reply-To: general@incubator.apache.org
Message-ID: <3E79E014.6080607@apache.org>
Date: Thu, 20 Mar 2003 16:36:52 +0100
From: Nicola Ken Barozzi <nicolaken@apache.org>
Reply-To: nicolaken@apache.org
Organization: Apache Software Foundation
User-Agent: Mozilla/5.0 (Windows; U; Windows NT 5.0; en-US;
 rv:1.3) Gecko/20030312
MIME-Version: 1.0
To: general@incubator.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
References: <08BAEFBC-584A-11D7-829A-000393B3C494@clove.org>
 <3E757DDF.8050906@apache.org> <3E79D720.5000204@Golux.Com>
 <3E79DA4F.60301@apache.org> <3E79DBEF.4050106@Golux.Com>
In-Reply-To: <3E79DBEF.4050106@Golux.Com>
Content-Type: text/plain; charset=us-ascii; format=flowed
Content-Transfer-Encoding: 7bit


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