From owner-freebsd-ports  Sat Apr  6 13:41:57 2002
Delivered-To: freebsd-ports@freebsd.org
Received: from smtp.hccnet.nl (smtp.hccnet.nl [62.251.0.13])
	by hub.freebsd.org (Postfix) with ESMTP
	id 8899E37B416; Sat,  6 Apr 2002 13:41:47 -0800 (PST)
Received: from there by smtp.hccnet.nl
	via uds104-60.dial.hccnet.nl [62.251.60.104] with SMTP
	id XAA06645 (8.8.8/1.13); Sat, 6 Apr 2002 23:41:38 +0200 (MET DST)
Message-Id: <200204062141.XAA06645@smtp.hccnet.nl>
Content-Type: text/plain;
  charset="iso-8859-1"
From: Ernst de Haan <znerd@FreeBSD.org>
Organization: FreeBSD Project
To: java@FreeBSD.org, ports@FreeBSD.org
Subject: Default directory locations for Java ports
Date: Sat, 6 Apr 2002 23:41:16 +0200
X-Mailer: KMail [version 1.3.2]
MIME-Version: 1.0
Content-Transfer-Encoding: 8bit
Sender: owner-freebsd-ports@FreeBSD.ORG
Precedence: bulk
List-ID: <freebsd-ports.FreeBSD.ORG>
List-Archive: <http://docs.freebsd.org/mail/> (Web Archive)
List-Help: <mailto:majordomo@FreeBSD.ORG?subject=help> (List Instructions)
List-Subscribe: <mailto:majordomo@FreeBSD.ORG?subject=subscribe%20freebsd-ports>
List-Unsubscribe: <mailto:majordomo@FreeBSD.ORG?subject=unsubscribe%20freebsd-ports>
X-Loop: FreeBSD.org

Hi all,


We've been discussing default directory locations for Java library (!) ports 
quite a few times on this mailing list. My goal is to extend bsd.java.mk RSN 
to set these default directory locations.

One of my observations is that Java library ports usually install the 
following:
1) One or more JAR files. Typically one. If there's more than one, then you 
should ask yourself if the port should be split up.
2) Javadoc-generated API documentation.
3) Other documentation.
4) Examples.
5) Source files.

Only the JAR file is really mandatory. The other things are optional.

I propose that the following settings will be used by ports:

1) JAVA_LIBDESTDIR -- Destination directory for the JAR file(s).
2) JAVA_APIDOCDESTDIR -- Destination directory for Javadoc-generated
   API documentation.
3) DOCSDIR -- Destination directory for other API documentation.
4) EXAMPLESDIR -- Destination directory for examples.
5) JAVA_SRCDESTDIR -- Destination directory for .java source files.

Note that this proposal does not specify anything different for the '4) Other 
documentation' and '5) Examples' than other (non-Java library) ports would 
use. This is intentional. I think we should use what is already available, if 
it is really appropriate.

Apart from this first proposal, the second is that we use the following 
values for these settings:

# This setting is only used internally by bsd.java.mk, not by the port
__JAVA_SHAREDIR=	${PREFIX}/share/java

JAVA_LIBDESTDIR=${__JAVA_SHAREDIR}/lib/${PORTNAME}
JAVA_APIDOCDESTDIR=${__JAVA_SHAREDIR}/apidocs/${PORTNAME}
JAVA_SRCDESTDIR=${__JAVA_SHAREDIR}/src/${PORTNAME}


Comments are highly appreciated. I would like to commit these changes (or 
something similar) to bsd.java.mk next week.


Kind regards,


Ernst

To Unsubscribe: send mail to majordomo@FreeBSD.org
with "unsubscribe freebsd-ports" in the body of the message