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

Unable to generate javadoc in Eclipse for linked source files

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

这显示了我的项目是如何设置的:

我可以运行这个程序。

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

我selectProject > 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?

当您执行 Project > Generate Javadoc... 时,它通常会启动 JDK 的外部程序 javadoc 部分。 javadoc 程序没有 understand/know 关于 Eclipse link 编辑的资源,因此它看到的是空文件夹。

How do I set up links to source files so I can generate javadoc?

简而言之,您不能在文件级别使用 links。

使用指向 src 文件夹的链接

与其对包中的文件执行 link,不如对包含的源文件夹执行 link。在您的屏幕截图中,您没有 src 文件夹,但您可以创建一个 linked 文件夹。

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

在 Eclipse 中使用 Javadoc 视图

(即根本不生成 Javadoc,可能对您的情况没有用,但为了完整性而包括在内。)

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