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: 4664607
Votes 1
Synopsis stddoclet: COLSPAN=3 creates an extra column in the first row of the navbar
Category doclet:tbd
Reported Against 1.4
Release Fixed 1.5(tiger-b32)
State 10-Fix Delivered, bug
Priority: 4-Low
Related Bugs
Submit Date 08-APR-2002
Description




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) 
======================================================================
Work Around
N/A
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

    stddoclet: COLSPAN creates an extra column in the first row of the navbar

 xxxxx@xxxxx  2002-04-12

Fixed.  The extra column has been removed.
 xxxxx@xxxxx  2003-12-08
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang