Return-Path: Delivered-To: apmail-jakarta-ant-dev-archive@apache.org Received: (qmail 71144 invoked from network); 20 Feb 2002 09:55:26 -0000 Received: from unknown (HELO nagoya.betaversion.org) (192.18.49.131) by daedalus.apache.org with SMTP; 20 Feb 2002 09:55:26 -0000 Received: (qmail 6809 invoked by uid 97); 20 Feb 2002 09:55:35 -0000 Delivered-To: qmlist-jakarta-archive-ant-dev@jakarta.apache.org Received: (qmail 6770 invoked by uid 97); 20 Feb 2002 09:55:34 -0000 Mailing-List: contact ant-dev-help@jakarta.apache.org; run by ezmlm Precedence: bulk List-Unsubscribe: List-Subscribe: List-Help: List-Post: List-Id: "Ant Developers List" Reply-To: "Ant Developers List" Delivered-To: mailing list ant-dev@jakarta.apache.org Received: (qmail 6759 invoked from network); 20 Feb 2002 09:55:34 -0000 content-class: urn:content-classes:message MIME-Version: 1.0 Content-Type: text/plain; charset="iso-8859-1" Content-Transfer-Encoding: quoted-printable Subject: RE: [PATCH] /src/main/org/apache/tools/ant/IntrospectionHelper.java (More JavaDocs) X-MimeOLE: Produced By Microsoft Exchange V6.0.5762.3 Date: Wed, 20 Feb 2002 09:55:28 -0000 Message-ID: X-MS-Has-Attach: X-MS-TNEF-Correlator: Thread-Topic: [PATCH] /src/main/org/apache/tools/ant/IntrospectionHelper.java (More JavaDocs) Thread-Index: AcG54PDBHuw16JDARO+PfUrJC1K3qgAEnxqA From: "Jon Skeet" To: "Ant Developers List" X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N > I think the javadocs should work for all people who compile Ant, which > means they should work in 1.1, but then again, I'm sure I've added > {@link a b} constructs in several places myself. Well, I've now run across what seems to be a *big* problem with this = idea - and indeed one which I should have worked out earlier. JavaDoc will barf with an error if it can't find referenced classes etc. = I already realised this when trying to build all the JavaDocs to start = with - I've downloaded quite a few optional libraries, but not ones like = WebLogic etc. I just deleted those optional classes (as I needed to be = able to compile within Eclipse as well) and things were okay again. = However, this does mean that any optional classes which require Java2 = (NoExitSecurityManager for example) cause JavaDoc to barf under 1.1. We either need to build JavaDocs conditionally in the same way that we = build classes conditionally, or work out some other way of working - or = just say that building the JavaDocs is really only suitable for people = who are willing to either get all the dependencies or prune their source = tree. The good news is that even under 1.1 the construct: /** * JavaDoc */ // Non-JavaDoc public Foo() { } works. Maybe it's just under 1.2 that it fails... anyone got 1.2 installed and = fancy building the JavaDocs (given the caveat earlier!) ? If (when = building with -private) IntrospectionHelper's constructor looks okay, = we're fine. Jon -- To unsubscribe, e-mail: For additional commands, e-mail: