From pepper@reppep.com Mon Oct 11 03:42:26 2004 Return-Path: Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 9BD7116A4CE; Mon, 11 Oct 2004 03:42:26 +0000 (GMT) Received: from www.reppep.com (www.reppep.com [66.92.104.200]) by mx1.FreeBSD.org (Postfix) with ESMTP id 0439843D46; Mon, 11 Oct 2004 03:42:26 +0000 (GMT) (envelope-from pepper@reppep.com) Received: by www.reppep.com (Postfix, from userid 501) id 2960EFDC4; Sun, 10 Oct 2004 23:42:22 -0400 (EDT) Message-Id: <20041011034222.2960EFDC4@www.reppep.com> Date: Sun, 10 Oct 2004 23:42:22 -0400 (EDT) From: Chris Pepper Reply-To: Chris Pepper To: FreeBSD-gnats-submit@freebsd.org Cc: Victoria Chan , Hiten Pandya Subject: Clean up Java and Jakarta Tomcat article X-Send-Pr-Version: 3.113 X-GNATS-Notify: >Number: 72500 >Category: docs >Synopsis: Clean up Java and Jakarta Tomcat article >Confidential: no >Severity: serious >Priority: low >Responsible: phantom >State: closed >Quarter: >Keywords: >Date-Required: >Class: doc-bug >Submitter-Id: current-users >Arrival-Date: Mon Oct 11 03:50:26 GMT 2004 >Closed-Date: Wed Feb 09 09:21:25 GMT 2005 >Last-Modified: Wed Feb 09 09:21:25 GMT 2005 >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@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 @@ Introduction - The &java; programming language was birthed on May 23rd + The &java; programming language was released on May 23rd 1995. 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 - masses. 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 - .jsp pages for a client on my web server, - and needed to get .jsp pages for a client on my web server, and + needed to get www/jakarta-tomcat4 to work with www/apache13 on my FreeBSD system. - 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 + 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 @@ The &java; Environment Ensure that you have the current ports collection as - make it will fail if it attempts to build older + make will fail if it attempts to build older source. You can upgrade your entire ports collection by using - CVSup. See CVSup. See the Using CVSup section of the Handbook for more information. You can also download the ports you need manually from - You will need the Linux Emulation + You will need Linux Emulation (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 FreeBSD - Handbook. + the following option to your kernel configuration file + recompile it, and reinstall the kernel. Instructions for + building a kernel can be found in the FreeBSD + Handbook. options COMPAT_LINUX The above option will add Linux-ABI support to your - kernel, when it is recompiled. + kernel when it is next recompiled. - The list of dependencies below, are required to be installed - manually in a certain order. Dependencies that are automatically + The listed dependencies below are required to be installed + manually in a the proper order. Dependencies that are automatically downloaded are not listed here. @@ -192,8 +193,8 @@ - Next get out your web browser and head on over to - + Next open your web browser and head over to and find SDK downloads. Click on the continue button below GNUZIP Tar Shell Script. Be sure you read every word of the license page before you click on @@ -205,25 +206,25 @@ Open button rather than the Save button. You will be presented with another File Download box - this time choose Save - and you will be able to save + and you will be able to get j2sdk-1_3_1_10-linux-i386.bin. - Place it in /usr/ports/distfiles. + Put it in /usr/ports/distfiles. Go to . - In the table under Produce Description, - named Java 2 SDK 1.3.1, go to the - right-hand cell and click download. You will + url="http://wwws.sun.com/software/communitysource/j2se/java2/download.html">. + In the table under Download Link(s), + for Java 2 SDK 1.3.1, go to the + right-hand cell and click Download. You will be taken to the Sign On 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 Legal page, where you must accept the license agreement; scroll down (reading the license) and click on the - Continue button. Next page, is the + Continue button. The next page is the Receipt 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 Java 2 SDK, Standard Edition, version 1.3.1. Save the j2sdk-1_3_1-src.tar.gz to the @@ -235,7 +236,7 @@ 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. Do not discard any of the downloaded files, as they will be @@ -280,27 +281,30 @@ Make sure you have the - j2sdk-1_3_1-src.tar.gz file in your + j2sdk-1_3_1-src.tar.gz file in /usr/ports/distfiles. This file is needed - for applying the patch-set discussed below. + for applying the patchset discussed below. - You will need to download the patch set - for building the port. The patch-set file is called + You will need to download the patchset + for building the port. The patchset file is called bsd-jdk131-patches-9.tar.gz. You should - also make sure the integrity of the files by matching it with - the following MD5 checksum. + verify the integrity of the file by checking its + MD5 checksum to make sure your copy isn't + corrupt. + + md5 bsd-jdk131-patches-9.tar.gz MD5 (bsd-jdk131-patches-9.tar.gz) = 29c83880d3555abcf74fc7df9db1959f - The patch-set is available from: The patchset is available from: - The last procedure discussed above (building the native + The last step above (building the native &jdk;) will take some time. --- article.sgml.diff ends here --- >Release-Note: >Audit-Trail: From: Ceri Davies To: FreeBSD Gnats Submit Cc: Subject: Re: docs/72500: Clean up Java and Jakarta Tomcat article Date: Tue, 12 Oct 2004 22:40:57 +0100 Adding to audit trail, from misfiled PR docs/72583: Date: Tue, 12 Oct 2004 11:03:57 -0400 (EDT) From: Hiten Pandya Message-Id: In-Reply-To: <20041011034222.2960EFDC4@www.reppep.com> 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 From: Ceri Davies To: FreeBSD Gnats Submit Cc: Subject: Re: docs/72500: Clean up Java and Jakarta Tomcat article Date: Tue, 12 Oct 2004 22:41:55 +0100 Adding to audit trail, from misfiled PR docs/72586: Date: Tue, 12 Oct 2004 08:56:42 -0700 From: "Victoria Chan" Message-Id: <001501c4b074$124ae690$7200a8c0@admin> I am also busy but I have finally got around to building a 4.10 box and will do some researching. /v Responsible-Changed-From-To: freebsd-doc->phantom Responsible-Changed-By: phantom Responsible-Changed-When: Wed Feb 9 09:03:08 GMT 2005 Responsible-Changed-Why: I'll take care http://www.freebsd.org/cgi/query-pr.cgi?pr=72500 State-Changed-From-To: open->closed State-Changed-By: phantom State-Changed-When: Wed Feb 9 09:21:07 GMT 2005 State-Changed-Why: Committed. Thanks! http://www.freebsd.org/cgi/query-pr.cgi?pr=72500 >Unformatted: