javadoc 中的 -nodeprecated 选项似乎不起作用。我能做些什么？

Question

我的类中有一个已弃用的方法：

@Deprecated
public void deprecatedMethod() {
   //do bad things
}

我不希望该方法出现在 javadoc 中。 我知道有一个名为 -nodeprecated

“防止生成任何 完全不推荐使用 API 文档。”

我使用这个选项，它不会从 javadoc 中排除该方法。这是 javadoc 中的错误还是我使用错误？我还能做什么？

（我正在使用 eclipse 3.4.2生成 javadoc）

Answer 1

您必须在导出到 javadoc 向导中包含“-nodeprecated”选项。
警告：这是一个 javadoc 选项，而不是 VM 选项。

我已经在 Eclipse 3.4 中测试过它并且有效。

编辑：如果您仅包含“已弃用”注释，则该注释不起作用。您还必须在方法 javadoc 中包含 @deprecated 标记。

我不知道是否有办法告诉 javadoc 使用 @Deprecated 注释（奇怪的是它没有消息参数来记录为什么被弃用以及还可以使用什么）。

编辑： before-1.5 弃用方法的方式

您必须在 javadoc 中“已弃用”之后包含一个 @deprecated 标记（或指示符或其他内容）以及要在 javadoc 中向用户显示的消息”。

/**
  This method sets the property A.
  @see getA
  @author helios
  @deprecated This method is not sync safe, use setAOk instead
 */
public void setA(String value) ...

Answer 2

@helios

john 说您必须在 javadoc 注释块 (/** ... */) 中包含 @deprecated javadoc 标记，就像他在上面所做的那样：

@deprecated This method is not sync safe, use setAOk instead

添加此内容，然后在运行 javadoc 时使用 -nodeprecated 选项，并且方法不会出现在生成的文档中。