docs/72500: Clean up Java and Jakarta Tomcat article

Chris Pepper pepper at reppep.com
Mon Oct 11 03:50:29 UTC 2004


>Number:         72500
>Category:       docs
>Synopsis:       Clean up Java and Jakarta Tomcat article
>Confidential:   no
>Severity:       serious
>Priority:       low
>Responsible:    freebsd-doc
>State:          open
>Quarter:        
>Keywords:       
>Date-Required:
>Class:          doc-bug
>Submitter-Id:   current-users
>Arrival-Date:   Mon Oct 11 03:50:26 GMT 2004
>Closed-Date:
>Last-Modified:
>Originator:     Chris Pepper
>Release:        FreeBSD 4.10-STABLE i386
>Organization:
>Environment:
System: FreeBSD www.reppep.com 4.10-STABLE FreeBSD 4.10-STABLE #16: Wed Jul 21 18:25:39 EDT 2004 root at www.reppep.com:/usr/obj/usr/src/sys/REPPEP i386


	
>Description:
	The article "Java and Jakarta Tomcat on FreeBSD" is a bit stale. It contains stale download instructions for the JDK 1.3.1 SDK.
	The language seems overly casual to me.
	In addition, there are some typos and various minor English nits in the article.
	
>How-To-Repeat:
	Visit http://www.freebsd.org/doc/en_US.ISO8859-1/articles/java-tomcat/
	
>Fix:
	Apply this patch
	

--- article.sgml.diff begins here ---
Index: article.sgml
===================================================================
RCS file: /home/ncvs/doc/en_US.ISO8859-1/articles/java-tomcat/article.sgml,v
retrieving revision 1.23
diff -u -r1.23 article.sgml
--- article.sgml	8 Aug 2004 13:43:55 -0000	1.23
+++ article.sgml	11 Oct 2004 03:36:56 -0000
@@ -105,29 +105,29 @@
   <sect1>
     <title>Introduction</title>
 
-    <para>The &java; programming language was birthed on <literal>May 23rd
+    <para>The &java; programming language was released on <literal>May 23rd
       1995</literal>.  One would expect that after all this time, &java;
-      applications would be easy to install and ready to run from a single
-      package, or port on FreeBSD, thus making it available for the
-      <quote>masses</quote>.  This is not the case, unfortunately, as
-      the &java; distribution is held very closely by Sun Microsystems,
-      and prohibits re-distribution.  All &java; Applets must be compiled
-      from source code, together with the &java; Development Kit from Sun
+      applications would be easy to install and ready to run from a
+      single package or port on FreeBSD, thus making it easy to use.
+      This is not the case, unfortunately, as the &java; distribution is
+      controlled very closely by Sun Microsystems, who prohibits
+      re-distribution.  All &java; applets must be compiled from source
+      code, together with the &java; Development Kit from Sun
       Microsystems.  All these ingredients must be blended together in
       the right order, assembled, and compiled by the end user.  With
       such distribution philosophies at heart, it is my opinion that
-      &java; will always be developer or hacker use only.  I certainly
-      found this to be true when I needed to serve up some
-      <filename>.jsp</filename> pages for a client on my web server,
-      and needed to get <filename
+      &java; on FreeBSD will always be for developer or hacker use only.
+      I certainly found this to be true when I needed to serve up some
+      <filename>.jsp</filename> pages for a client on my web server, and
+      needed to get <filename
       role="package">www/jakarta-tomcat4</filename> to work with
       <filename role="package">www/apache13</filename> on my FreeBSD
       system.</para>
 
-    <para>The Tomcat portion of the install is very straight forward, but
-      the difficulty I had was getting &java; Development Kit up and
-      running for FreeBSD 4.X, as Sun Microsystems only supplies
-      Binaries for Linux, &solaris;, and &windowsnt;.  This means that I
+    <para>The Tomcat portion of the install is very straightforward, but
+      the difficulty I had was getting the &java; Development Kit up and
+      running on FreeBSD 4.X, as Sun only supplies
+      binaries for Linux, &solaris;, and &windowsnt;.  This means that I
       had to compile my own &jdk; for FreeBSD.  I began by searching for
       documentation on the Internet.  I quickly found that there is more
       source code than I need along with patches to the source code, but
@@ -144,9 +144,9 @@
     <title>The &java; Environment</title>
 
     <para>Ensure that you have the current ports collection as
-      <command>make</command> it will fail if it attempts to build older
+      <command>make</command> will fail if it attempts to build older
       source.  You can upgrade your entire ports collection by using
-      <application>CVSup</application>.  See <ulink
+      <application>CVSup</application>.  See the <ulink
       url="&url.books.handbook;/cvsup.html">Using CVSup</ulink> section
       of the Handbook for more information.  You can also download the
       ports you need manually from <ulink
@@ -154,21 +154,22 @@
       get you going.</para>
 
       <note>
-	<para>You will need the <literal>Linux Emulation</literal>
+	<para>You will need <literal>Linux Emulation</literal>
 	  (Linux-ABI) enabled in your kernel configuration.  Simply add
-	  the following option to your kernel configuration file and
-	  recompile it.  Instructions for building a kernel can be found
-	  in the <ulink url="&url.books.handbook;/index.html">FreeBSD
-          Handbook</ulink>.</para>
+	  the following option to your kernel configuration file
+	  recompile it, and reinstall the kernel.  Instructions for
+	  building a kernel can be found in the <ulink
+	  url="&url.books.handbook;/index.html">FreeBSD
+	  Handbook</ulink>.</para>
 
 	<programlisting>options		COMPAT_LINUX</programlisting>
 
 	<para>The above option will add Linux-ABI support to your
