From jhelfman@experts-exchange.com  Thu Aug 11 16:37:18 2011
Return-Path: <jhelfman@experts-exchange.com>
Received: from mx1.freebsd.org (mx1.freebsd.org [IPv6:2001:4f8:fff6::34])
	by hub.freebsd.org (Postfix) with ESMTP id 4404E106564A
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 11 Aug 2011 16:37:18 +0000 (UTC)
	(envelope-from jhelfman@experts-exchange.com)
Received: from mail.experts-exchange.com (mail.experts-exchange.com [72.29.183.251])
	by mx1.freebsd.org (Postfix) with ESMTP id 223648FC1D
	for <FreeBSD-gnats-submit@freebsd.org>; Thu, 11 Aug 2011 16:37:18 +0000 (UTC)
Received: from mail.experts-exchange.com (localhost [127.0.0.1])
	by mail.experts-exchange.com (Postfix) with ESMTP id 095DF6FD47A;
	Thu, 11 Aug 2011 09:37:18 -0700 (PDT)
Received: from mail.experts-exchange.com ([127.0.0.1])
	by mail.experts-exchange.com (mail.experts-exchange.com [127.0.0.1]) (amavisd-new, port 10024)
	with ESMTP id FCPIAkAPb2WR; Thu, 11 Aug 2011 09:37:17 -0700 (PDT)
Received: from experts-exchange.com (unknown [192.168.103.122])
	by mail.experts-exchange.com (Postfix) with SMTP id D79B26FD478;
	Thu, 11 Aug 2011 09:37:17 -0700 (PDT)
Received: (nullmailer pid 75368 invoked by uid 1001);
	Thu, 11 Aug 2011 16:36:34 -0000
Message-Id: <1313080594.082286.75367.nullmailer@experts-exchange.com>
Date: Thu, 11 Aug 2011 09:36:34 -0700
From: Jason Helfman <jhelfman@experts-exchange.com>
Reply-To: Jason Helfman <jhelfman@experts-exchange.com>
To: FreeBSD-gnats-submit@freebsd.org
Cc: ports@freebsd.org
Subject: [patch] book/porters-handbook: sync handbook with bsd.java.mk
X-Send-Pr-Version: 3.113
X-GNATS-Notify:

>Number:         159694
>Category:       docs
>Synopsis:       [patch] book/porters-handbook: sync handbook with bsd.java.mk
>Confidential:   no
>Severity:       non-critical
>Priority:       low
>Responsible:    linimon
>State:          closed
>Quarter:        
>Keywords:       
>Date-Required:  
>Class:          change-request
>Submitter-Id:   current-users
>Arrival-Date:   Thu Aug 11 16:40:09 UTC 2011
>Closed-Date:    Mon Aug 15 06:07:25 UTC 2011
>Last-Modified:  Mon Aug 15 06:07:25 UTC 2011
>Originator:     Jason Helfman
>Release:        FreeBSD 8.2-RELEASE i386
>Organization:
Experts Exchange, LLC.
>Environment:
System: FreeBSD eggman.experts-exchange.com 8.2-RELEASE FreeBSD 8.2-RELEASE #0: Fri Feb 18 02:24:46 UTC 2011 root@almeida.cse.buffalo.edu:/usr/obj/usr/src/sys/GENERIC i386


	
>Description:
Email from Edward Sutton, III to doc@
http://www.freebsd.org/doc/en_US.ISO8859-1/books/porters-handbook/book.html
refers to blackdown as a JAVA_VENDOR, among now outdated versions being
listed as choices and examples.

With this patch, sgml renders fine, and builds with no issue.

>How-To-Repeat:
	
>Fix:

Index: books/porters-handbook/book.sgml
===================================================================
RCS file: /home/jhelfman/ncvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v
retrieving revision 1.1113
diff -u -r1.1113 book.sgml
--- books/porters-handbook/book.sgml	20 Jul 2011 04:26:06 -0000	1.1113
+++ books/porters-handbook/book.sgml	11 Aug 2011 05:37:06 -0000
@@ -6170,8 +6170,8 @@
 	      <entry>List of space-separated suitable Java versions for
 		the port.  An optional <literal>"+"</literal> allows you to
 		specify a range of versions (allowed values:
-		<literal>1.1[+] 1.2[+] 1.3[+] 1.4[+] 1.5[+]
-		1.6[+]</literal>).</entry>
+		<literal>1.5[+] 1.6[+] 1.7[+]
+		</literal>).</entry>
 	    </row>
 
 	    <row>
