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: 4366537
Votes 0
Synopsis stddoclet: Javadoc inherits @throws comments when it shouldn't
Category doclet:tbd
Reported Against 1.3
Release Fixed
State 11-Closed, duplicate of 4317583, request for enhancement
Priority: 5-Very Low
Related Bugs 4317583
Submit Date 29-AUG-2000
Description
java version "1.3.0"
Java(TM) 2 Runtime Environment, Standard Edition (build 1.3.0-C)
Java HotSpot(TM) Client VM (build 1.3.0-C, mixed mode)

Javadoc generates documentation that inherits @throws comments from classes and
interfaces even if the documented exceptions aren't thrown in the
extending/implementing class.

public class A {
	/** @throws Exception if we feel like it */
	public void foo() throws Exception {
		throw new Exception();
	}
}

interface I {
	/** @throws Exception from time to time */
	public void bar() throws Exception;
}

public class B extends A implements I {
	public void foo() {
	}
	public void bar() {
	}
}

The documentation for B will include throws comments for foo and bar, even
though B doesn't declare foo and bar to throw any exceptions.
(Review ID: 108967) 
======================================================================
Work Around
N/A
Evaluation
Dupe of 4317583.  I've copied this example there and closed this out as a dupe.
  xxxxx@xxxxx   2000-12-08
Comments
  
  Include a link with my name & email   


PLEASE NOTE: JDK6 is formerly known as Project Mustang