JDK-4668035 : stddoclet: Mistakenly documents hidden private method as being overridden
  • Type: Bug
  • Component: tools
  • Sub-Component: javadoc(tool)
  • Affected Version: 1.4.0
  • Priority: P3
  • Status: Closed
  • Resolution: Duplicate
  • OS: other
  • CPU: generic
  • Submitted: 2002-04-15
  • Updated: 2014-05-05
  • Resolved: 2002-04-18
Related Reports
Duplicate :  
Description
Javadoc mistakenly documents private methods that are hidden by
public methods as being overridden.

java.awt.Window.createBufferStrategy(int) is a public method that
is documented on the page below to "override" a private method 
of the same name in java.awt.Component:

http://java.sun.com/j2se/1.4/docs/api/java/awt/Window.html#createBufferStrategy(int)

Of course, a private method cannot be overridden -- it can only be hidden.
This documented override appears as a broken link:

  Overrides:
     <a>createBufferStrategy</a> in class Component

Where <a> represents a broken link to the private method.

Javadoc should not generate this override statement.

Comments
EVALUATION Josh concurs with the solution for Javadoc to not generate the override statement, as it is not an override. ###@###.### 2002-04-14
14-04-2002