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: 4074202
Votes 0
Synopsis stddoclet: put exception class link in throws section even if no text
Category doclet:tbd
Reported Against 1.2
Release Fixed 1.4(merlin-beta2)
State 10-Fix Delivered, Verified, request for enhancement
Priority: 5-Very Low
Related Bugs
Submit Date 25-AUG-1997
Description
When an @exception tag has an exception class name but no explanatory text, 
javadoc throws a warning message but doesn't place anything pertaining to 
the exception in the html file.

It would be better if, in addition to issuing a warning, javadoc placed the 
a link to the exception class in the html file, even if the @exception tag 
doesn't have a text explanation.
Work Around
N/A
Evaluation
Probably should place in throws section if exception is thrown but there is
no tag at all.
  xxxxx@xxxxx   1998-07-06

I have verified that the @throws appears in the API output, both for the 1.3.1
javadoc and the one to appear in 1.4.  Therefore this must be a standard doclet
issue.

  xxxxx@xxxxx   2001-02-27

The original request is different from what Robert is asking for above.
This boils down to a request to add an exception class link in the 
throws section in either of two cases:
    (1) there a @throws tag but no text accompanies the tag               
    (2) if an exception is declared but there is no @throws tag
Neal says above that the second case can be done.

  xxxxx@xxxxx   2001-06-29

This bug has been fixed.  Location of fix:

src/share/classes/com/sun/tools/doclets/standard/ConstructorSubWriter.java
src/share/classes/com/sun/tools/doclets/standard/ExecutableMemberSubWriter.java
src/share/classes/com/sun/tools/doclets/standard/MethodSubWriter.java
  xxxxx@xxxxx   2001-07-18
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang