From owner-freebsd-java Wed Mar 7 10:19:19 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 2AE5737B71A for ; Wed, 7 Mar 2001 10:19:15 -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 LAA02924; Wed, 7 Mar 2001 11:19:13 -0700 (MST) (envelope-from nate@nomad.yogotech.com) Received: (from nate@localhost) by nomad.yogotech.com (8.8.8/8.8.8) id LAA20135; Wed, 7 Mar 2001 11:19:04 -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.31639.553572.240950@nomad.yogotech.com> Date: Wed, 7 Mar 2001 11:19:03 -0700 (MST) To: Ernst de Haan Cc: Nate Williams , FreeBSD Java mailing list Subject: Re: JDK install: Unpack source ? In-Reply-To: <20010307190946.A1272@c187104187.telekabel.chello.nl> References: <20010307113713.A2897@c187104187.telekabel.chello.nl> <15014.29052.149045.46268@nomad.yogotech.com> <20010307184758.A1163@c187104187.telekabel.chello.nl> <15014.30024.816436.328056@nomad.yogotech.com> <20010307190946.A1272@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 > > 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. > > We have a miscommunication. I am a Java software developer, I create Javadoc > API documentation myself. So far so good. (BTW, I'm also a Java software developer, and also create Javadoc API docs as well.) > This is what I run javadoc for. What better tool is there for creating java documentation? :) > Seems I don't include the JDK source code at the moment. But I do recall that > I wanted to include it. Notice that I do include the source code for some > other libraries. Why are you including documentation for the JDK bits in your documentation? Why not just point the user at the JDK documentation? It seems redundant to include two copies of the JDK docs for a developer that needs to use your libraries. (I'm assuming that the docs are for developers, correct?) > > 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. > > Okay, I agree, but (a) for some AWT or Swing stuff there's hardly any choice > but to check the source code if you want to get certain things done If you're looking at AWT and Swing, then you *will* be bitten. There is *no* need to look at the source code to get certain things done. In particular, both the AWT and Swing toolkits have been completely re-written in each major JDK1.X release, such that *IF* you looked at the internals, it wouldn't have worked in subsequent releases. My last big 'GUI' project was 200K lines of code, including about 150K of them dealing with Swing/AWT. At no point did a developer require looking at the Swing/AWT source code to do their job, although I peeked a couple of times to help out another developer to make sure they weren't doing something wrong (ie; the documentation was incorrect). In any case, this discussion isn't appropriate for the java mailing list, so if you would like to continue it, we can take it offline. Nate To Unsubscribe: send mail to majordomo@FreeBSD.org with "unsubscribe freebsd-java" in the body of the message