@@ -6185,7 +6185,7 @@
 	      <entry><makevar>JAVA_VENDOR</makevar></entry>
 	      <entry>List of space-separated suitable JDK port vendors for
 		the port (allowed values: <literal>freebsd bsdjava sun
-		blackdown openjdk</literal>).</entry>
+		openjdk</literal>).</entry>
 	    </row>
 
 	    <row>
@@ -6242,13 +6242,13 @@
 	    <row>
 	      <entry><makevar>JAVA_PORT</makevar></entry>
 	      <entry>The name of the JDK port (e.g.
-		<literal>'java/jdk14'</literal>).</entry>
+		<literal>'java/diablo-jdk16'</literal>).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>JAVA_PORT_VERSION</makevar></entry>
 	      <entry>The full version of the JDK port (e.g.
-		<literal>'1.4.2'</literal>). If you only need the first
+		<literal>'1.6.0'</literal>). If you only need the first
 		two digits of this version number, use
 		<makevar>${JAVA_PORT_VERSION:C/^([0-9])\.([0-9])(.*)$/\1.\2/}</makevar>.</entry>
 	    </row>
@@ -6256,19 +6256,19 @@
 	    <row>
 	      <entry><makevar>JAVA_PORT_OS</makevar></entry>
 	      <entry>The operating system used by the JDK port (e.g.
-		<literal>'linux'</literal>).</entry>
+		<literal>'native'</literal>).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>JAVA_PORT_VENDOR</makevar></entry>
 	      <entry>The vendor of the JDK port (e.g.
-		<literal>'sun'</literal>).</entry>
+		<literal>'freebsd'</literal>).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>JAVA_PORT_OS_DESCRIPTION</makevar></entry>
 	      <entry>Description of the operating system used by the JDK port
-		(e.g. <literal>'Linux'</literal>).</entry>
+		(e.g. <literal>'Native'</literal>).</entry>
 	    </row>
 
 	    <row>
@@ -6280,34 +6280,34 @@
 	    <row>
 	      <entry><makevar>JAVA_HOME</makevar></entry>
 	      <entry>Path to the installation directory of the JDK (e.g.
-		<filename>'/usr/local/jdk1.3.1'</filename>).</entry>
+		<filename>'/usr/local/diablo-jdk1.6.0'</filename>).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>JAVAC</makevar></entry>
 	      <entry>Path to the Java compiler to use (e.g.
-		<filename>'/usr/local/jdk1.3.1/bin/javac'</filename> or
+		<filename>'/usr/local/diablo-jdk1.6.0/bin/javac'</filename> or
 		<filename>'/usr/local/bin/jikes'</filename>).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>JAR</makevar></entry>
 	      <entry>Path to the <command>jar</command> tool to use (e.g.
-		<filename>'/usr/local/jdk1.3.1/bin/jar'</filename> or
+		<filename>'/usr/local/diablo-jdk1.6.0/bin/jar'</filename> or
 		<filename>'/usr/local/bin/fastjar'</filename>).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>APPLETVIEWER</makevar></entry>
 	      <entry>Path to the <command>appletviewer</command> utility (e.g.
-		<filename>'/usr/local/linux-jdk1.3.1/bin/appletviewer'</filename>).</entry>
+		<filename>'/usr/local/diablo-jdk1.6.0/bin/appletviewer'</filename>).</entry>
 	    </row>
 
 	    <row>
 	      <entry><makevar>JAVA</makevar></entry>
 	      <entry>Path to the <command>java</command> executable. Use
 		this for executing Java programs (e.g.
-		<filename>'/usr/local/jdk1.3.1/bin/java'</filename>).</entry>
+		<filename>'/usr/local/diablo-jdk1.6.0/bin/java'</filename>).</entry>
 	    </row>
 
 	    <row>
>Release-Note:
>Audit-Trail:
State-Changed-From-To: open->closed 
State-Changed-By: linimon 
State-Changed-When: Mon Aug 15 06:06:49 UTC 2011 
State-Changed-Why:  
Committed, thanks.  Since the jikes port expired, I removed those 
references as well. 


Responsible-Changed-From-To: freebsd-doc->linimon 
Responsible-Changed-By: linimon 
Responsible-Changed-When: Mon Aug 15 06:06:49 UTC 2011 
Responsible-Changed-Why:  

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