Author: kkolinko
Date: Mon Nov 14 02:17:52 2011
New Revision: 1201576
URL: http://svn.apache.org/viewvc?rev=1201576&view=rev
Log:
Fix https://issues.apache.org/bugzilla/show_bug.cgi?id=52172
Make build instructions clearer about /usr/bin/java
Based on the patch by bimargulies
Modified:
tomcat/trunk/BUILDING.txt
tomcat/trunk/webapps/docs/building.xml
Modified: tomcat/trunk/BUILDING.txt
URL:
http://svn.apache.org/viewvc/tomcat/trunk/BUILDING.txt?rev=1201576&r1=1201575&r2=1201576&view=diff
==============================================================================
--- tomcat/trunk/BUILDING.txt (original)
+++ tomcat/trunk/BUILDING.txt Mon Nov 14 02:17:52 2011
@@ -91,9 +91,13 @@ do the following:
file to indicate to Ant the proxy configuration. Read below.
* WARNING: Running this command will download binaries to the /usr/share/java
- directory. Make sure this is appropriate to do on your computer. On Windows,
- this usually corresponds to the "C:\usr\share\java" directory, unless Cygwin
- is used. Read below to customize the directory used to download the binaries.
+ directory. On a typical Linux or MacOX system an ordinary user
+ will not have access to write to this directory, and, even if you do,
+ it may not be appropriate for you to write there.
+
+ On Windows this usually corresponds to the "C:\usr\share\java"
+ directory, unless Cygwin is used. Read the next section to learn how
+ to customize the directory used to download the binaries.
* The build can be controlled by creating a ${tomcat.source}/build.properties
file, and adding the following content to it:
@@ -107,7 +111,7 @@ do the following:
# ----- Default Base Path for Dependent Packages -----
# Replace this path with the directory path where dependencies binaries
# should be downloaded
- base.path=/usr/share/java
+ base.path=/home/me/some-place-to-download-to
(3) Updating sources
Modified: tomcat/trunk/webapps/docs/building.xml
URL:
http://svn.apache.org/viewvc/tomcat/trunk/webapps/docs/building.xml?rev=1201576&r1=1201575&r2=1201576&view=diff
==============================================================================
--- tomcat/trunk/webapps/docs/building.xml (original)
+++ tomcat/trunk/webapps/docs/building.xml Mon Nov 14 02:17:52 2011
@@ -119,10 +119,12 @@ Use the following commands to build Tomc
<p>
<b>WARNING:</b> Running this command will download binary binaries to the
<code>/usr/share/java</code> directory by default.
- Make sure this is appropriate to do so on your computer. On Windows,
+ On a typical Linux or MacOX system, an ordinary user
+ will not have access to write to this directory, and, even if you do,
+ it may not be appropriate for you to write there. On Windows
this usually corresponds to the <code>C:\usr\share\java</code> directory,
- unless Cygwin is used. Read below to customize the directory used
- to download the binaries.
+ unless Cygwin is used. Read below to learn how to customize the directory
+ used to download the binaries.
</p>
<p>
@@ -139,7 +141,7 @@ Use the following commands to build Tomc
# ----- Default Base Path for Dependent Packages -----<br/>
# Replace this path with the directory path where<br/>
# dependencies binaries should be downloaded.<br/>
- base.path=/usr/share/java<br/>
+ base.path=/home/me/some-place-to-download-to<br/>
</code>
</p>
@@ -168,6 +170,13 @@ However, it will allow you to view and e
get warnings, reformat code, perform refactorings, run Tomcat
under the IDE, and so on.
</p>
+
+<p>
+<b>WARNING:</b> Do not forget to create and configure
+ <code>${tomcat.source}/build.properties</code> file as described above
+ before running any Ant targets.
+</p>
+
<p>
Sample Eclipse project files and launch targets are provided in the
<code>res/ide-support/eclipse</code> directory of the source tree.
---------------------------------------------------------------------
To unsubscribe, e-mail: dev-unsubscr...@tomcat.apache.org
For additional commands, e-mail: dev-h...@tomcat.apache.org
