即使在编译器选项中禁用javadoc之后Eclipse也抱怨Javadoc，并且不一致

Question

我使用Eclipse抱怨的{@Code注释获得了一些开源代码。因为我不在乎我在编译器选项中关闭了Javadoc，但它仍然抱怨并且不会编译编译。

错误是：“Javadoc：缺少内联标记的右括号”

实际上闭合支具存在。在某些情况下，只有几行，但在其他情况下，它甚至在同一条线上！

更奇怪的是：不同工作区中较小项目中的相同代码可以正常工作。我已经比较了两个项目的设置几次，它们看起来是一样的。在许多情况下，选项设置为不允许项目特定设置。

我还做了其他一些事情，比如干净项目，尝试Java 1.5 vs. 1.7编译器选项等等。

其他细节：

• Mac上的Java 7
• Eclipse Kepler
• 代码是Guice 2.0（我知道它很旧，通常应该使用jar，长篇故事）
• 一个例子是Key.java第107行，见下文

Guice代码示例（虽然我通常不会关心，因为它只是评论）

  /**
    ...
   * <p>{@code new Key<Foo>() {}}.

Answer 1

@code tag有一些警告（请参阅：Multiple line code example in Javadoc comment）...其中一个是您需要避免在同一行中混合使用标记括号和实际内容括号。

考虑到这一点，我会将Javadoc重写为：

 <p><pre><code>new Key{@literal<Foo>}(){}</code><pre>.</p>

您还可以使用@code来阻止<Foo>被解释为HTML标记。

我正在使用@literal，因为内容已经包含<code>标记。 <pre>标记用于保留空格和换行符。

---

关于Javadoc配置，如果你想清扫地毯下的污垢，请转到：

Windows -> Preferences -> Java -> Compiler -> Javadoc

并将Malformed Javadoc comments设置为忽略。申请，重建，你应该准备好了 （还要确保Project -> Properties-> Java Compiler -> Javadoc下的特定项目设置不会弄乱设置）。