javadoc "@author“没有显示吗？

Question

每当我在intelliJ中输入“打印”并按下CTRL键时，我只能看到“摘要”，看不到“鲍勃”。。。我做错了什么？

package printing;
 /**
 * @author Bob
 * <b>Summary</b>
 */
public class Printer {
//stuff
}

*注意:我只是在学习如何使用"javadoc“，所以我希望能有一个解释。

编辑:我甚至看不到“摘要”，除非我去掉"@author“

Answer 1

听起来像是IntelliJ的一个问题/特性。Eclipse显示了包括@author在内的整个javadoc。其他可能的问题是在@author之后出现了<b>Summary</b>。

所以，试着删除摘要，看看会发生什么。也试着真正生成javadoc，例如，从命令行运行javadoc实用程序，看看会发生什么。我确信在这种情况下Bob会出现。祝好运。

Answer 2

我可以重现这个行为，并提出了一个问题来跟踪它：http://youtrack.jetbrains.com/issue/IDEA-114499

下面是我使用的一小段代码：

package printing;

/**
 * @author Simba
 * @version 1
 * @see java.util.Arrays
 * @since 1
 */
public class Printer {
}

以及由此产生的文档：

​

​

但是，如果您尝试使用以下设置通过Tools -> Generate JavaDoc生成javadoc：

​

​

然后，生成的javadoc确实显示了作者标记：

​

​

从而证明了javadoc本身是健全的，并且是IntelliJ不显示它。

Answer 3

从控制台使用javadoc时，您可以将-author和-version选项添加到调用中，如下所示(-d设置输出目录)：

javadoc src/main/java/com/*.java -d src/docs/javadocs/ -author -version

将使用这些设置显示作者和版本。

如AlexR所述，javadoc帮助(只需键入javadoc)显示以下内容(缩写)：

...
Provided by Standard doclet:
  -d <directory>                   Destination directory for output files
  -use                             Create class and package usage pages
  -version                         Include @version paragraphs
  -author                          Include @author paragraphs
...