Building javadoc is OK with jsdk 1.3.1, but fails with 1.4.0, due to javadoc
confusing package named java with source files.
[guillaume@bononcini argouml.orig]$ export JAVA_HOME=/usr/lib/sun-jsdk1.3
[guillaume@bononcini argouml.orig]$ ant javadoc
Buildfile: build.xml
init:
[echo] ------------------- ArgoUML 0.9.6 [2002] ----------------
prepare:
[echo] Preparing the build
check-javadoc:
javadoc:
[echo] Building javadoc
[javadoc] Generating Javadoc
[javadoc] Javadoc execution
[javadoc] Loading source files for package org.argouml.ui...
[javadoc] Loading source files for package org.argouml.ocl...
[javadoc] Loading source files for package org.argouml.uml...
[javadoc] Loading source files for package org.argouml.uml.ui...
[guillaume@bononcini argouml.orig]$ export JAVA_HOME=/usr/lib/sun-jsdk1.4
[guillaume@bononcini argouml.orig]$ ant javadoc
Buildfile: build.xml
init:
[echo] ------------------- ArgoUML 0.9.6 [2002] ----------------
prepare:
[echo] Preparing the build
check-javadoc:
javadoc:
[echo] Building javadoc
[javadoc] Generating Javadoc
[javadoc] Javadoc execution
[javadoc] Loading source file org.argouml.uml.reveng.java...
[javadoc] error: cannot read: org.argouml.uml.reveng.java
[javadoc] Loading source file org.argouml.language.java...
[javadoc] Loading source files for package org.argouml.ui...
[javadoc] Loading source files for package org.argouml.ocl...
[javadoc] Loading source files for package org.argouml.uml...
[javadoc] Loading source files for package org.argouml.uml.ui...
Here are the content of the offending dirs:
[guillaume@bononcini argouml.orig]$ ll src_new/org/argouml/uml/reveng/java/
total 265
-rw------- 1 guillaume guillaume 2134 mar 10 17:45 ArgoToken.java
-rw------- 1 guillaume guillaume 2555 mar 10 17:45
ClassifierContext.java
-rw------- 1 guillaume guillaume 382 mar 10 17:45
ClassifierNotFoundException.java
-rw------- 1 guillaume guillaume 2571 mar 10 17:45 Context.java
drwx------ 2 guillaume guillaume 152 mar 7 19:31 CVS/
-rw------- 1 guillaume guillaume 37245 mar 10 17:45 java.g
-rw------- 1 guillaume guillaume 6065 mar 10 17:45 JavaImport.java
-rw------- 1 guillaume guillaume 54290 mar 10 17:45 JavaLexer.java
-rw------- 1 guillaume guillaume 69569 mar 10 17:45 JavaRecognizer.java
-rw------- 1 guillaume guillaume 3339 mar 10 17:45 JavaTokenTypes.java
-rw------- 1 guillaume guillaume 2509 mar 10 17:45 JavaTokenTypes.txt
-rw------- 1 guillaume guillaume 40032 mar 10 17:45 Modeller.java
-rw------- 1 guillaume guillaume 4367 mar 10 17:45
OuterClassifierContext.java
-rw------- 1 guillaume guillaume 4460 mar 10 17:45 PackageContext.java
-rw------- 1 guillaume guillaume 1783 mar 10 17:45 package.html
-rw------- 1 guillaume guillaume 7181 mar 10 17:45 ParseState.java
[guillaume@bononcini argouml.orig]$ ll src_new/org/argouml/language/java/
total 51
drwx------ 4 guillaume guillaume 128 mar 10 17:52 cognitive/
drwx------ 2 guillaume guillaume 184 mar 7 19:31 CVS/
drwx------ 3 guillaume guillaume 912 mar 10 17:52 generator/
-rw------- 1 guillaume guillaume 15409 mar 10 17:45 JavaConstants.java
-rw------- 1 guillaume guillaume 1783 mar 10 17:45 package.html
-rw------- 1 guillaume guillaume 27551 mar 10 17:45 Token.java
drwx------ 3 guillaume guillaume 248 mar 10 17:52 ui/
I can't understand why only the first one triggers an error.
I can exclude package from javadoc, but not source files. I tried also to
prevent file research by listing package names without using * joker, with no
success.
Only thing related to javadoc behaviour change is this paragraph in jsdk
manual:
Document only legal classes - When documenting a package, Javadoc no longer
reads files whose names are not composed of legal class names. Example: When
passing com.sun.foo into Javadoc, it used to parse every file in the
directory com\sun\foo whose name ended with ".java", whether or not the
filename, stripped of that suffix, was actually a legal class name. Now
Javadoc will parse only files whose names are legal class names. This enables
developers to include templates, test source files, or other .java files that
will not be documented, by including, for example, a hyphen "-" in its
filename. (4398440)
BTW, running javadoc manually works :-)
I'm using linux, and a self-build ant-1.4.1. Is this worth a bug report ?
--
Guillaume Rousse <[EMAIL PROTECTED]>
GPG key http://lis.snv.jussieu.fr/~rousse/gpgkey.html
--
To unsubscribe, e-mail: <mailto:[EMAIL PROTECTED]>
For additional commands, e-mail: <mailto:[EMAIL PROTECTED]>
