我在使用@see 标签的javadoc 时遇到以下问题:我不能超过80 个字符,但链接本身比这长。我怎样才能打破它以遵守该限制?例如,如果我想使用 @see 标记将 javadoc 阅读器引用到 Java 命名约定,我怎样才能在不影响 javadoc 的情况下将其分成两行?链接是:
http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-135099.html#367
谢谢!
以下 Javadoc 对我来说没有任何问题:
/**
* Some content.
*
* @see <a href="http://www.oracle.com/technetwork/java/javase/documentation/codeconventions-135099.html#367">Java Naming Conventions</a>
*/
然后它生成了一个适当的See Also:
部分,链接正确显示:
您可以使用URL 缩短器。例如,您可以使用https://goo.gl/
(来自 Google)生成一个短 URL 以将其放入JavaDoc中。