source: nutchez-0.1/tomcat/webapps/docs/printer/BUILDING.txt @ 108

Last change on this file since 108 was 66, checked in by waue, 15 years ago

NutchEz - an easy way to nutch

File size: 4.6 KB
Line 
1================================================================================
2  Licensed to the Apache Software Foundation (ASF) under one or more
3  contributor license agreements.  See the NOTICE file distributed with
4  this work for additional information regarding copyright ownership.
5  The ASF licenses this file to You under the Apache License, Version 2.0
6  (the "License"); you may not use this file except in compliance with
7  the License.  You may obtain a copy of the License at
8
9      http://www.apache.org/licenses/LICENSE-2.0
10
11  Unless required by applicable law or agreed to in writing, software
12  distributed under the License is distributed on an "AS IS" BASIS,
13  WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
14  See the License for the specific language governing permissions and
15  limitations under the License.
16================================================================================
17
18$Id: BUILDING.txt 562769 2007-08-04 22:08:32Z markt $
19
20            ====================================================
21            Building The Apache Tomcat 6.0 Servlet/JSP Container
22            ====================================================
23
24This subproject contains the source code for Tomcat 6.0, a container that
25implements the Servlet 2.5 and JSP 2.1 specifications from the Java
26Community Process <http://www.jcp.org/>.  In order to build a binary
27distribution version of the container from a source distribution,
28do the following:
29
30
31(0) Download and Install a Java Development Kit
32
33* If the JDK is already installed, skip to (1).
34
35* Download a Java Development Kit (JDK) release (version 1.5.x or later) from:
36
37    http://java.sun.com/j2se/
38
39* Install the JDK according to the instructions included with the release.
40
41* Set an environment variable JAVA_HOME to the pathname of the directory
42  into which you installed the JDK release.
43
44
45(1) Install Apache Ant 1.6.x on your computer
46
47* If Apache Ant 1.6.x is already installed on your computer, skip to (2).
48
49* Download a binary distribution of Ant 1.6.x from:
50
51    http://ant.apache.org/bindownload.cgi
52
53* Unpack the binary distribution into a convenient location so that the
54  Ant release resides in its own directory (conventionally named
55  "apache-ant-[version]").  For the purposes of the remainder of this document,
56  the symbolic name "${ant.home}" is used to refer to the full pathname of
57  the release directory.
58
59* Create an ANT_HOME environment variable to point the directory
60  ${ant.home}.
61
62* Modify the PATH environment variable to include the directory
63  ${ant.home}/bin in its list.  This makes the "ant" command line script
64  available, which will be used to actually perform the build.
65
66
67(2) Building Tomcat 6.0
68
69(2.1) Checkout or obtain the source code for Tomcat 6.0
70
71* Tomcat SVN repository URL:
72  http://svn.apache.org/repos/asf/tomcat/tc6.0.x/
73
74* Download a source package from:
75  http://tomcat.apache.org/download-60.cgi
76
77* Checkout the source using SVN, selecting the desired version or
78  branch (current development source is at
79  http://svn.apache.org/repos/asf/tomcat/tc6.0.x/trunk/), or
80  unpack the source package. The location where the source has been
81  placed will be referred as ${tomcat.source}.
82
83(2.2) Building
84
85* Go to that directory, and do:
86
87    cd ${tomcat.source}
88    ant download
89    ant
90
91* NOTE: Users accessing the Internet through a proxy must use a properties
92  file to indicate to Ant the proxy configuration. Read below.
93
94* WARNING: Running this command will download binaries to the /usr/share/java
95  directory. Make sure this is appropriate to do on your computer. On Windows,
96  this usually corresponds to the "C:\usr\share\java" directory, unless Cygwin
97  is used. Read below to customize the directory used to download the binaries.
98
99* The build can be controlled by creating a ${tomcat.source}/build.properties
100  file, and adding the following content to it:
101
102    # ----- Proxy setup -----
103    # Uncomment if using a proxy server
104    #proxy.host=proxy.domain
105    #proxy.port=8080
106    #proxy.use=on
107
108    # ----- Default Base Path for Dependent Packages -----
109    # Replace this path with the directory path where dependencies binaries
110    # should be downloaded
111    base.path=/usr/share/java
112
113
114(3) Updating sources
115
116It is recommended that you regularly update the downloaded Tomcat 6 sources
117using your SVN client.
118
119(4) Rebuilds
120
121For a quick rebuild of only modified code you can use:
122   
123    cd ${tomcat.source}
124    ant
125
126(5) Building the servlet and jsp API documentation
127
128The documentation can be easly built:
129
130    cd ${tomcat.source}
131    ant -f dist.xml dist-javadoc
132
133(6) Building a release running tests:
134
135    cd ${tomcat.source}
136    ant -f dist.xml release
137
138
Note: See TracBrowser for help on using the repository browser.