Author: markt Date: Fri Aug 7 22:26:21 2009 New Revision: 802256 URL: http://svn.apache.org/viewvc?rev=802256&view=rev Log: Update svn docs. Singificantly simpler now the tc5.5.x modules are in one place rather than using externals.
Modified: tomcat/site/trunk/docs/svn.html tomcat/site/trunk/xdocs/svn.xml Modified: tomcat/site/trunk/docs/svn.html URL: http://svn.apache.org/viewvc/tomcat/site/trunk/docs/svn.html?rev=802256&r1=802255&r2=802256&view=diff ============================================================================== --- tomcat/site/trunk/docs/svn.html (original) +++ tomcat/site/trunk/docs/svn.html Fri Aug 7 22:26:21 2009 @@ -244,68 +244,53 @@ </tr> <tr> <td> -<a href="http://svn.apache.org/repos/asf/tomcat/build";> - <code>/build/</code> +<a href="http://svn.apache.org/repos/asf/tomcat/jk";> + <code>/jk/</code> </a> </td> - <td>Resources used to build the distributions for Tomcat 5.x</td> + <td>The native source code for the Tomcat Connectors. This includes + mod_jk, isapi and nsapi.</td> </tr> <tr> <td> -<a href="http://svn.apache.org/repos/asf/tomcat/container";> - <code>/container/</code> +<a href="http://svn.apache.org/repos/asf/tomcat/native";> + <code>/native/</code> </a> </td> - <td>The core Tomcat code for Tomcat 5.x</td> + <td>The native source code for the Tomcat Native/APR Connector.</td> </tr> <tr> <td> -<a href="http://svn.apache.org/repos/asf/tomcat/current";> - <code>/current/</code> +<a href="http://svn.apache.org/repos/asf/tomcat/sandbox";> + <code>/sandbox/</code> </a> </td> - <td>Single directory checkout for Tomcat 5.x</td> + <td>An area where Tomcat committers can experiment with new ideas.</td> </tr> <tr> <td> -<a href="http://svn.apache.org/repos/asf/tomcat/current-svn15";> - <code>/current-svn15</code> -</a> -</td> - <td>Single directory checkout for Tomcat 5.x using svn 1.5+ - style relative links for the externals</td> - </tr> - <tr> - <td> -<a href="http://svn.apache.org/repos/asf/tomcat/connectors";> - <code>/connectors/</code> -</a> -</td> - <td>The HTTP and AJP implementation code for Tomcat 5.x</td> - </tr> - <tr> - <td> -<a href="http://svn.apache.org/repos/asf/tomcat/jasper";> - <code>/jasper/</code> +<a href="http://svn.apache.org/repos/asf/tomcat/site";> + <code>/site/</code> </a> </td> - <td>The JSP engine implmentation for Tomcat 5.x</td> + <td>The Apache Tomcat website.</td> </tr> <tr> <td> -<a href="http://svn.apache.org/repos/asf/tomcat/servletapi";> - <code>/servletapi/</code> +<a href="http://svn.apache.org/repos/asf/tomcat/tags";> + <code>/tags/</code> </a> </td> - <td>The Servlet and JSP APIs for Tomcat 5.x</td> + <td>Tags for the primary development branch. Mainly used for modules.</td> </tr> <tr> <td> -<a href="http://svn.apache.org/repos/asf/tomcat/site";> - <code>/site/</code> +<a href="http://svn.apache.org/repos/asf/tomcat/tc5.5.x";> + <code>/tc5.5.x/</code> </a> </td> - <td>The Apache Tomcat website</td> + <td>The stable 5.5.x release branch, with separate modules but + no use of externals.</td> </tr> <tr> <td> @@ -314,7 +299,7 @@ </a> </td> <td>The stable 6.0.x release branch, with all modules in a single - unified tree</td> + unified tree.</td> </tr> <tr> <td> @@ -338,197 +323,6 @@ </td> </tr> </table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="Convenience directories"> -<strong>Convenience directories</strong> -</a> -</font> -</td> -</tr> -<tr> -<td> -<p> -<blockquote> -<p>Sources for Tomcat 6 are available from a single module.</p> -<p>Tomcat 5 requires sources from multiple modules. To simplify -checkouts of the latest sources for Tomcat 5, a Subversion feature -called externals has been used. This groups all the modules for this major -Tomcat version as sub-directories of a single directory and enables them to -be checked out in a single command. The modules included for each version are -listed in the section below.</p> - -<p>There are some caveats to remember. Since all the subdirectories are still -really different slices from the repository, relative paths won't always work -as expected, for example. See the -<a href="http://svnbook.red-bean.com/en/1.1/ch07s04.html";>Externals -Definitions</a> section of the <a href="http://svnbook.red-bean.com/";> -Subversion Book</a> for details.</p> - -<p>The URLs to use to checkout each version are:</p> -<table> - <tr> - <th>Apache Tomcat Version</th> -<th>URL</th> - </tr> - <tr> - <td>Current development</td> - <td>http://svn.apache.org/repos/asf/tomcat/trunk</td> - </tr> - <tr> - <td>6.0.x</td> - <td>http://svn.apache.org/repos/asf/tomcat/tc6.0.x</td> - </tr> - <tr> - <td>5.5.x (pre svn 1.5)</td> - <td>http://svn.apache.org/repos/asf/tomcat/current/tc5.5.x</td> - </tr> - <tr> - <td>5.5.x (svn 1.5+)</td> - <td>http://svn.apache.org/repos/asf/tomcat/current-svn15/tc5.5.x</td> - </tr> -</table> - -<p>Note that if you view the directory for Tomcat 5 in your browser -it will appear to be empty due to the use of externals.</p> -</blockquote> -</p> -</td> -</tr> -<tr> -<td> -<br/> -</td> -</tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="Sources by major version"> -<strong>Sources by major version</strong> -</a> -</font> -</td> -</tr> -<tr> -<td> -<p> -<blockquote> -<p>Tomcat 6.0.x is built from the following modules under -<a href="http://svn.apache.org/repos/asf/tomcat";> -http://svn.apache.org/repos/asf/tomcat</a>:</p> -<ul> - <li> -<a href="http://svn.apache.org/repos/asf/tomcat/tc6.0.x";> - <code>/tc6.0.x</code> -</a> -</li> -</ul> - -<p>Tomcat 5.5.x is built from the following modules under -<a href="http://svn.apache.org/repos/asf/tomcat";> -http://svn.apache.org/repos/asf/tomcat</a>:</p> -<ul> - <li> -<a href="http://svn.apache.org/repos/asf/tomcat/build/tc5.5.x";> - <code>/build/tc5.5.x</code> -</a> -</li> - <li> -<a href="http://svn.apache.org/repos/asf/tomcat/container/tc5.5.x";> - <code>/container/tc5.5.x</code> -</a> -</li> - <li> -<a href="http://svn.apache.org/repos/asf/tomcat/connectors/trunk";> - <code>/connectors/trunk</code> -</a> -</li> - <li> -<a href="http://svn.apache.org/repos/asf/tomcat/jasper/tc5.5.x";> - <code>/jasper/tc5.5.x</code> -</a> -</li> - <li> -<a href="http://svn.apache.org/repos/asf/tomcat/servletapi/servlet2.4-jsp2.0-tc5.x";> - <code>/servletapi/servlet2.4-jsp2.0-tc5.x</code> -</a> -</li> -</ul> - -<p>The Tomcat JK native connectors are built from the following module under -<a href="http://svn.apache.org/repos/asf/tomcat";> -http://svn.apache.org/repos/asf/tomcat</a>:</p> -<ul> - <li> -<a href="http://svn.apache.org/repos/asf/tomcat/connectors/trunk";> - <code>/connectors/trunk</code> -</a> -</li> -</ul> - - -</blockquote> -</p> -</td> -</tr> -<tr> -<td> -<br/> -</td> -</tr> -</table> -<table border="0" cellspacing="0" cellpadding="2" width="100%"> -<tr> -<td bgcolor="#525D76"> -<font color="#ffffff" face="arial,helvetica,sanserif"> -<a name="Principles"> -<strong>Principles</strong> -</a> -</font> -</td> -</tr> -<tr> -<td> -<p> -<blockquote> -<p>The Subversion repository has been structured using the following principles:</p> - -<ul> - <li>New major versions (after Tomcat 5.x) should use a single integrated - source repository.</li> - <li>Each current module should appear directly under the - <code>tomcat</code> directory.</li> - <li>Modules no longer used (eg tools service) should be clearly marked as - archived.</li> - <li>The <code>trunk</code> for each module should be the the branch of the - latest Apache Tomcat version that uses that module. Since there are always - several active versions at any one time, rather than be called - <code>trunk</code> this directory should be named using the Apache Tomcat - version it represents, eg <code>tc5.5.x</code>.</li> - <li>The branches for the other Apache Tomcat versions that use that module - will be placed in the <code>branches</code> directory for each component. - </li> - <li>Other (non-development) branches will be placed in the - <code>branches/other</code> directory in sub-directories that group the - other branches by the Apache Tomcat version from which they were - created.</li> - <li>Tags will be treated in exactly the same way as branches.</li> -</ul> - -</blockquote> -</p> -</td> -</tr> -<tr> -<td> -<br/> -</td> -</tr> -</table> </td> </tr> <!--FOOTER SEPARATOR--> Modified: tomcat/site/trunk/xdocs/svn.xml URL: http://svn.apache.org/viewvc/tomcat/site/trunk/xdocs/svn.xml?rev=802256&r1=802255&r2=802256&view=diff ============================================================================== --- tomcat/site/trunk/xdocs/svn.xml (original) +++ tomcat/site/trunk/xdocs/svn.xml Fri Aug 7 22:26:21 2009 @@ -37,51 +37,42 @@ <td>Modules that are no longer maintained</td> </tr> <tr> - <td><a href="http://svn.apache.org/repos/asf/tomcat/build";> - <code>/build/</code></a></td> - <td>Resources used to build the distributions for Tomcat 5.x</td> + <td><a href="http://svn.apache.org/repos/asf/tomcat/jk";> + <code>/jk/</code></a></td> + <td>The native source code for the Tomcat Connectors. This includes + mod_jk, isapi and nsapi.</td> </tr> <tr> - <td><a href="http://svn.apache.org/repos/asf/tomcat/container";> - <code>/container/</code></a></td> - <td>The core Tomcat code for Tomcat 5.x</td> + <td><a href="http://svn.apache.org/repos/asf/tomcat/native";> + <code>/native/</code></a></td> + <td>The native source code for the Tomcat Native/APR Connector.</td> </tr> <tr> - <td><a href="http://svn.apache.org/repos/asf/tomcat/current";> - <code>/current/</code></a></td> - <td>Single directory checkout for Tomcat 5.x</td> + <td><a href="http://svn.apache.org/repos/asf/tomcat/sandbox";> + <code>/sandbox/</code></a></td> + <td>An area where Tomcat committers can experiment with new ideas.</td> </tr> <tr> - <td><a href="http://svn.apache.org/repos/asf/tomcat/current-svn15";> - <code>/current-svn15</code></a></td> - <td>Single directory checkout for Tomcat 5.x using svn 1.5+ - style relative links for the externals</td> - </tr> - <tr> - <td><a href="http://svn.apache.org/repos/asf/tomcat/connectors";> - <code>/connectors/</code></a></td> - <td>The HTTP and AJP implementation code for Tomcat 5.x</td> - </tr> - <tr> - <td><a href="http://svn.apache.org/repos/asf/tomcat/jasper";> - <code>/jasper/</code></a></td> - <td>The JSP engine implmentation for Tomcat 5.x</td> + <td><a href="http://svn.apache.org/repos/asf/tomcat/site";> + <code>/site/</code></a></td> + <td>The Apache Tomcat website.</td> </tr> <tr> - <td><a href="http://svn.apache.org/repos/asf/tomcat/servletapi";> - <code>/servletapi/</code></a></td> - <td>The Servlet and JSP APIs for Tomcat 5.x</td> + <td><a href="http://svn.apache.org/repos/asf/tomcat/tags";> + <code>/tags/</code></a></td> + <td>Tags for the primary development branch. Mainly used for modules.</td> </tr> <tr> - <td><a href="http://svn.apache.org/repos/asf/tomcat/site";> - <code>/site/</code></a></td> - <td>The Apache Tomcat website</td> + <td><a href="http://svn.apache.org/repos/asf/tomcat/tc5.5.x";> + <code>/tc5.5.x/</code></a></td> + <td>The stable 5.5.x release branch, with separate modules but + no use of externals.</td> </tr> <tr> <td><a href="http://svn.apache.org/repos/asf/tomcat/tc6.0.x";> <code>/tc6.0.x/</code></a></td> <td>The stable 6.0.x release branch, with all modules in a single - unified tree</td> + unified tree.</td> </tr> <tr> <td><a href="http://svn.apache.org/repos/asf/tomcat/trunk";> @@ -94,111 +85,5 @@ </section> -<section name="Convenience directories"> -<p>Sources for Tomcat 6 are available from a single module.</p> -<p>Tomcat 5 requires sources from multiple modules. To simplify -checkouts of the latest sources for Tomcat 5, a Subversion feature -called externals has been used. This groups all the modules for this major -Tomcat version as sub-directories of a single directory and enables them to -be checked out in a single command. The modules included for each version are -listed in the section below.</p> - -<p>There are some caveats to remember. Since all the subdirectories are still -really different slices from the repository, relative paths won't always work -as expected, for example. See the -<a href="http://svnbook.red-bean.com/en/1.1/ch07s04.html";>Externals -Definitions</a> section of the <a href="http://svnbook.red-bean.com/";> -Subversion Book</a> for details.</p> - -<p>The URLs to use to checkout each version are:</p> -<table> - <tr> - <th>Apache Tomcat Version</th><th>URL</th> - </tr> - <tr> - <td>Current development</td> - <td>http://svn.apache.org/repos/asf/tomcat/trunk</td> - </tr> - <tr> - <td>6.0.x</td> - <td>http://svn.apache.org/repos/asf/tomcat/tc6.0.x</td> - </tr> - <tr> - <td>5.5.x (pre svn 1.5)</td> - <td>http://svn.apache.org/repos/asf/tomcat/current/tc5.5.x</td> - </tr> - <tr> - <td>5.5.x (svn 1.5+)</td> - <td>http://svn.apache.org/repos/asf/tomcat/current-svn15/tc5.5.x</td> - </tr> -</table> - -<p>Note that if you view the directory for Tomcat 5 in your browser -it will appear to be empty due to the use of externals.</p> -</section> - -<section name="Sources by major version"> -<p>Tomcat 6.0.x is built from the following modules under -<a href="http://svn.apache.org/repos/asf/tomcat";> -http://svn.apache.org/repos/asf/tomcat</a>:</p> -<ul> - <li><a href="http://svn.apache.org/repos/asf/tomcat/tc6.0.x";> - <code>/tc6.0.x</code></a></li> -</ul> - -<p>Tomcat 5.5.x is built from the following modules under -<a href="http://svn.apache.org/repos/asf/tomcat";> -http://svn.apache.org/repos/asf/tomcat</a>:</p> -<ul> - <li><a href="http://svn.apache.org/repos/asf/tomcat/build/tc5.5.x";> - <code>/build/tc5.5.x</code></a></li> - <li><a href="http://svn.apache.org/repos/asf/tomcat/container/tc5.5.x";> - <code>/container/tc5.5.x</code></a></li> - <li><a href="http://svn.apache.org/repos/asf/tomcat/connectors/trunk";> - <code>/connectors/trunk</code></a></li> - <li><a href="http://svn.apache.org/repos/asf/tomcat/jasper/tc5.5.x";> - <code>/jasper/tc5.5.x</code></a></li> - <li><a href="http://svn.apache.org/repos/asf/tomcat/servletapi/servlet2.4-jsp2.0-tc5.x";> - <code>/servletapi/servlet2.4-jsp2.0-tc5.x</code></a></li> -</ul> - -<p>The Tomcat JK native connectors are built from the following module under -<a href="http://svn.apache.org/repos/asf/tomcat";> -http://svn.apache.org/repos/asf/tomcat</a>:</p> -<ul> - <li><a href="http://svn.apache.org/repos/asf/tomcat/connectors/trunk";> - <code>/connectors/trunk</code></a></li> -</ul> - - -</section> - -<section name="Principles"> -<p>The Subversion repository has been structured using the following principles:</p> - -<ul> - <li>New major versions (after Tomcat 5.x) should use a single integrated - source repository.</li> - <li>Each current module should appear directly under the - <code>tomcat</code> directory.</li> - <li>Modules no longer used (eg tools service) should be clearly marked as - archived.</li> - <li>The <code>trunk</code> for each module should be the the branch of the - latest Apache Tomcat version that uses that module. Since there are always - several active versions at any one time, rather than be called - <code>trunk</code> this directory should be named using the Apache Tomcat - version it represents, eg <code>tc5.5.x</code>.</li> - <li>The branches for the other Apache Tomcat versions that use that module - will be placed in the <code>branches</code> directory for each component. - </li> - <li>Other (non-development) branches will be placed in the - <code>branches/other</code> directory in sub-directories that group the - other branches by the Apache Tomcat version from which they were - created.</li> - <li>Tags will be treated in exactly the same way as branches.</li> -</ul> - -</section> - </body> </document> --------------------------------------------------------------------- To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org For additional commands, e-mail: dev-h...@tomcat.apache.org