ant-user mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Guillaume Rousse <rou...@ccr.jussieu.fr>
Subject javadoc get confused by java package running jsdk-1.4
Date Mon, 11 Mar 2002 18:20:28 GMT
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 <rousse@ccr.jussieu.fr>
GPG key http://lis.snv.jussieu.fr/~rousse/gpgkey.html

--
To unsubscribe, e-mail:   <mailto:ant-user-unsubscribe@jakarta.apache.org>
For additional commands, e-mail: <mailto:ant-user-help@jakarta.apache.org>


Mime
View raw message