我已经生成了一个非常好的文档接口.每个方法都有自己的JavaDoc.实现此接口的条款在其逻辑上几乎没有区别.
如何从超类中将JavaDoc添加到现有JavaDoc中.关键词
/** * {@inheritDoc} */
只将超类的javaDoc设置为当前方法.但是当我尝试添加一些单词时,超级方法的JavaDoc就不见了
/** * {@inheritDoc} * These value depends on... */
有没有人知道我如何更新超级方法的JavaDoc,而不删除.
编辑:
关于Brian Agnew的答案,这很好但不是真正的答案;)
如果要覆盖现有方法(如Swing中的paint()),并且想要描述如何从外部初始化或处理绘制行为,则也会遇到同样的问题.这不仅适用于界面描述.
我想当你需要为javadoc添加一些东西时,你改变了一些东西.因此,以完全相同的方式编写javadoc也许是正确的.
/** * Enhanced swing paint for my cool component. * @see JButton#paint(); */ @Override public void paint() { super.paint(); //my stuff }