Attachment 47287 Details for Bug 72500 – article.sgml.diff

[patch] article.sgml.diff

article.sgml.diff (text/plain), 9.30 KB, created by Chris Pepper on 2004-10-11 04:50:26 UTC

(hide)

Description:

Filename:

MIME Type:

Creator: Chris Pepper

Created: 2004-10-11 04:50:26 UTC

Size: 9.30 KB

patch

obsolete

>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>

Actions: View | Diff

Attachments on bug 72500: 47287