You are viewing a plain text version of this content. The canonical link for it is here.
Posted to dev@tomcat.apache.org by bu...@apache.org on 2003/05/14 05:22:14 UTC

DO NOT REPLY [Bug 19912] New: - Cleanup for jakarta-tomcat-5/BUILDING.txt

DO NOT REPLY TO THIS EMAIL, BUT PLEASE POST YOUR BUG 
RELATED COMMENTS THROUGH THE WEB INTERFACE AVAILABLE AT
<http://nagoya.apache.org/bugzilla/show_bug.cgi?id=19912>.
ANY REPLY MADE TO THIS MESSAGE WILL NOT BE COLLECTED AND 
INSERTED IN THE BUG DATABASE.

http://nagoya.apache.org/bugzilla/show_bug.cgi?id=19912

Cleanup for jakarta-tomcat-5/BUILDING.txt

           Summary: Cleanup for jakarta-tomcat-5/BUILDING.txt
           Product: Tomcat 5
           Version: Unknown
          Platform: All
        OS/Version: Other
            Status: NEW
          Severity: Minor
          Priority: Other
         Component: Catalina
        AssignedTo: tomcat-dev@jakarta.apache.org
        ReportedBy: pepper@rockefeller.edu


Various grammar nits
URLs should be in angle brackets (not parentheses) in plain text, per the RFC.
Why quote non-literal paths??

Index: BUILDING.txt
================================================================
===
RCS file: /home/cvspublic/jakarta-tomcat-5/BUILDING.txt,v
retrieving revision 1.30
diff -u -r1.30 BUILDING.txt
--- BUILDING.txt	26 Nov 2002 09:09:21 -0000	1.30
+++ BUILDING.txt	14 May 2003 03:19:31 -0000
@@ -5,8 +5,8 @@
                  ===========================================
 
 This subproject contains the source code for Tomcat 5, a container that
-implements the Servlet 2.4 and the JSP 2.0 specifications from the Java
-Community Process (http://www.jcp.org).  In order to build a binary
+implements the Servlet 2.4 and JSP 2.0 specifications from the Java
+Community Process <http://www.jcp.org/>.  In order to build a binary
 distribution version of the container from a source distribution, 
 do the following:
 
@@ -47,28 +47,28 @@
   the symbolic name "${ant.home}" is used to refer to the full pathname of
   the release directory.
 
-* Modify the PATH environment variable to include directory
-  "${ant.home}/bin" in its list.  This makes the "ant" command line script
+* Modify the PATH environment variable to include the directory
+  ${ant.home}/bin in its list.  This makes the "ant" command line script
   available, which will be used to actually perform the build.
 
 
 (1.2) Download and Install the Xalan 2 Distribution
 
-* Download a binary distribution of version 2.x from:
+* Download a binary distribution of Xalan version 2.x from:
 
   http://xml.apache.org/dist/xalan-j/
 
-  On a Windows platform, you will need:
+  On a Windows platform, you probably want:
     Xerces-J-bin.2.x.y.zip
 
-  On a Unix platform, you will need:
+  On a Unix platform, you probably want:
     Xerces-J-bin.2.x.y.tar.gz
 
 * Unpack the binary distribution into a convenient location so that the
   distribution resides in its own directory (conventionally named
   "xalan-2_x_y").
 
-* Copy the xalan.jar file from that distribution to the "${ant.home}/lib"
+* Copy the xalan.jar file from that distribution to the ${ant.home}/lib
   directory.
 
 
@@ -94,8 +94,8 @@
   file to indicate to Ant the proxy configuration. Read below.
 
 * WARNING: Running this command will checkout the Tomcat 5 sources from CVS, as
-  well as download binaries to the "/usr/local" directory. Make sure this is
-  appropriate to do so on your computer. On Windows, this usually corresponds
+  well as download binaries to the /usr/local directory. Make sure this is
+  appropriate to do on your computer. On Windows, this usually corresponds
   to the "C:\usr\local" directory, unless Cygwin is used. Read below to 
   customize the directory used to download the binaries.
 
@@ -116,7 +116,7 @@
 
 (3) Updating sources
 
-It is recommended to regularly update the downloaded Tomcat 5 sources. 
+It is recommended that you regularly update the downloaded Tomcat 5 sources. 
 To do this, execute the following commands:
 
     cd ${tomcat.source}
@@ -131,9 +131,5 @@
     ant build
 
 In addition, "ant build-depends" will build packages that 
-tomcat depends on ( commons-logging for now ), to ease fixes
-and debuging in those packages.
-
-
-
-  
\ No newline at end of file
+tomcat depends on (commons-logging for now), to ease fixes
+and debugging in those packages.

---------------------------------------------------------------------
To unsubscribe, e-mail: tomcat-dev-unsubscribe@jakarta.apache.org
For additional commands, e-mail: tomcat-dev-help@jakarta.apache.org