-link对于模块而言,java 10中javadoc命令的选项不能始终如一地工作.
具体来说,它不适用于依赖模块名称与其导出的包的名称相同的情况
我运行以下命令
/opt/jdk-10.0.1/bin/javadoc -html5
-subpackages uk.co.sr.vcher.service \
--source-path src/service \
--module-path lib:app -d javadoc/service \
-link ../auth -link ../db -link ../models \
-link ../core -link ../render \
-link https://docs.oracle.com/javase/10/docs/api \
-linksource src/service/uk/co/sr/vcher/service/Service.java \
src/service/uk/co/sr/vcher/service/ServiceImpl.java \
src/service/module-info.java
Run Code Online (Sandbox Code Playgroud)
所以这是生成Javadoc两类封装uk.co.sr.vcher.service,其是在src /服务,和连接该文档到其它5个模块在我的申请,再加上JDK文档
我构建的模块jar是在app /中,外部依赖是在lib /
Javadoc成功并生成HTML.但是我的应用程序的某些(并非所有)其他模块中的类的链接被破坏,缺少包的路径目录.
我在下面显示的是一个HTML输出的一个构造函数uk.co.sr.vcher.service.ServiceImpl.它需要四个参数:a File,a ConnectionSource,a Coder和anApplicationConfig
ServiceImpl为了便于阅读,我已经取出附加的链接,并添加了一些空格.这是我关注的四种参数类型的链接.
的File是java.io.File,正确地链接到docs.oracle.com
的ConnectionSource是uk.co.sr.vcher.db.ConnectionSource,虽然该提示正确显示封装,链接去的Javadoc正确的模块uk.co.sr.db,链接是错误的,因为它不包括包的路径
的Coder是uk.co.sr.vcher.Coder从模块uk.co.sr.vcher.core.在这种情况下,链接是正确的core/uk/co/sr/vcher/Coder.html
的 …