如何为多个模块生成javadoc

Question

文件/目录结构为：

workspace
    doc
    maths
        src
            main
                java
                    net.virtualpsyclab.maths
                        net
                            virtualpsyclab
                                maths
                                    lib
                                        *.java
                    module-info.java
    genutils
        src
            main
                java
                    net.virtualpsyclab.genutilsm
                        net
                            virtualpsyclab
                                genutilsm
                                    *.java
                    module-info.java
module-info.java
jdocOptions.txt
files.lst

jdocoptions.txt包含：

-d doc
--module-source-path .;genutils\src\main\java\net.virtualpsyclab.genutilsm;maths\src\main\java\net.virtualpsyclab.maths
--module workspace,net.virtualpsyclab.genutilsm,net.virtualpsyclab.maths
-verbose
-overview overview.html

lst列出了所有*.java文件。

workspace\module-info.java
module workspace{
    requires net.virtualpsyclab.genutilsm;
    requires net.virtualpsyclab.maths;
}

workspace\genutils\src\main\java\net.virtualpsyclab.genutilsm\module-info.java
module net.virtualpsyclab.genutilsm{
    exports net.virtualpsyclab.genutilsm;
}

workspace\maths\src\main\java\net.virtualpsyclab.maths\module-info.java
module net.virtualpsyclab.maths{
    exports net.virtualpsyclab.maths.lib;
}

javadoc @jdocOptions.txt @files.lst 

Loading source file c:\Users\Admin\workspace\maths\src\main\java\net.virtualpsyclab.maths\net\virtualpsyclab\maths\lib\NDieDistribution.java...
[parsing started SimpleFileObject[C:\Users\Admin\workspace\maths\src\main\java\net.virtualpsyclab.maths\net\virtualpsyclab\maths\lib\NDieDistribution.java]]
[parsing completed 0ms]

但是，这一切都以“javadoc：错误-模块工作区没有找到”而糟糕地结束。

对我在这里有什么错误的任何帮助都非常感谢。

Answer 1

基于这个问题中的信息，我现在已经找到了如何做到这一点。这些链接解释了各种java工具的多模块操作模式。多模块模式通过包含选项--module-source-path触发。module-source-path的元素是包含模块定义的目录。模块定义可以是对应于模块名并包含module-info.java的目录，以及对应于包和源文件的目录结构。因此，我放弃了聚合器模块的想法（从我的工作区目录中删除module-info.java，见上图），并将jdocoptions.txt文件改为如下：

-d doc
--module-source-path genutils\src\main\java\;maths\src\main\java\

关键的变化是删除在单模块模式中用于标识根模块的--module选项，并缩短--module-source-path选项中的路径，以便模块目录（例如net.virtualpsyclab.maths）是路径的子目录，而不是路径的一部分。

现在我在workspace/doc中有了两个模块所需的文档！