在 java 文档注释中,@see 是否与 {@link } 一起使用?
In java doc comments is @see used with {@link } or without?
当我想发表评论时,看看其他方法哪个是正确的?使用 {@link ClassName#methodName}
还是不使用?
/**
* @see ClassName#methodName
*
* @see {@link ClassName#methodName}
*/
在 @see
中,可点击的 link 已经包含在内,使 @link
变得多余。如果您想在其他任何地方制作可点击的 link,则使用 @link
。如果没有,不要。就这么简单。
/**
* Blah blah {@link SomeClass#foo}.
*
* @see SomeClass#bar
* @see {@link SomeClass#baz}
*/
下面两个会一样生成。 SomeClass#foo
也将是可点击的 link。
当我想发表评论时,看看其他方法哪个是正确的?使用 {@link ClassName#methodName}
还是不使用?
/**
* @see ClassName#methodName
*
* @see {@link ClassName#methodName}
*/
在 @see
中,可点击的 link 已经包含在内,使 @link
变得多余。如果您想在其他任何地方制作可点击的 link,则使用 @link
。如果没有,不要。就这么简单。
/**
* Blah blah {@link SomeClass#foo}.
*
* @see SomeClass#bar
* @see {@link SomeClass#baz}
*/
下面两个会一样生成。 SomeClass#foo
也将是可点击的 link。