今天在阅读源码的时候想使用idea 的javadoc生成doc 查看类之间的关系,结果idea 内置的tools下的javadoc 失败,研究了手工生成doc,记录一下。
ps:idea的失败可能是由于module模式导致javadoc_args过大失败。
最终命令:
javadoc -d docs -Xmaxwarns 10 -Xmaxerrs 100 -Xdoclint:none -sourcepath . -private -d D:\temp @d:\temp\javadoc_args
javadoc_args 内容如下
-package
io.trino
-sourcepath
.
-subpackages
io.trino
-encoding
UTF-8
-classpath
classpath可以从运行态,或者Idea javadoc运行生产javadoc_args获取输入后修改。
D:\tools\zulu11.54.25-ca-jdk11.0.14.1-win_x64\bin\javadoc.exe -protected -splitindex -use -author -version -Xmaxwarns 100 -Xmaxerrs 100 -Xdoclint:none -d D:\temp @C:…\Temp\javadoc_args
特别要注意的是
- encoding
- subpackages
否则可能读取java文件失败或者不生产sub packages信息。