JDK-4664607 : stddoclet: COLSPAN=3 creates an extra column in the first row of the navbar
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P4
  • Status: Resolved
  • Resolution: Fixed
  • OS: windows_2000
  • CPU: x86
  • Submitted: 2002-04-08
  • Updated: 2014-05-05
  • Resolved: 2003-12-19
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
5.0 b32Fixed
Description

Name: nt126004			Date: 04/08/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)

FULL OPERATING SYSTEM VERSION : Microsoft Windows 2000
[Version 5.00.2195]



A DESCRIPTION OF THE PROBLEM :
Javadoc creates bad HTML in the navbar. Thre structure of
that table, as generated on a class documentation page, is
as follows:

<TABLE>
  <TR>
    <TD COLSPAN=3></TD>
    <TD ROWSPAN=3></TD>
  </TR>
  <TR>
    <TD></TD>
    <TD></TD>
  </TR>
  <TR>
    <TD></TD>
    <TD></TD>
  </TR>
</TABLE>

So the first row ends up with 4 columns (three for the
first TD and one for the last TD) while the other two rows
have only 3 each (two for each TD in the row and one for
the last three-row TD on the first row).

Aditionally, on the pages where the navbar has only two
rows, the last TD on the first row still has rowspan=3,
which gives that column an extra row.

STEPS TO FOLLOW TO REPRODUCE THE PROBLEM :
1. Generate javadoc documentation
2. Inspect the Navbar area of the generated files.


EXPECTED VERSUS ACTUAL BEHAVIOR :
The expected table structure is as follows for a class:

<TABLE>
  <TR>
    <TD COLSPAN=2></TD>
    <TD ROWSPAN=3></TD>
  </TR>
  <TR>
    <TD></TD>
    <TD></TD>
  </TR>
  <TR>
    <TD></TD>
    <TD></TD>
  </TR>
</TABLE>

and as follows for other pages:

<TABLE>
  <TR>
    <TD COLSPAN=2></TD>
    <TD ROWSPAN=2></TD>
  </TR>
  <TR>
    <TD></TD>
    <TD></TD>
  </TR>
</TABLE>

The actual results are as described in the description.

This bug can be reproduced always.
(Review ID: 144912) 
======================================================================

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: tiger-beta FIXED IN: tiger-beta INTEGRATED IN: tiger-b32 tiger-beta
2004-06-14

EVALUATION Note that not all HTML pages have the same navbar table structure. Class pages have three rows, while all other pages have two rows. (Index pages, such as index-1.html, have a third row added as a separate table following the nav bar.) Changed synopsis from: Javadoc creates too many columns in the first row of the navbar to: stddoclet: COLSPAN creates an extra column in the first row of the navbar ###@###.### 2002-04-12 Fixed. The extra column has been removed. ###@###.### 2003-12-08
2002-04-12