From owner-freebsd-java Wed Mar 7 9:52:17 2001 Delivered-To: freebsd-java@freebsd.org Received: from ns.yogotech.com (ns.yogotech.com [206.127.123.66]) by hub.freebsd.org (Postfix) with ESMTP id EBEFC37B719 for ; Wed, 7 Mar 2001 09:52:14 -0800 (PST) (envelope-from nate@yogotech.com) Received: from nomad.yogotech.com (nomad.yogotech.com [206.127.123.131]) by ns.yogotech.com (8.9.3/8.9.3) with ESMTP id KAA02403; Wed, 7 Mar 2001 10:52:13 -0700 (MST) (envelope-from nate@nomad.yogotech.com) Received: (from nate@localhost) by nomad.yogotech.com (8.8.8/8.8.8) id KAA19887; Wed, 7 Mar 2001 10:52:09 -0700 (MST) (envelope-from nate) From: Nate Williams MIME-Version: 1.0 Content-Type: text/plain; charset=us-ascii Content-Transfer-Encoding: 7bit Message-ID: <15014.30024.816436.328056@nomad.yogotech.com> Date: Wed, 7 Mar 2001 10:52:08 -0700 (MST) To: Ernst de Haan Cc: Nate Williams , FreeBSD Java mailing list Subject: Re: JDK install: Unpack source ? In-Reply-To: <20010307184758.A1163@c187104187.telekabel.chello.nl> References: <20010307113713.A2897@c187104187.telekabel.chello.nl> <15014.29052.149045.46268@nomad.yogotech.com> <20010307184758.A1163@c187104187.telekabel.chello.nl> X-Mailer: VM 6.75 under 21.1 (patch 12) "Channel Islands" XEmacs Lucid Reply-To: nate@yogotech.com (Nate Williams) Sender: owner-freebsd-java@FreeBSD.ORG Precedence: bulk X-Loop: FreeBSD.org > > No way. I *never* look at the source code anymore, but then again, I've > > no need to look at the source code except in rare cases. I try very > > hard to program to the API, rather than to look at the implementation > > because it makes my programs more portable. > > Well, in some cases I *do* need to check the source code, *and* javadoc wants > to have the JDK source code path specified in the -sourcepath > parameter. Why do you need to run javadoc? The documentation is provided complete in another port, so you should never need to run javadoc on the base stuff, AFAIK. > But while I'm writing this I'm wondering if (a) javadoc supports .jar > files in the source path and (b) if I *really* need the source code > for API docs generation, the Javadoc API docs should be enough. Now you're talking . :) > And the times I need to check the source code, is usually because the > API docs don't tell me half the story, or because I want to know what > approach is used in the JDK, for example w.r.t. the implementation of > some collection classes. Having done that for JDK1.0 and JDK1.1, I recommend you avoiding the sources if at all possible. Sun *radically* changed the internals class implementations from 1.0 -> 1.1 -> 1.2 -> 1.3. By looking at the internals, you are more likely to depend on 'internal' behavior that will no longer be relevant in subsuquent releases. Again, sometimes you have very little choice, but too many times this comes back to bite you. :( Nate To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-java" in the body of the message