Añadir nueva JavaDoc a existente desde el supermétodo

Question

He generado una interfaz que está muy bien documentada. Cada método tiene su propio JavaDoc. Las clases que implementan esta interfaz pueden tener pequeñas diferencias en su lógica.

¿Cómo puedo agregar JavaDoc al JavaDoc existente de la superclase? La palabra clave

/** 
* {@inheritDoc} 
*/ 

solo establece el javaDoc de la superclase en el método actual. Pero cuando intento añadir algunas palabras, el JavaDoc del método súper se ha ido, como

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

¿Alguien tiene una idea de cómo puedo actualizar el JavaDoc de un método estupendo, sin borrar.

EDIT:

En cuanto a la respuesta Brian Agnew, lo cual es bueno, pero no una respuesta real;)

También puede tener el mismo problema cuando se desea sobrescribir un método existente, como la pintura() en Swing, y desea describir cómo inicializar o manejar el comportamiento del sorteo desde el exterior. Esto no es solo para la descripción de la interfaz.

Answer 1

Supongo que cuando necesitas agregar algo a javadoc, cambiaste algo. Así que tal vez sea correcto escribir javadoc exactamente de la misma manera.

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

Answer 2

No conozco ningún modismo JavaDoc directo que lo haga. Sin embargo, Eclipse e IntelliJ le permitirán tomar el super JDoc e insertarlo ... está lejos de ser perfecto, como si cambiara el supr JDoc, tendrá que volver a editar todas las anulaciones, pero es mejor que copiar y pegar a mano ...