From owner-freebsd-java Sun Aug 18 16:34:16 2002 Delivered-To: freebsd-java@freebsd.org Received: from mx1.FreeBSD.org (mx1.FreeBSD.org [216.136.204.125]) by hub.freebsd.org (Postfix) with ESMTP id 3CC3C37B400 for ; Sun, 18 Aug 2002 16:34:14 -0700 (PDT) Received: from smtp2.clear.net.nz (smtp2.clear.net.nz [203.97.37.27]) by mx1.FreeBSD.org (Postfix) with ESMTP id 9418043E65 for ; Sun, 18 Aug 2002 16:34:08 -0700 (PDT) (envelope-from calvin@varney.org) Received: from ubana.varney2.org (203-167-132-35.dialup.clear.net.nz [203.167.132.35]) by smtp2.clear.net.nz (CLEAR Net Mail) with ESMTP id <0H1200CUUC4LRO@smtp2.clear.net.nz> for freebsd-java@FreeBSD.ORG; Mon, 19 Aug 2002 11:33:59 +1200 (NZST) Date: Mon, 19 Aug 2002 11:05:23 +1200 From: Calvin Varney Subject: Re: Please review: new Java Project docs In-reply-to: <200208170958.14422.absinthe@pobox.com> To: absinthe@pobox.com Cc: freebsd-java@FreeBSD.ORG Message-id: <863ctbrcng.fsf@ubana.varney2.org> MIME-version: 1.0 Content-type: text/plain; charset=us-ascii User-Agent: Gnus/5.090007 (Oort Gnus v0.07) Emacs/21.2 (i386--freebsd) Lines: 46 References: <200208170958.14422.absinthe@pobox.com> Sender: owner-freebsd-java@FreeBSD.ORG Precedence: bulk List-ID: List-Archive: (Web Archive) List-Help: (List Instructions) List-Subscribe: List-Unsubscribe: X-Loop: FreeBSD.org Although you haven't asked for feedback on the documentation section I'd like to comment on "4.4. Proposal for Porting Java Applications and Tools" 1. If JAVALIBNAME is defined as ${PORTNAME}-${PORTVERSION} a symlink for ${PORTNAME} would be useful for managing dependencies. 2. Why should Javadocs be treated differently from ordinary documentation and placed anywhere other than ${DOCSDIR}? Javadocs are just another form of documentation and should be excluded when installing ports with NOPORTDOCS. 3. Regarding placing all library JAR files are in ${JAVAPREFIX}/classes/${JAVALIBNAME}/ a. Everything java involves classes. As this is a directory for just library classes would "lib" or "import" be a more appropriate directory name? b. Placing each library jar under its own ${JAVALIBNAME} directory will create many subdirectories with just one jar file (or few if different versions are installed). I'd suggest just placing them in ${JAVAPREFIX}/classes (or lib or import...). If a library includes more than one class file and isn't packaged within a jar a ${JAVALIBNAME} subdirectory could be appropriate or they could be jared during installation. c. Is there a need for ${JAVAPREFIX} at all? Why not install libraries in ${PREFIX}/share/javalib or ${PREFIX}/share/javaimport. I'm not sure of the intentions behind the additional java in the ${PREFIX}/share/java/classes hierarchy. I don't think ${PREFIX}/share/java is the right place for docs or examples and applications should reside in ${PREFIX}/share or ${PREFIX}. Are any other ports installed under a subdirectory denoting their implementation language? 4. Is there a need to break away from the existing standard of placing examples in ${EXAMPLESDIR} (default: ${PREFIX}/share/examples/${PORTNAME})? Just my thoughts. -- Calvin Varney To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-java" in the body of the message