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

Question

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

我之前已经看过其他问题了(也就是说,你怎么能逃脱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++这样的东西.我在这里做错了吗？我正在使用带有Java 1.8.0_05 x64的NetBeans 8.0(Build 201403101706).

Answer 1

一种方法是使用:

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

而不是一个{@code ...}块.请参阅第86行的示例.

Answer 2

这是一个已知的错误。对应bug的链接是：

https://bugs.openjdk.java.net/browse/JDK-8130754

截至 2016 年 10 月 7 日，尚无计划修复的版本。