From owner-freebsd-java Thu Feb 28 1:50:39 2002 Delivered-To: freebsd-java@freebsd.org Received: from shikima.mine.nu (pc1-card4-0-cust77.cdf.cable.ntl.com [62.252.49.77]) by hub.freebsd.org (Postfix) with ESMTP id E4F3437B400 for ; Thu, 28 Feb 2002 01:50:35 -0800 (PST) Received: from rasputin by shikima.mine.nu with local (Exim 3.33 #1) id 16gGRu-0000LP-00; Thu, 28 Feb 2002 02:37:38 +0000 Date: Thu, 28 Feb 2002 02:37:38 +0000 From: Rasputin To: Jesse McConnell Cc: java@freebsd.org Subject: Javadoc management [ was Re: bsd.java.mk ] Message-ID: <20020228023738.A1307@shikima.mine.nu> Reply-To: Rasputin References: <20020227073444.A91663@gallup.com> Mime-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Disposition: inline User-Agent: Mutt/1.2.5.1i In-Reply-To: <20020227073444.A91663@gallup.com>; from jesse@gallup.com on Wed, Feb 27, 2002 at 07:34:44AM -0600 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 * Jesse McConnell [020227 13:37]: > I wanted to comment on that bsd.java.mk file. I really like the > idea of adding it as I am working jboss ports at the moment. I should > make that a lot easier. One note that I think we might want to consider > is where javadoc information could go. > Perhaps if those are chosen to be installed then we could install them > into ${PREFIX}share/doc/java . All javadoc apis could be installed into > subdirs based on port name and then tweak a html file in that java > directory adding the link to that subdir's api info. Then flash a > message at the end of the port install mentioning that the docs are > browsable via a local browser or by linking to that directory from > perhaps /usr/local/www/data. That would all people to link in a page or > directory which would provide access to all javadoc info. That's a brilliant idea - I tried getting this to work when I first started with computers, and had to give up on it (mainly because in those days I had enough trouble getting my head round a command line to worry too hard about it). Has anyone tried using javadoc on the jars to regenerate a doc tree? This would have the benefit of integrating references between APIs. How long does your beard get before it finishes? -- In the force if Yoda's so strong, construct a sentence with words in the proper order then why can't he? Rasputin :: Jack of All Trades - Master of Nuns :: To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-java" in the body of the message