From owner-freebsd-doc@FreeBSD.ORG Fri Dec 31 00:21:42 2004 Return-Path: Delivered-To: freebsd-doc@freebsd.org Received: from mx1.FreeBSD.org (mx1.freebsd.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 7169516A4CE; Fri, 31 Dec 2004 00:21:42 +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 BDBDE43D31; Fri, 31 Dec 2004 00:21:41 +0000 (GMT) (envelope-from herve.quiroz@esil.univ-mrs.fr) Received: from arabica.esil.univ-mrs.fr (localhost.esil.univ-mrs.fr [127.0.0.1])iBV0Lext060554; Fri, 31 Dec 2004 01:21:40 +0100 (CET) (envelope-from herve.quiroz@esil.univ-mrs.fr) Received: (from rv@localhost) by arabica.esil.univ-mrs.fr (8.13.1/8.13.1/Submit) id iBV0LZw5060553; Fri, 31 Dec 2004 01:21:35 +0100 (CET) (envelope-from herve.quiroz@esil.univ-mrs.fr) X-Authentication-Warning: arabica.esil.univ-mrs.fr: rv set sender to herve.quiroz@esil.univ-mrs.fr using -f Date: Fri, 31 Dec 2004 01:21:35 +0100 From: Herve Quiroz To: Mark Linimon Message-ID: <20041231002134.GB60094@arabica.esil.univ-mrs.fr> Mail-Followup-To: Mark Linimon , Herve Quiroz , FreeBSD-gnats-submit@FreeBSD.org, freebsd-doc@FreeBSD.org References: <200412292212.iBTMCQOw087198@arabica.esil.univ-mrs.fr> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline In-Reply-To: User-Agent: Mutt/1.4.2.1i cc: freebsd-doc@FreeBSD.org cc: FreeBSD-gnats-submit@FreeBSD.org cc: Herve Quiroz Subject: Re: docs/75636: [PATCH] Update the Porter's handbook - Java section X-BeenThere: freebsd-doc@freebsd.org X-Mailman-Version: 2.1.1 Precedence: list List-Id: Documentation project List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , X-List-Received-Date: Fri, 31 Dec 2004 00:21:42 -0000 Hi Mark, On Thu, Dec 30, 2004 at 02:54:55PM -0600, Mark Linimon wrote: > (Sorry, I'm barely able to keep up with email ATM due to outside > constraints, so I'm not sure this has already been addressed.) No problem. I assigned the PR to Greg but I'm glad you gave me feedback. Thanks for the review. BTW, all I know of doc/SGML stuff is what I learnt from you so I'm always glad when you teach me a new hint ;) > I would suggest: > > in . > > e.g. the name associated with that reference will be picked up and used. > It will also be properly highlighted in the web-based version. > > (You have 3 instances of this in the above IIRC.) Actually 5 :) Hence, the new patch. Herve 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 31 Dec 2004 00:00:03 -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,40 @@ 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 in + ) 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 in . + + If jikes is used in place of + javac (see USE_JIKES in + ), then Ant will automatically + use it to build the port. + @@ -4487,7 +4528,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 @@ -4518,8 +4559,8 @@ idea to override DATADIR to ${JAVASHAREDIR}/${PORTNAME} for Java ports. Indeed, DATADIR is automatically addded to - PLIST_SUB (documented here) so you may use + PLIST_SUB (documented in ) so you may use %%DATADIR%% directly in pkg-plist. @@ -4548,6 +4589,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 + in . +