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 Availability 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
14-06-2004

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
12-04-2002