|
Description
|
The tool only displayed the name of the JAR file when it printed an error message about a bad package.html file inside the JAR file. This bug has been
fixed. Now, there are more detailed messages like:
/home/jh104163/badPackageFileInJar.jar/pkg/package.html: Body tag missing from HTML
FULL PRODUCT VERSION :
java version "1.4.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.4.0-b92)
Java HotSpot(TM) Client VM (build 1.4.0-b92, mixed mode)
DESCRIPTION OF THE PROBLEM :
When running javadoc in a large autobuild process, I see a number of messages like:
server.jar: Body tag missing from HTML
1 error
While it is clear that javadoc is complaining about something having to do with server.jar, the error message gives no clue what the problem is or how to fix it. The evidence actually suggests that there isn't really a problem in the jar file, but that the error message is erroneously emitted.
Bug 1: This bug report is complaining that the actual error message printed is not specific enough to indicate where the problem is.
STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
The minimal examples may be found at:
http://www.alpine.bbn.com/~mthome/javadocbug.jar
grab the the above file and unpack it into a clean directory
of your choosing. It contains some .java files and some
.jar files used in the various "steps to reproduce" sections.
% cd /tmp/foo
% jar xf /tmp/javadocbug.jar
% mkdir api
# test 1
% javadoc -classpath server.jar -quiet -d api -sourcepath
src org.cougaar
EXPECTED VERSUS ACTUAL BEHAVIOR :
Actual:
Loading source files for package org.cougaar...
Constructing Javadoc information...
server.jar: Body tag missing from HTML
1 error
Expected:
1. clean javadoc run (in this case)
2. if there IS a real error found in a jar file, then the message should indicate which entry in the jar file is causing the problem.
ERROR MESSAGES/STACK TRACES THAT OCCUR :
server.jar: Body tag missing from HTML
This bug can be reproduced always.
(Review ID: 146956)
======================================================================
|
