无法在Eclipse中为链接的源文件生成javadoc

Question

我无法使用Eclipse Mars为链接的.java文件生成javadoc。

这显示了我的项目的设置方式：

我可以运行该程序。

源文件位于名为foo的文件夹中，以匹配包声明：

我选择Project > Generate Javadoc...并检查包裹：

我同意所有默认选项。

我在控制台中输出了这个输出：

Loading source files for package foo...
Constructing Javadoc information...
javadoc: warning - No source files for package foo
javadoc: warning - No source files for package foo
javadoc: error - No public or protected classes found to document.
1 error
2 warnings

在源代码中添加javadoc注释没有任何区别。

当我没有链接的源文件时，我可以轻松生成javadoc。

如何设置源文件的链接，以便生成javadoc？

Answer 1

执行Project > Generate Javadoc...时，它通常会启动JDK的外部程序javadoc部分。 javadoc程序不了解/了解Eclipse链接资源，因此它会看到空文件夹。

  

如何设置源文件的链接，以便生成javadoc？

简短的回答是你不能在文件级别使用链接。

使用链接到 src 文件夹

不要链接到包中的文件，而是链接到包含的源文件夹。在屏幕截图中，您没有 src 文件夹，但您可以创建一个链接的文件夹。

例如，我有一个名为demoforso的项目，其中我创建了一个名为src的文件夹，该文件夹链接到D:\tmp\src并将src添加到类路径中。当javadoc在此项目上运行时，它将D:\tmp\src作为源路径传递。

在Eclipse中使用Javadoc视图

（即，根本不生成Javadoc，在您的情况下可能没有用，但为了完整性而包括在内。）

Eclipse中的悬停和Javadoc视图意味着您永远不需要为自己使用生成Javadoc。