java - JavaDoc：减少同一类中重复方法描述的冗余

Question

例如，我有两个方法，public Tree<T> addChild(final T data) {}并且public Tree<T> addChild(final T... data) {}它们的 JavaDocs 是相同的。如何将其中一个放入/** method description */其中，并使用标签将另一个 JavaDoc 引用到前一个 JavaDoc？

就像，在概念上：

/**
 * method description
 */
public Tree<T> addChild(final T data) { ... }

/**
 * @theTag #addChild(Object)
 */
public Tree<T> addChild(final T... data) { ... }

如果我没记错的话，我曾经偶然遇到过一个标签，它导入了 Java 原生 API 方法的整个方法描述。所以，应该是可以的。

是什么@theTag？非常感谢！

Answer 1

@see 标签怎么样？它不是完全导入，而是放置参考：

/**
 * action 1 description
 */
public void action1(){}

/**
 * @see MyClass#action1
 */
public void action2(){}