JDK-4530727 : 'Throws' heading missing when followed only by auto-generated exceptions
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P3
  • Status: Closed
  • Resolution: Fixed
  • OS: solaris_9,windows_nt
  • CPU: x86,sparc
  • Submitted: 2001-11-22
  • Updated: 2014-05-05
  • Resolved: 2002-10-25
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
1.4.2 mantisFixed
Related Reports
Duplicate :  
Description
When the class defines a method that throws an exception, but not document it with @throws or @exception, Javadoc attempts to create a throws reference. This is an excellent feature.

But it also creates a redundant 'blank' reference below the earlier said one. This should be removed.

Consider the following program
==============================
public class test
{
        public void doNothing () throws myException
        {
        }

}

class myException extends Exception
{
}


Use merlin-rc1, and do
javadoc -private test.java


Observe the result at
test.html#doNothing()

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

PUBLIC COMMENTS This bug has been fixed. The Throws heading is now printed for exceptions that are declared but not documented.
10-06-2004

EVALUATION Confirmed. However, the problem is that the "Throws" heading is missing, so it appears that like the repeated exception is mistaken. The result looks liks this in a browser: public void doNothing() throws p.myException p.myException The HTML looks like this: ------------------ <PRE> public void <B>doNothing</B>() throws p.myException</PRE> <DL> <DD><DL> <DD><CODE>p.myException</CODE></DL> </DD> </DL> The HTML should look like this: ---------------- <PRE> public void <B>doNothing</B>() throws p.myException</PRE> <DL> <DD><DL> <DT><B>Throws:</B> <DD><CODE>p.myException</CODE></DL> </DD> </DL> Changed synopsis from: redundant reference to exception class when method throws without @throws to: "Throws" heading missing when followed only by auto-generated exceptions ###@###.### 2002-04-25 I have fixed this bug. The bug fix is pending review. ###@###.### 2002-07-08
25-04-2002