Contributing to Tomcat docs, short version

[André Warnier <aw...@ice-sa.com>]

Re: http://tomcat.apache.org/connectors-doc/miscellaneous/doccontrib.html

Warning to potential contributors :
The deceptively innocent line

C:\build\>svn checkout
http://svn.apache.org/repos/asf/tomcat/connectors/ tomcat-connectors

corresponds in reality to the download of more than 2.5 GB, in several
hundreds thousands directories and files.

Advantage: you will get access to the code and documentation of every
single Tomcat connector version since the Jurassic era.

Potential disadvantage : don't do this on your laptop, from your hotel
room, over an UMTS connection.

For more details, see the long version.



---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org

Re: Contributing to Tomcat docs, short version

[Rainer Jung <ra...@kippdata.de>]

Hi André,

seems you have adventurous holidays ;)

On 10.04.2009 18:27, André Warnier wrote:
> Re: http://tomcat.apache.org/connectors-doc/miscellaneous/doccontrib.html
> 
> Warning to potential contributors :
> The deceptively innocent line
> 
> C:\build\>svn checkout
> http://svn.apache.org/repos/asf/tomcat/connectors/ tomcat-connectors
> 
> corresponds in reality to the download of more than 2.5 GB, in several
> hundreds thousands directories and files.
> 
> Advantage: you will get access to the code and documentation of every
> single Tomcat connector version since the Jurassic era.
> 
> Potential disadvantage : don't do this on your laptop, from your hotel
> room, over an UMTS connection.
> 
> For more details, see the long version.

I just updated to URL on this docs page. Long ago, that URL was correct,
but in the meantime there was a new directory layer added, namely
"trunk" for the most recent line of development, but also "tags" for all
the release tags, not only of mod_jk, but also of al other components
using parts of that source tree (e.g. Tomcat 4.1, Tomcat 5.0 and 5.5).

I added "trunk" to all svn connector URLs used on that docs page.

The new page should be live in a few hours.

Sorry for the trouble and go, fix a few more docs bugs :)

BTW: Before you start working on something, e.g. located in the trunk
directory, do "svn up" while standing there. Otherwise you risk working
on an old revision and when you produce a patch, it might not apply
cleanly to the latest version.

Usually the change rate for docs it not very high, but doing the svn up
as a standard action before starting work might be good.

Regards,

Rainer

---------------------------------------------------------------------
To unsubscribe, e-mail: users-unsubscribe@tomcat.apache.org
For additional commands, e-mail: users-help@tomcat.apache.org