View | Details | Raw Unified | Return to bug 49955
Collapse All | Expand All

(-)webapps/docs/building.xml (-19 / +28 lines)
Lines 83-90 Link Here
83
<section name="Checkout or obtain the source code for Tomcat 7.0">
83
<section name="Checkout or obtain the source code for Tomcat 7.0">
84
84
85
  <p>
85
  <p>
86
  Tomcat SVN repository URL:
86
  Tomcat SVN repository URL's:
87
  <code>http://svn.apache.org/repos/asf/tomcat/tc7.0.x/</code>
87
  <table border="1">
88
  <tr><td><b>Trunk</b></td><td><code>http://svn.apache.org/repos/asf/tomcat/trunk/</code></td></tr>
89
  <tr><td><b>Other</b></td><td><code>http://svn.apache.org/repos/asf/tomcat/tc7.0.x/</code></td></tr>
90
  </table>
88
  </p>
91
  </p>
89
  
92
  
90
  <p>
93
  <p>
Lines 95-101 Link Here
95
  <p>
98
  <p>
96
  Checkout the source using SVN, selecting the desired version or
99
  Checkout the source using SVN, selecting the desired version or
97
  branch (current development source is at 
100
  branch (current development source is at 
98
  <code>http://svn.apache.org/repos/asf/tomcat/tc7.0.x/trunk/</code>), or 
101
  <code>http://svn.apache.org/repos/asf/tomcat/trunk/</code>), or 
99
  unpack the source package. The location where the source has been
102
  unpack the source package. The location where the source has been
100
  placed will be referred as ${tomcat.source}.
103
  placed will be referred as ${tomcat.source}.
101
  </p>
104
  </p>
Lines 160-167 Link Here
160
<p>
163
<p>
161
Note that you <b>must</b> complete all the above steps to fetch
164
Note that you <b>must</b> complete all the above steps to fetch
162
the repositories and build some JAR files the first time.
165
the repositories and build some JAR files the first time.
163
After you have completed the above steps, you can set up a
166
After you have completed the above steps, you can set up an
164
series of Eclipse 4 projects.
167
eclipse project.
165
<b>Note</b> that this will not let you build everything under Eclipse;
168
<b>Note</b> that this will not let you build everything under Eclipse;
166
the build process requires use of Ant for the many stages that aren't
169
the build process requires use of Ant for the many stages that aren't
167
simple Java compilations.
170
simple Java compilations.
Lines 188-215 Link Here
188
</p>
191
</p>
189
192
190
<p>
193
<p>
191
Eclipse .project and .classpath files are provided in to root directory of tomcat repository
194
There are two files in the root of the eclipse project. These are called 
192
should allow Eclipse to find all source trees and jars, and
195
<code>eclipse.project</code> and <code>eclipse.classpath</code> these should
193
hopefully compile without problems. <b>Note</b> that these
196
be renamed to <code>.project</code> and <code>.classpath</code> respectively.
194
files assume you are using Eclipse with a 6.0 or later JDK.
197
If the destination filenames have automatically been created by eclipse you 
198
need to delete them first.
199
200
The purpose of these files is to allow Eclipse to find all source trees and
201
jars, and hopefully compile without problems.
195
</p>
202
</p>
196
203
204
<p>You may see two errors in your problems tab at this point.
205
about missing dependencies one about jaxrpc and the other about 
206
wsdl4j. If this happens you have two choices remove these entries
207
from your classpath or run ant with the target 
208
"extras-webservices-prepare". See the section on "Building Tomcat" above.</p>
209
197
<p>
210
<p>
198
To run Tomcat without a special IDE plug-in, you can simply use Run-&gt;Run...
211
To run Tomcat without a special IDE plug-in, you can simply use Run-&gt;Run...
199
enter "org.apache.catalina.startup.Catalina" as the main class,
212
enter "org.apache.catalina.startup.Bootstrap" as the main class and
200
"start" as program arguments, and
201
"-Dcatalina.home=..." (with the name of your build directory) 
213
"-Dcatalina.home=..." (with the name of your build directory) 
202
as VM arguments.
214
as VM arguments.
203
</p>
215
</p>
204
216
205
<p>
217
<p>If you want tomcat to shutdown gracefully you can also go to 
206
Note also that due to the way the Tomcat source is assembled
218
Run&gt;Run&#160;Configurations right click on the launch you 
207
from several SVN projects, you may not be able to use the Eclipse
219
have just created and enter "stop" as the argument. 
208
SVN client to update (nor to commit, if you are a committer).
220
This launch configuration
209
Use the external SVN client of your choice, then use the
221
then be used to stop tomcat gracefully.</p>
210
Eclipse PackageExplorer or Navigator "Refresh" context menu item
211
to tell Eclipse that you've updated the files.
212
</p>
213
222
214
</section>
223
</section>
215
224

Return to bug 49955