-	  kernel, when it is recompiled.</para>
+	  kernel when it is next recompiled.</para>
       </note>
 
-    <para>The list of dependencies below, are required to be installed
-      manually in a certain order.  Dependencies that are automatically
+    <para>The listed dependencies below are required to be installed
+      manually in a the proper order.  Dependencies that are automatically
       downloaded are not listed here.</para>
 
     <itemizedlist>
@@ -192,8 +193,8 @@
       </step>
 
       <step>
-	<para>Next get out your web browser and head on over to
-	  <ulink url="http://java.sun.com/j2se/1.3/download-linux.html"></ulink>
+	<para>Next open your web browser and head over to <ulink
+          url="http://java.sun.com/j2se/1.3/download-linux.html"></ulink>
 	  and find SDK downloads. Click on the <quote>continue</quote>
 	  button below <quote>GNUZIP Tar Shell Script</quote>.  Be sure
 	  you read every word of the license page before you click on
@@ -205,25 +206,25 @@
 	  <quote>Open</quote> button rather than the <quote>Save</quote>
 	  button.  You will be presented with another <quote>File
 	  Download</quote> box - this time choose <quote>Save</quote>
-	  and you will be able to save
+	  and you will be able to get
           <filename>j2sdk-1_3_1_10-linux-i386.bin</filename>.
-	  Place it in <filename>/usr/ports/distfiles</filename>.</para>
+	  Put it in <filename>/usr/ports/distfiles</filename>.</para>
       </step>
 
       <step>
 	<para>Go to <ulink
-	  url="http://www.sun.com/software/java2/download.html"></ulink>.
-	  In the table under <literal>Produce Description</literal>,
-	  named <literal>Java 2 SDK 1.3.1</literal>, go to the
-	  right-hand cell and click <quote>download</quote>.  You will
+	  url="http://wwws.sun.com/software/communitysource/j2se/java2/download.html"></ulink>.
+	  In the table under <literal>Download Link(s)</literal>,
+	  for <literal>Java 2 SDK 1.3.1</literal>, go to the
+	  right-hand cell and click <quote>Download</quote>.  You will
 	  be taken to the <quote>Sign On</quote> page, where you must
 	  sign in if you already have an account, or register for
-	  access.  Once you have signed on, you will be taken to the
+	  access otherwise.  Once you have signed in, you will be taken to the
 	  <quote>Legal</quote> page, where you must accept the license
 	  agreement; scroll down (reading the license) and click on the
-	  <quote>Continue</quote> button.  Next page, is the
+	  <quote>Continue</quote> button.  The next page is the
 	  <quote>Receipt</quote> page.  This is where you will save your
-	  order number.  You will be able to choose the location that is
+	  order number.  You will be able to choose the server that is
 	  nearest to you.  Click on <quote>Java 2 SDK, Standard Edition,
 	  version 1.3.1</quote>.  Save the
 	  <filename>j2sdk-1_3_1-src.tar.gz</filename> to the
@@ -235,7 +236,7 @@
       <para>It is very important for you to read the License Agreement
 	which has been issued by Sun Microsystems Corp.  There are
 	several restrictions in place on the use of &java;, which you must
-	address. The FreeBSD Project does not take any responsibilities
+	address. The FreeBSD Project does not take any responsibility
 	for your actions.</para>
       
       <para>Do not discard any of the downloaded files, as they will be
@@ -280,27 +281,30 @@
     <procedure>
       <step>
 	<para>Make sure you have the
-	  <filename>j2sdk-1_3_1-src.tar.gz</filename> file in your
+	  <filename>j2sdk-1_3_1-src.tar.gz</filename> file in
 	  <filename>/usr/ports/distfiles</filename>.  This file is needed
-	  for applying the <quote>patch-set</quote> discussed below.</para>
+	  for applying the <quote>patchset</quote> discussed below.</para>
       </step>
 
       <step>
-	<para>You will need to download the <literal>patch set</literal>
-	  for building the port.  The patch-set file is called
+	<para>You will need to download the <literal>patchset</literal>
+	  for building the port.  The patchset file is called
 	  <filename>bsd-jdk131-patches-9.tar.gz</filename>.  You should
-	  also make sure the integrity of the files by matching it with
-	  the following <acronym>MD5</acronym> checksum.</para>
+	  verify the integrity of the file by checking its
+	  <acronym>MD5</acronym> checksum to make sure your copy isn't
+	  corrupt.</para>
+
+        <screen>md5 bsd-jdk131-patches-9.tar.gz</screen>
 
         <programlisting>
 MD5 (bsd-jdk131-patches-9.tar.gz) = 29c83880d3555abcf74fc7df9db1959f</programlisting>
 
-        <para>The patch-set is available from:  <ulink
+        <para>The patchset is available from: <ulink
 	  url="http://www.eyesbeyond.com/freebsddom/java/index.html"></ulink></para>
       </step>
     </procedure>
 
-    <para>The last procedure discussed above (building the native
+    <para>The last step above (building the native
       &jdk;) will take some time.</para>
   </sect1>
 
--- article.sgml.diff ends here ---


>Release-Note:
>Audit-Trail:
>Unformatted:



More information about the freebsd-doc mailing list