cvs commit: jakarta-tomcat-catalina/webapps/docs building.xml
yoavs 2004/08/29 07:27:47 Modified:webapps/docs building.xml Log: Minor XML fixes to make style task stop choking ;) Revision ChangesPath 1.4 +4 -1 jakarta-tomcat-catalina/webapps/docs/building.xml Index: building.xml === RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/building.xml,v retrieving revision 1.3 retrieving revision 1.4 diff -u -r1.3 -r1.4 --- building.xml 27 Aug 2004 21:56:49 - 1.3 +++ building.xml 29 Aug 2004 14:27:46 - 1.4 @@ -151,6 +151,7 @@ described above. However, some developers like to work on Java code with a Java IDE, and the following steps have been used by some developers. +/p p Note that you bmust/b complete all the above steps to fetch @@ -207,7 +208,9 @@ p The same general idea should work in most IDEs; it has been reported to work in Idea, for example. -p +/p + +/section /body /document - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-catalina/webapps/docs building.xml
idarwin 2004/08/27 14:56:50
Modified:webapps/docs building.xml
Log:
Add some notes on building the code under Eclipse. Based on several
emails from Costin - thanks!
Revision ChangesPath
1.3 +68 -0 jakarta-tomcat-catalina/webapps/docs/building.xml
Index: building.xml
===
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/building.xml,v
retrieving revision 1.2
retrieving revision 1.3
diff -u -r1.2 -r1.3
--- building.xml 21 Sep 2003 15:36:53 - 1.2
+++ building.xml 27 Aug 2004 21:56:49 - 1.3
@@ -141,5 +141,73 @@
/section
+section name=Building with Eclipse
+
+p
+bImportant:/b
+This is not a supported means of building Tomcat; this information is
+provided without warranty :-).
+The only supported means of building Tomcat is with the ant build
+described above.
+However, some developers like to work on Java code with a Java IDE,
+and the following steps have been used by some developers.
+
+p
+Note that you bmust/b 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 3 projects.
+bNote/b 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.
+However, it will allow you to view and edit the Java code,
+get warnings, reformat code, perform refactorings, run Tomcat
+under the IDE, and so on.
+/p
+
+p
+Use File-gt;New Project to create a new Java project
+for each of the binaries repository (e.g., /usr/share/java),
+tomcat-connectors, tomcat-catalina, jasper, servletapi.
+Unless you thought ahead to make the ${tomcat.source} directory be under
+your Workspace folder, tell Eclipse the external location.
+The obvious dependencies will be needed; the repository project
+needs to export all its jars, and be referred to by the other projects.
+Eclipse will find all source trees and jars, and
+hopefully compile without problems
+You will need to add ${ant-home}/lib/ant.jar as an External Jar
+under Project Properties for some of these projects (notably those that fail
+to compile for want of BuildException).
+/p
+
+p
+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
+-Dcatalina.home=... (with the name of your build directory)
+as VM arguments.
+/p
+
+p
+Note also that due to the way the Tomcat source is assembled
+from several CVS projects, you may not be able to use the Eclipse
+CVS client to update (nor to commit, if you are a committer).
+Use the external CVS client of your choice, then use the
+Eclipse PackageExplorer or Navigator Refresh context menu item
+to tell Eclipse that you've updated the files.
+/p
+
+/section
+
+section name=Building with other IDEs
+p
+The same caveats apply as for Eclipse, above.
+/p
+
+p
+The same general idea should work in most IDEs; it has been reported
+to work in Idea, for example.
+p
+
/body
/document
-
To unsubscribe, e-mail: [EMAIL PROTECTED]
For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-catalina/webapps/docs building.xml
funkman 2003/09/21 08:36:53 Modified:webapps/docs building.xml Log: Typo per bz 23290 Revision ChangesPath 1.2 +1 -1 jakarta-tomcat-catalina/webapps/docs/building.xml Index: building.xml === RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/building.xml,v retrieving revision 1.1 retrieving revision 1.2 diff -u -r1.1 -r1.2 --- building.xml 8 Sep 2003 10:16:02 - 1.1 +++ building.xml 21 Sep 2003 15:36:53 - 1.2 @@ -25,7 +25,7 @@ section name=Download and install a Java Development Kit 1.4.x or later p -Ealier releases would also work, but are harder to work with due to the need to +Earlier releases would also work, but are harder to work with due to the need to download additional dependencies. Tomcat also runs much faster on the latest 1.4 JDK. /p - To unsubscribe, e-mail: [EMAIL PROTECTED] For additional commands, e-mail: [EMAIL PROTECTED]
cvs commit: jakarta-tomcat-catalina/webapps/docs building.xml index.xml project.xml
remm2003/09/08 03:16:02
Modified:webapps/docs index.xml project.xml
Added: webapps/docs building.xml
Log:
- Move build docs from the website to the documentation.
Revision ChangesPath
1.10 +4 -3 jakarta-tomcat-catalina/webapps/docs/index.xml
Index: index.xml
===
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/index.xml,v
retrieving revision 1.9
retrieving revision 1.10
diff -u -r1.9 -r1.10
--- index.xml 24 Jul 2003 15:26:13 - 1.9
+++ index.xml 8 Sep 2003 10:16:02 - 1.10
@@ -125,9 +125,10 @@
pThe following documents are for Java developers who wish to contribute to
the development of the emTomcat/em project./p
ul
-lia href=BUILDING.txtstrongBuilding from Source/strong/a - Details the
-steps necessary to download Tomcat 5 source code (and the other packages
-that it depends on), and build a binary distribution from those sources.
+lia href=building.htmlstrongBuilding from Source/strong/a -
+Details the steps necessary to download Tomcat 5 source code (and the
+other packages that it depends on), and build a binary distribution from
+those sources.
/li
lia href=changelog.htmlstrongChangelog/strong/a - Details the
changes made to Tomcat.
1.15 +1 -1 jakarta-tomcat-catalina/webapps/docs/project.xml
Index: project.xml
===
RCS file: /home/cvs/jakarta-tomcat-catalina/webapps/docs/project.xml,v
retrieving revision 1.14
retrieving revision 1.15
diff -u -r1.14 -r1.15
--- project.xml 14 Jul 2003 16:20:11 - 1.14
+++ project.xml 8 Sep 2003 10:16:02 - 1.15
@@ -49,7 +49,7 @@
/menu
menu name=Tomcat Development
-item name=Building from Source href=BUILDING.txt/
+item name=Building href=building.html/
item name=Changelog href=changelog.html/
item name=Statushref=status.html/
item name=Developershref=developers.html/
1.1 jakarta-tomcat-catalina/webapps/docs/building.xml
Index: building.xml
===
?xml version=1.0?
!DOCTYPE document [
!ENTITY project SYSTEM project.xml
]
document
project;
properties
authorRemy Maucherat/author
titleBuilding Tomcat/title
/properties
body
section name=Introduction
p
Building Tomcat from CVS is very easy, and is the first step to contributing to
Tomcat. The following is a step by step TODO list.
/p
/section
section name=Download and install a Java Development Kit 1.4.x or later
p
Ealier releases would also work, but are harder to work with due to the need to
download additional dependencies. Tomcat also runs much faster on
the latest 1.4 JDK.
/p
p
The Sun JDK can be downloaded a href=http://java.sun.com/j2se/;here/a.
/p
p
bIMPORTANT/b: Set an environment variable JAVA_HOME to the pathname of the
directory into which you installed the JDK release.
/p
/section
section name=Install Apache Ant 1.5.x
p
Download a binary distribution of Ant 1.5.x from
a href=http://ant.apache.org/bindownload.cgi;here/a.
/p
p
Unpack the binary distribution into a convenient location so that the
Ant release resides in its own directory (conventionally named
jakarta-ant-1.5.1). For the purposes of the remainder of this document,
the symbolic name ${ant.home} is used to refer to the full pathname of
the release directory.
/p
p
Create an ANT_HOME environment variable to point the directory ${ant.home},
and modify the PATH environment variable to include directory
${ant.home}/bin in its list. This makes the ant command line script
available, which will be used to actually perform the build.
/p
/section
section name=Building Tomcat
p
Download the main build.xml script from a href=build.xmlhere/a.
/p
p
Create a new directory, and copy the newly download build.xml to it. This
directory will be referred to as the ${tomcat.source} directory in the rest
of this document.
/p
p
Go to that directory, and do:
codebr/
cd ${tomcat.source}br/
antbr/
/code
/p
p
NOTE: Users accessing the Internet through a proxy must use a properties
file to indicate to Ant the proxy configuration. Read below.
/p
p
WARNING: Running this command will checkout the Tomcat 5 sources from CVS, as
well as download binaries to the code/usr/share/java/code directory.
Make sure this is appropriate to do so on your computer. On Windows,
this usually corresponds to the codeC:\usr\share\java/code directory,
unless Cygwin is
