United StatesChange Country, Oracle Worldwide Web Sites Communities I am a... I want to...
Bug ID: JDK-4691095 javadoc prints unhelpful error message "foo.jar: Body tag missing from HTML"
JDK-4691095 : javadoc prints unhelpful error message "foo.jar: Body tag missing from HTML"

Details
Type:
Bug
Submit Date:
2002-05-24
Status:
Resolved
Updated Date:
2002-10-25
Project Name:
JDK
Resolved Date:
2002-10-25
Component:
docs
OS:
generic
Sub-Component:
doclet
CPU:
generic
Priority:
P4
Resolution:
Fixed
Affected Versions:
1.4.0
Fixed Versions:
1.4.2 (mantis)

Related Reports

Sub Tasks

Description

Name: rmT116609			Date: 05/23/2002


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) 
======================================================================

                                    

Comments
EVALUATION

This bug has been fixed.  The tool now prints a more detailed error message.
###@###.### 2002-09-21
                                     
2002-09-21
PUBLIC COMMENTS

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

                                     
2004-06-10
CONVERTED DATA

BugTraq+ Release Management Values

COMMIT TO FIX:
mantis

FIXED IN:
mantis

INTEGRATED IN:
mantis
mantis-b05


                                     
2004-06-14



Hardware and Software, Engineered to Work Together