JDK-4415270 : stddoclet: HTML table tags inserted in wrong place in package use page (invalid)
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.3.0
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: solaris_2.6
  • CPU: sparc
  • Submitted: 2001-02-14
  • Updated: 2014-05-05
  • Resolved: 2002-10-25
The Version table provides details related to the release that this issue/RFE will be addressed.

Unresolved : Release in which this issue/RFE will be addressed.
Resolved: Release in which this issue/RFE has been resolved.
Fixed : Release in which this issue/RFE has been fixed. The release containing this fix may be available for download as an Early Access Release or a General Availabitlity Release.

To download the current JDK release, click here.
Other
1.4.2 mantisFixed
Description
On the package use pages (package-use.html), the heading for all the class
tables has these tags inserted at the wrong place:
 
</TR>
</FONT></TD>

They are mistakenly inserted at the end of the table, many rows after 
their start tags.  They should appear in a different order, ahead of 
the start of the second row in that table:

</FONT></TD></TR>
<TR BGCOLOR="white" CLASS="TableRowColor">

Both Netscape and IE seem to interpret the files correctly, however,
it would be better to generate proper HTML.

----------------------------
For example, see:
http://webwork.eng/j2se/1.3/docs/api/java/lang/ref/package-use.html

The second table starts with "Classes in java.lang.ref used by java.lang.ref"

Javadoc currently generates:
(Notice that the first row contains a cell that spans 2 columns and that the 
second row should start immediately after that cell.  Instead, the <TR> for that
second row is missing and the second row starts with <TD>.  Also notice that the
</FONT> is in the wrong place -- it comes far too late (since <FONT> tags cannot 
span cells), many rows later.  I've marked the bad end tags </TR></FONT></TD>
with ^^^^^^ below them.
--------- START ----------
<A NAME="java.lang.ref"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
Classes in <A HREF="../../../java/lang/ref/package-summary.html">java.lang.ref</A> used by 
<A HREF="../../../java/lang/ref/package-summary.html">java.lang.ref</A><TR BGCOLOR="white" CLASS="TableRowColor">
<TD><B><A HREF="../../../java/lang/ref/class-use/Reference.html#java.lang.ref"><B>Reference</B></A></B>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Abstract base class for reference objects.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><B><A HREF="../../../java/lang/ref/class-use/ReferenceQueue.html#java.lang.ref"><B>ReferenceQueue</B></A></B>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Reference queues, to which registered reference objects are appended by the
 garbage collector after the appropriate reachability changes are detected.</TD>
</TR>
^^^^^
</FONT></TD>
^^^^^^^^^^^^
</TR>
</TABLE>
---------- END ----------

What Javadoc should generate:
I've marked the correctly positioned </FONT></TD></TR> tags with ^^^^^^ below them.

--------- START ----------
<A NAME="java.lang.ref"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=2><FONT SIZE="+2">
Classes in <A HREF="../../../java/lang/ref/package-summary.html">java.lang.ref</A> used by 
<A HREF="../../../java/lang/ref/package-summary.html">java.lang.ref</A>
</FONT></TD></TR>
^^^^^^^^^^^^^^^^^
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><B><A HREF="../../../java/lang/ref/class-use/Reference.html#java.lang.ref"><B>Reference</B></A></B>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Abstract base class for reference objects.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><B><A HREF="../../../java/lang/ref/class-use/ReferenceQueue.html#java.lang.ref"><B>ReferenceQueue</B></A></B>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Reference queues, to which registered reference objects are appended by the
 garbage collector after the appropriate reachability changes are detected.</TD>
</TR>
</TABLE>
------ END -------

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: mantis FIXED IN: mantis INTEGRATED IN: mantis mantis-b05
2004-06-14

PUBLIC COMMENTS Fixed by moving tableHeaderEnd() earlier in generateClassList() in PackageUserWriter.java Regression test at: <ws>/test/com/sun/javadoc/ValidHtml/ValidHtml.java ###@###.### 2002-09-25
2002-09-25

EVALUATION Important to generate valid HTML ###@###.### 2002-08-30
2002-08-30