tomcat-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From kkoli...@apache.org
Subject svn commit: r1201576 - in /tomcat/trunk: BUILDING.txt webapps/docs/building.xml
Date Mon, 14 Nov 2011 02:17:53 GMT
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-unsubscribe@tomcat.apache.org
For additional commands, e-mail: dev-help@tomcat.apache.org


Mime
View raw message