Question

I have generated an Interface which is very well documented. Every method does have his own JavaDoc. The clases which implement this Interface can have little differents in their logic.

How can i add JavaDoc to the existing JavaDoc from the super class. The key word

/**
 * {@inheritDoc}
 */

only set the javaDoc of the super class to the current method. But when i try to add some words, the JavaDoc of the super method is gone, like

/**
 * {@inheritDoc}
 * These value depends on...
 */

Does anybody have a idea how i can update the JavaDoc of a super method, without deleting.

EDIT:

Regarding to Brian Agnew answer, which is good but not a real answer 😉

You also can have the same problem when you want to overwrite an existing method, like paint() in Swing, and want to describ how to initialize or handle the draw behaviour from outside.
This is not only for interface description.

Answer 1

I guess that when you need to add something to javadoc, you changed something. So maybe it will be correct to write javadoc in exactly same way.

/**
 * Enhanced swing paint for my cool component.
 * @see JButton#paint();
 */
@Override
public void paint() {
    super.paint();
    //my stuff
}