java - 尝试使用 Netbeans 8.0 在 javadoc 注释中的 {@code} block 中转义 "@"符号

Question

我正在尝试使用 Netbeans 8.0 在 Javadoc 注释中插入一个 {@code } 注释，但它无法正常工作。

我之前看到过关于此的其他问题(即 How can you escape the @ character in javadoc? )但是 html 转义 @ 和 {@literal @} 都没有' 似乎有效。

我的评论看起来像这样(为了示例使用这两种方法):

/**
 * blah blah blah
 * <p>
 * For example:
 * <pre>
 * {@code
 * {@literal @}begin_specification
 *  ...
 * &#64;end_specification
 * }
 * </pre>
 */

我可以点击 Run -> Generate Javadoc 一切正常，没有错误，但是当我在浏览器中查看结果输出时，我看到了这一点:

{@literal @}begin_specification
 ...
@end_specification

哪个不是预期的结果...有什么建议/想法吗？

我是 Java 的新手，但过去曾在 C/C++ 中使用过诸如 Doxygen 之类的东西。我在这里做错了什么吗？我正在使用 NetBeans 8.0(内部版本 201403101706)和 Java 1.8.0_05 x64。

Answer 1

一种方法是使用:

<pre> <code>
   {@literal @}
</code> </pre>

而不是 {@code ...} block 。参见 this example在第 86 行附近。