Java Solaris Communities Sun Store Join SDN My Profile Why Join?
 
Bug Database
Bug Detail
Quick Lists
Top 25 Bugs
Top 25 RFE's
Recently Closed Bugs
Printable Page Printable Page


Bug Database
Bug ID: 4418115
Votes 0
Synopsis stddoclet: javadoc produces invalid index-all.html file (wrong !DOCTYPE)
Category doclet:tbd
Reported Against ladybird-beta
Release Fixed 1.4.2(mantis)
State 10-Fix Delivered, bug
Priority: 4-Low
Related Bugs
Submit Date 22-FEB-2001
Description
Fixed by same fix as 4275630: Generated HTML is invalid with frameset DTD.

Regresssion test at:
<ws>/test/com/sun/javadoc/ValidHtml/ValidHtml.java

 xxxxx@xxxxx  2002-09-25




java version "1.3.1-beta"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.1-beta-b15)
Java HotSpot(TM) Client VM (build 1.3.1beta-b15, mixed mode)

Java Source Code (Empty.java):
public class Empty { }

Steps to Reproduce:
javadoc Empty

The generated index-all.html file contains the DOCTYPE:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0
Frameset//EN""http://www.w3.org/TR/REC-html40/frameset.dtd">

But the index-all.html file is not a Frameset document, so should have the
following DOCTYPE instead:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01
Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
(Review ID: 117408) 
======================================================================
Work Around




Replace the <!DOCTYPE> tag in index-all.html each time javadoc is run.
======================================================================
Evaluation
This is nearly a dupe of 4418171, except that bug points out the class HTML file
contains the wrong DOCTYPE.  I don't know if the suggested fix is correct --
it would be prudent to first pass this new DOCTYPE by someone who understands them.
 xxxxx@xxxxx  2001-02-22
Comments
  
  Include a link with my name & email   

Submitted On 05-MAR-2001
schapel
The suggested fix is correct. There is no need to pass the 
DOCTYPE by a person. It would be better to use the W3C 
validator:
http://validator.w3.org/
to verify that the HTML documents that javadoc generates 
are indeed valid.



PLEASE NOTE: JDK6 is formerly known as Project Mustang