From hmp@freebsd.org  Tue Oct 12 15:05:34 2004
Return-Path: <hmp@freebsd.org>
Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125])
	by hub.freebsd.org (Postfix) with ESMTP id 9F0EC16A4CF
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 12 Oct 2004 15:05:34 +0000 (GMT)
Received: from fledge.watson.org (fledge.watson.org [204.156.12.50])
	by mx1.FreeBSD.org (Postfix) with ESMTP id 2AA9C43D1D
	for <FreeBSD-gnats-submit@freebsd.org>; Tue, 12 Oct 2004 15:05:34 +0000 (GMT)
	(envelope-from hmp@freebsd.org)
Received: from fledge.watson.org (localhost [127.0.0.1])
	by fledge.watson.org (8.13.1/8.13.1) with ESMTP id i9CF3wv5069407;
	Tue, 12 Oct 2004 11:03:58 -0400 (EDT)
	(envelope-from hmp@freebsd.org)
Received: from localhost (hmp@localhost)
	by fledge.watson.org (8.13.1/8.13.1/Submit) with SMTP id i9CF3v01069404;
	Tue, 12 Oct 2004 11:03:58 -0400 (EDT)
	(envelope-from hmp@freebsd.org)
Message-Id: <Pine.NEB.3.96L.1041012110309.69370A-100000@fledge.watson.org>
Date: Tue, 12 Oct 2004 11:03:57 -0400 (EDT)
From: Hiten Pandya <hmp@freebsd.org>
To: Chris Pepper <pepper@reppep.com>
Cc: FreeBSD-gnats-submit@freebsd.org,
	Victoria Chan <vkchan@kendryl.net>
In-Reply-To: <20041011034222.2960EFDC4@www.reppep.com>
Subject: Re: Clean up Java and Jakarta Tomcat article

>Number:         72583
>Category:       docs
>Synopsis:       Re: Clean up Java and Jakarta Tomcat article
>Confidential:   no
>Severity:       serious
>Priority:       medium
>Responsible:    ceri
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          sw-bug
>Submitter-Id:   current-users
>Arrival-Date:   Tue Oct 12 15:10:13 GMT 2004
>Closed-Date:    Tue Oct 12 21:42:47 GMT 2004
>Last-Modified:  Tue Oct 12 21:42:47 GMT 2004
>Originator:     
>Release:        
>Organization:
>Environment:
>Description:
 Looks good, if someone does not get to committing the patch, I will
 do it in about a week's time.  Very busy at the moment.
 
 Kind regards,
 
 Hiten Pandya
 hmp at freebsd.org
 
 On Sun, 10 Oct 2004, Chris Pepper wrote:
 
  :
  :>Submitter-Id:	current-users
  :>Originator:	Chris Pepper
  :>Organization:	
  :>Confidential:	no 
  :>Synopsis:	Clean up Java and Jakarta Tomcat article
  :>Severity:	serious
  :>Priority:	low
  :>Category:	docs
  :>Class:		doc-bug
  :>Release:	FreeBSD 4.10-STABLE i386
  :>Environment:
  :System: FreeBSD www.reppep.com 4.10-STABLE FreeBSD 4.10-STABLE #16: Wed Jul 21 18:25:39 EDT 2004 root@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 ---
  :
  :
  :
 
>How-To-Repeat:
>Fix:
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: ceri 
State-Changed-When: Tue Oct 12 21:42:08 GMT 2004 
State-Changed-Why:  
Misfiled followup to docs/72500 [content migrated]. 


Responsible-Changed-From-To: gnats-admin->ceri 
Responsible-Changed-By: ceri 
Responsible-Changed-When: Tue Oct 12 21:42:08 GMT 2004 
Responsible-Changed-Why:  
Take from gnats-admin. 

http://www.freebsd.org/cgi/query-pr.cgi?pr=72583 
>Unformatted:
