In the following example, the method description is copied down, but the @param and @return are not. This appears to be contrary to the documentation.

package jd;

public class JD {
    /** 
     * description
     *
     * @param o  customer 
     * @return value
     * @throws IOException because
     */
    public boolean foo(Object o) throws java.io.IOException {
	return false;
    }

    public static class Bar extends JD {
	/**
	 * @throws IOException why not
	 */
	public boolean foo(Object o) throws java.io.IOException {
	    return false;
	}
    }
}

N/A

This bug is high on our priority list and will be fixed soon.  We will also follow the recommendation that you gave for bug 4317583: 

"Please consider inheriting @throws for all exceptions that the subclass
does in fact declare, and preferably inheriting @throws for all runtime
exceptions as well."

We agree with this.

  xxxxx@xxxxx   2001-08-24

This bug has been fixed.  Location of fix:

com/sun/tools/doclets/standard/tags/AbstractExecutableMemberTaglet.java
com/sun/tools/doclets/standard/tags/ParamTaglet.java
com/sun/tools/doclets/standard/tags/ReturnTaglet.java
com/sun/tools/doclets/standard/tags/SeeTaglet.java
com/sun/tools/doclets/standard/tags/ThrowsTaglet.java

  xxxxx@xxxxx   2001-09-06