4

我正在使用 Eclipse 3.4 并配置了 Java 代码格式化程序,启用了Comments选项卡上的所有选项。问题是,当我格式化包含以下内容的文档注释时:

* @see <a href="test.html">test</a>

代码格式化程序在结束 HTML 中插入一个空格,打破它:

* @see <a href="test.html">test< /a>

为什么?我该如何阻止这种情况发生?

这不能通过禁用“注释”选项卡上的任何选项来解决,例如“格式化 HTML 标记” 。我发现的唯一解决方法是通过禁用启用 Javadoc 注释格式启用块注释格式选项来完全禁用 Javadoc 格式,这意味着我必须手动格式化注释块。

4

3 回答 3

4

我只能假设这是 Eclipse 中的一个错误。它只发生在@see标记上,它也发生在所有 3 个内置代码格式化程序设置中。

附近已经报告了一些有趣的错误,但我找不到这个特定的错误。例如,请参阅在Eclipse Bugzilla中搜索@see

于 2008-09-05T11:13:21.853 回答
1

严格的 XML 规范要求自结束标记在结束斜杠之前应该有一个空格,如下所示:

<gcServer enabled="true" /> <!-- note the space just after "true" -->

我只能假设,就像 Bart 所说的那样,Eclipse 的重新格式化程序中存在一个错误,它认为结束标记实际上是一个自结束标记。另一个想法:您能否验证您的 a标签是平衡的(即文档中没有未闭合的标签)?

于 2008-09-05T11:27:55.500 回答
1

这可能是 Eclipse 3.4 中的一个错误。我正在使用 3.3 (M20080221-1800),并且没有观察到这种行为。

于 2008-09-16T19:49:16.417 回答