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 Tue, 18 Mar 2003 22:40:46 GMT

Rodent of Unusual Size wrote, On 18/03/2003 20.56:
> if the documentation is easily generated from a cvs checkout
> using tools any user will have available, not putting the
> generated files in cvs *might* be an option.  if building
> the docco requires either specialised tools or knowledge,
> the docco should be under cms control.  mho after doing
> this shite for twenty years.

I agree that putting generated stuff in CVS sucks big time.
The point is that users and developers like having these on the site.

For example, I might need the docs but have only the jar ATM, or I want 
to explain a thing on the list with a link to the javadocs.

Anyway, a solution for Java projects seems simple: make the project run 
under Gump, and these generated files will be published daily.
But this gives us the latest docs, not the ones of the last release.

So IMHO we should push these docs to the site by hand and not use the 
site CVS for it.

-- 
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