JDK-4074202 : stddoclet: put exception class link in throws section even if no text
  • Type: Enhancement
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.2.0
  • Priority: P5
  • Status: Closed
  • Resolution: Fixed
  • OS: solaris_2.5.1
  • CPU: sparc
  • Submitted: 1997-08-25
  • Updated: 2014-05-05
  • Resolved: 2001-08-07
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
1.4.0 beta2Fixed
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.

Comments
CONVERTED DATA BugTraq+ Release Management Values COMMIT TO FIX: merlin-beta2 FIXED IN: merlin-beta2 INTEGRATED IN: merlin-beta2 VERIFIED IN: merlin-rc1
2004-06-14

PUBLIC COMMENTS This bug has been fixed. An exception class link is now generated 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 jamie.ho@Eng 2001-07-18
2001-07-18

EVALUATION Probably should place in throws section if exception is thrown but there is no tag at all. robert.field@Eng 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. neal.gafter@Eng 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. doug.kramer@Eng 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 jamie.ho@Eng 2001-07-18
2001-07-18