Bug 42942

Summary: Installation instructions very confusing
Product: Ports & Packages Reporter: Greg Lehey <grog>
Component: Individual Port(s)Assignee: Greg Lewis <glewis>
Status: Closed FIXED    
Severity: Affects Only Me    
Priority: Normal    
Version: Latest   
Hardware: Any   
OS: Any   

Description Greg Lehey 2002-09-19 03:20:01 UTC
	Installation instructions for java/jdk13 are confusing.

	On entering 'make', the following message appears (on a single
	line!):

	===>  jdk-1.3.1p7 You must manually fetch the source distribution and FreeBSD patches (j2sdk-1_3_1-src.tar.gz  bsd-jdk131-patches-7.tar.gz) from http://www.sun.com/software/java2/download.html and http://www.eyesbeyond.com/freebsddom/java/jdk13.html, place it in /usr/ports/distfiles and then run make again.

	Accessing http://wwws.sun.com/software/java2/download.html
	does not show a file j2sdk-1_3_1-src.tar.gz.  In order to find
	the file, it is necessary to follow the link "Java(TM) SDK
	1.3.1 Download", one of a current total of 9 download links,
	then log in (possibly after registration), and then select
	"Java 2 SDK, Standard Edition, version 1.3.1".

	There's another problem here, though.  In this particular
	case, I already had this file.  The one that was missing was
	bsd-jdk131-patches-7.tar.gz at
	http://www.eyesbeyond.com/freebsddom/java/jdk13.html.  In this
	case, the URL is wrong, and should be
	http://www.eyesbeyond.com/freebsddom/java/JDK13SCSLConfirm.html.

Fix: 

I would suggest:

	1.  Split the check for the base file from Sun and the patch
            sets.

	2.  For the source distribution, print a message something
            like:

	    Because of licensing restrictions, you must fetch the
	    source distribution manually.  Please access
	    http://www.sun.com/software/java2/download.htm with a web
	    browser and follow the link "Java(TM) SDK 1.3.1 Download".
	    You will be required to log in and register, but you can
	    create an account on this page.  After registration,
	    select "Java 2 SDK, Standard Edition, version 1.3.1".
	    Please place the file in /usr/ports/distfiles.

	3.  For the patch sets, something like:

	    The source distribution exists on your system, but due to
	    licensing restrictions you still need to download the
	    patch file bsd-jdk131-patches-7.tar.gz from
	    http://www.eyesbeyond.com/freebsddom/java/jdk13.html.
	    Please place the file in /usr/ports/distfiles.
How-To-Repeat: 	Install jdk13 for the first time, or repeat installation after
	the release of a new patch set.
Comment 1 Ying-Chieh Liao freebsd_committer freebsd_triage 2002-09-19 11:46:00 UTC
Responsible Changed
From-To: freebsd-ports->glewis

over to maintainer
Comment 2 Greg Lewis freebsd_committer freebsd_triage 2002-10-17 17:32:40 UTC
State Changed
From-To: open->closed

Updated instructions based on those submitted have been committed.