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: 4415270
Votes 0
Synopsis stddoclet: HTML table tags inserted in wrong place in package use page (invalid)
Category doclet:tbd
Reported Against 1.3
Release Fixed 1.4.2(mantis)
State 10-Fix Delivered, bug
Priority: 4-Low
Related Bugs
Submit Date 14-FEB-2001
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 -------
Work Around
N/A
Evaluation
Important to generate valid HTML
  xxxxx@xxxxx   2002-08-30
Comments
  
  Include a link with my name & email   

Submitted On 04-SEP-2003
pasztika
If I insert the following part into my doclet comment:

  * <table>
  *   <tr>
  *     <td>31</td>
  *     <td>40786</td>
  *     <td>ADSL Otthon</td>
  *     <td align="right">89850</td>
  *   </tr>

in the generated html I get:

     31
     40786
     ADSL Otthon
     <td align="right">89850

Is this a normal behaviour?
I used jdk 1.4.2_01 on Win NT.


Submitted On 05-SEP-2003
dkramer
No, that doesn't look like the right behavior.
It should copy your code to the generated page without
stripping out any HTML tags.  Please submit this as a bug as
described at:
http://java.sun.com/j2se/javadoc/faq/index.html#submitbugs

In the future, questions like this should be submitted to
the javadoc forum at:
http://forum.java.sun.com/forum.jsp?forum=41

-Doug Kramer
Javadoc team



PLEASE NOTE: JDK6 is formerly known as Project Mustang