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: 4136861
Votes 0
Synopsis Doclet API: static initializers need special handling
Category java:javadoctool
Reported Against 1.2 , 1.3 , 1.1.7 , 1.2beta4
Release Fixed 1.4(merlin-beta)
State 10-Fix Delivered, Verified, bug
Priority: 5-Very Low
Related Bugs 4136244 , 4206856 , 4414790
Submit Date 11-MAY-1998
Description
.Tested in JDK1.2Beta4-E.	

static {...} in source code tmp.java will cause "Methods inherited .." table starts with "," in tmp.html(tmp.java in attached):

 slappy 158 =>javadoc -package tmp.java
Loading source file tmp.java...
Constructing Javadoc information...
Building tree for all the packages and classes...
Building index for all the packages and classes...
Generating tree.html...
Generating index-all.html...
Generating deprecatedlist.html...
Building index for all classes...
Generating allclasses-frame.html...
Generating index.html...
Generating tmp.html...
Generating serializedform.html...
Generating help.html...
Generating stylesheet.css...
 slappy 159 =>

 xxxxx@xxxxx  1998-05-11
Another problem with javadoc's handling of static {...} in source code: it is indexed under character "<" in file index-all.html.
Work Around
N/A
Evaluation
This is quite a visible bug.  Changed from priority 5 to 4.
 xxxxx@xxxxx  1998-05-18

This bug occurs only with -package option, so it's a lower-priority 4 bug.
 xxxxx@xxxxx  1998-07-09

The correct way to handle initializers would be for them to have unique
initializer access, e.g. in ClassDoc:  
	InitializerDoc[] initializers();

This will need to wait for the next major release.  In the mean time,
the effect on output is minor and only occurs when using the "-package"
flag -- a rare thing.
 xxxxx@xxxxx  1998-09-16

It turns out this bug was introduced in the standard doclet while trying to
work around an xxxxx  bug in the javadoc tool. The underlying bug is that
javadoc considers

	static {}

to be a method. It isn't a method and shouldn't result in a method entry
in the javadoc API.

 xxxxx@xxxxx  2001-02-26
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang