我想以自动方式验证我的 Kotlin 代码中的 Dokka/Kdoc 文档语法是否正确。
在我的 Java 代码中,我使用maven-compiler-plugin
和/或maven-javadoc-plugin
. 使用不正确的文档:
/**
* @111
*/
我得到:
[ERROR] COMPILATION ERROR :
...
[ERROR] no tag name after @
这有助于我解决问题。
通过我的 Kotlin 代码,我使用dokka-maven-plugin
. 使用不正确的文档:
/**
* @111
* [222
* [333]
* [444](
*/
没有错误或警告,甚至没有调试:
[INFO] --- dokka-maven-plugin:1.5.0:dokka
...
[INFO] Validity check
...
[INFO] Generation completed successfully
有什么方法/工具可以验证 Dokka/Kdoc 文档语法吗?
PS:理想情况下,我不想渲染耗时的 dokka html 文件,只需验证,即目标dokka-maven-plugin:validate
会很棒。
谢谢!