从super方法将新JavaDoc附加到现有JavaDoc

Question

我已经生成了一个非常好的文档接口.每个方法都有自己的JavaDoc.实现此接口的条款在其逻辑上几乎没有区别.

如何从超类中将JavaDoc添加到现有JavaDoc中.关键词

/**
 * {@inheritDoc}
 */

只将超类的javaDoc设置为当前方法.但是当我尝试添加一些单词时,超级方法的JavaDoc就不见了

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

有没有人知道我如何更新超级方法的JavaDoc,而不删除.

编辑:

关于Brian Agnew的答案,这很好但不是真正的答案;)

如果要覆盖现有方法(如Swing中的paint()),并且想要描述如何从外部初始化或处理绘制行为,则也会遇到同样的问题.这不仅适用于界面描述.

Answer 1

我想当你需要为javadoc添加一些东西时,你改变了一些东西.因此,以完全相同的方式编写javadoc也许是正确的.

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