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