From owner-freebsd-doc@FreeBSD.ORG Wed Dec 29 22:20:19 2004 Return-Path: Delivered-To: freebsd-doc@hub.freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id A20A816A4CF for ; Wed, 29 Dec 2004 22:20:19 +0000 (GMT) Received: from freefall.freebsd.org (freefall.freebsd.org [216.136.204.21]) by mx1.FreeBSD.org (Postfix) with ESMTP id 6615543D4C for ; Wed, 29 Dec 2004 22:20:19 +0000 (GMT) (envelope-from gnats@FreeBSD.org) Received: from freefall.freebsd.org (gnats@localhost [127.0.0.1]) by freefall.freebsd.org (8.13.1/8.13.1) with ESMTP id iBTMKJkA018028 for ; Wed, 29 Dec 2004 22:20:19 GMT (envelope-from gnats@freefall.freebsd.org) Received: (from gnats@localhost) by freefall.freebsd.org (8.13.1/8.13.1/Submit) id iBTMKJh4018027; Wed, 29 Dec 2004 22:20:19 GMT (envelope-from gnats) Resent-Date: Wed, 29 Dec 2004 22:20:19 GMT Resent-Message-Id: <200412292220.iBTMKJh4018027@freefall.freebsd.org> Resent-From: FreeBSD-gnats-submit@FreeBSD.org (GNATS Filer) Resent-To: freebsd-doc@FreeBSD.org Resent-Reply-To: FreeBSD-gnats-submit@FreeBSD.org, Herve Quiroz Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id BEB3316A4CE for ; Wed, 29 Dec 2004 22:12:28 +0000 (GMT) Received: from arabica.esil.univ-mrs.fr (arabica.esil.univ-mrs.fr [139.124.41.108]) by mx1.FreeBSD.org (Postfix) with ESMTP id 30F5543D80 for ; Wed, 29 Dec 2004 22:12:28 +0000 (GMT) (envelope-from rv@arabica.esil.univ-mrs.fr) Received: from arabica.esil.univ-mrs.fr (localhost.esil.univ-mrs.fr [127.0.0.1])iBTMCQMi087199 for ; Wed, 29 Dec 2004 23:12:26 +0100 (CET) (envelope-from rv@arabica.esil.univ-mrs.fr) Received: (from rv@localhost) by arabica.esil.univ-mrs.fr (8.13.1/8.13.1/Submit) id iBTMCQOw087198; Wed, 29 Dec 2004 23:12:26 +0100 (CET) (envelope-from rv) Message-Id: <200412292212.iBTMCQOw087198@arabica.esil.univ-mrs.fr> Date: Wed, 29 Dec 2004 23:12:26 +0100 (CET) From: Herve Quiroz To: FreeBSD-gnats-submit@FreeBSD.org X-Send-Pr-Version: 3.113 Subject: docs/75636: [PATCH] Update the Porter's handbook - Java section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list Reply-To: Herve Quiroz List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Wed, 29 Dec 2004 22:20:19 -0000 >Number: 75636 >Category: docs >Synopsis: [PATCH] Update the Porter's handbook - Java section >Confidential: no >Severity: non-critical >Priority: low >Responsible: freebsd-doc >State: open >Quarter: >Keywords: >Date-Required: >Class: update >Submitter-Id: current-users >Arrival-Date: Wed Dec 29 22:20:19 GMT 2004 >Closed-Date: >Last-Modified: >Originator: Herve Quiroz >Release: FreeBSD 5.3-STABLE i386 >Organization: >Environment: System: FreeBSD 5.3-STABLE #1: Mon Dec 6 04:02:19 CET 2004 i386 >Description: Document the latest features from bsd.java.mk and detail a new policy regarding the 'java'category: - USE_ANT - HAVE_JIKES - JAVALIBDIR - New entries in SUB_LIST - Additional notes regarding the 'java' category - Improve the PLIST_FILES JAR file hint (use %%JAVAJARDIR%%) NOTE: There are several statements such as: "... (see MAKEVAR, documented here) ..." Another approach would be to use: "... (see MAKEVAR) ..." But I will let that up to you. NOTE2: I don't know where to document the JAVA_PREFERRED_PORT mechanism but I doubt this is the right place. Probably on the FreeBSD Java project homepage, if someone feels like updating it... NOTE3: We should also consider adding a statement regarding the use of javavmwrapper in application launcher shell scripts. I'm not quite sure about this one though. >How-To-Repeat: >Fix: Index: book.sgml =================================================================== RCS file: /var/fcvs/doc/en_US.ISO8859-1/books/porters-handbook/book.sgml,v retrieving revision 1.510 diff -u -r1.510 book.sgml --- book.sgml 22 Dec 2004 23:51:15 -0000 1.510 +++ book.sgml 29 Dec 2004 21:56:53 -0000 @@ -1536,7 +1536,10 @@ java Software related to the Java language. - + java shall not be the only + category for a port. Porters are also encouraged not to + use java as the main category of a + port. @@ -4297,7 +4300,10 @@ jikes (by setting 'no' or 'yes'). In the later case, devel/jikes will be added to build - dependencies of the port. + dependencies of the port. In any case that jikes + is actually used in place of javac, then the + HAVE_JIKES variable is defined by + bsd.java.mk. @@ -4435,6 +4441,11 @@ JDKs used ${JAVA_HOME}/lib/classes.zip. + + HAVE_JIKES + Defined whenever jikes is used by + the port (see USE_JIKES above). + @@ -4469,10 +4480,41 @@ Default: ${JAVASHAREDIR}/classes. + + JAVALIBDIR + The directory where JAR files installed by other + ports are located. Default: + ${LOCALBASE}/share/java/classes. + + The related entries are defined in both + PLIST_SUB (documented + here) and + SUB_LIST. + + + + + Building with Ant + + When the port is to be built using Apache Ant, it has to + define USE_ANT. Ant is thus considered to be + the sub-make command. When no do-build target + is defined by the port, a default one will be set that simply + runs Ant according to MAKE_ENV, + MAKE_ARGS and ALL_TARGETS. + This is similar to the USE_GMAKE mechanism, + which is documented here. + + + If jikes is used in place of + javac (see USE_JIKES + above), then Ant will + automatically use it to build the port. + @@ -4487,7 +4529,7 @@ statement (where myport.jar is the name of the JAR file installed as part of the port): - PLIST_FILES+= ${JAVAJARDIR:S,^${PREFIX}/,,}/myport.jar + PLIST_FILES+= %%JAVAJARDIR%%/myport.jar When porting a Java application, the port usually installs everything under a single directory (including its JAR @@ -4548,6 +4590,10 @@ the issue you are trying to resolve is related to either a JDK implementation or bsd.java.mk. + Similarly, there is a defined policy regarding the + CATEGORIES of a Java port, which is detailed + here. + >Release-Note: >Audit-Trail: >Unformatted: