During a build of the coredocs target in the j2se workspace, over 3000 warning messages of the form
"Parameter "foo" is documented more than once."
are generated. In the spot checks I've done *all* the messages are erroneous.
For example, in the message
/src/share/classes/java/lang/Comparable.java:117: warning - Parameter "o" is documented more than once.
the Comparable interface defines one method with one parameter and has one (correctly named) @param tag in the JavaDoc; there is nothing wrong.
In the Throwable class, warnings are issued for both
public void printStackTrace(PrintStream s)
public void printStackTrace(PrintWriter s)
The JavaDoc for both of these methods has a single properly named @param tag.
Erroneous warnings should not be issued.