Attachment 26047 Details for Bug 49955 – Fixes above problems and adds a section on shutdown.

[patch] Fixes above problems and adds a section on shutdown.

building.xml.patch (text/plain), 3.59 KB, created by Wesley on 2010-09-17 18:28:13 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Wesley

Created: 2010-09-17 18:28:13 UTC

Size: 3.59 KB

patch

obsolete

>Index: webapps/docs/building.xml
>===================================================================
>--- webapps/docs/building.xml	(revision 997505)
>+++ webapps/docs/building.xml	(working copy)
>@@ -83,8 +83,11 @@
> <section name="Checkout or obtain the source code for Tomcat 7.0">
> 
> 
>- Tomcat SVN repository URL:
>- <code>http://svn.apache.org/repos/asf/tomcat/tc7.0.x/</code>
>+ Tomcat SVN repository URL's:
>+ <table border="1">
>+ <tr><td>Trunk</td><td><code>http://svn.apache.org/repos/asf/tomcat/trunk/</code></td></tr>
>+ <tr><td>Other</td><td><code>http://svn.apache.org/repos/asf/tomcat/tc7.0.x/</code></td></tr>
>+ </table>
> 
> 
> 
>@@ -95,7 +98,7 @@
> 
> Checkout the source using SVN, selecting the desired version or
> branch (current development source is at 
>- <code>http://svn.apache.org/repos/asf/tomcat/tc7.0.x/trunk/</code>), or 
>+ <code>http://svn.apache.org/repos/asf/tomcat/trunk/</code>), or 
> unpack the source package. The location where the source has been
> placed will be referred as ${tomcat.source}.
> 
>@@ -160,8 +163,8 @@
> 
> Note that you must complete all the above steps to fetch
> the repositories and build some JAR files the first time.
>-After you have completed the above steps, you can set up a
>-series of Eclipse 4 projects.
>+After you have completed the above steps, you can set up an
>+eclipse project.
> Note that this will not let you build everything under Eclipse;
> the build process requires use of Ant for the many stages that aren't
> simple Java compilations.
>@@ -188,28 +191,34 @@
> 
> 
> 
>-Eclipse .project and .classpath files are provided in to root directory of tomcat repository
>-should allow Eclipse to find all source trees and jars, and
>-hopefully compile without problems. Note that these
>-files assume you are using Eclipse with a 6.0 or later JDK.
>+There are two files in the root of the eclipse project. These are called 
>+<code>eclipse.project</code> and <code>eclipse.classpath</code> these should
>+be renamed to <code>.project</code> and <code>.classpath</code> respectively.
>+If the destination filenames have automatically been created by eclipse you 
>+need to delete them first.
>+
>+The purpose of these files is to allow Eclipse to find all source trees and
>+jars, and hopefully compile without problems.
> 
> 
>+You may see two errors in your problems tab at this point.
>+about missing dependencies one about jaxrpc and the other about 
>+wsdl4j. If this happens you have two choices remove these entries
>+from your classpath or run ant with the target 
>+"extras-webservices-prepare". See the section on "Building Tomcat" above.
>+
> 
> To run Tomcat without a special IDE plug-in, you can simply use Run-&gt;Run...
>-enter "org.apache.catalina.startup.Catalina" as the main class,
>-"start" as program arguments, and
>+enter "org.apache.catalina.startup.Bootstrap" as the main class and
> "-Dcatalina.home=..." (with the name of your build directory) 
> as VM arguments.
> 
> 
>-
>-Note also that due to the way the Tomcat source is assembled
>-from several SVN projects, you may not be able to use the Eclipse
>-SVN client to update (nor to commit, if you are a committer).
>-Use the external SVN client of your choice, then use the
>-Eclipse PackageExplorer or Navigator "Refresh" context menu item
>-to tell Eclipse that you've updated the files.
>-
>+If you want tomcat to shutdown gracefully you can also go to 
>+Run&gt;Run&#160;Configurations right click on the launch you 
>+have just created and enter "stop" as the argument. 
>+This launch configuration
>+then be used to stop tomcat gracefully.
> 
> </section>
>

Actions: View | Diff

Attachments on bug 49955: 26047 | 26071