简体   繁体   English

Maven Javadoc插件仅修复现有的Javadocs

[英]Maven javadoc plugin fix only existing javadocs

I am trying to fix javadocs for my project (mainly missing @param and @return values), and since there quite a lot of code to fix, I am trying to use javadoc:fix goal: 我正在尝试为我的项目修复javadocs(主要是缺少@param@return值),并且由于要修复的代码很多,因此我尝试使用javadoc:fix目标:

mvn javadoc:fix

Unfortunately, it generates javadocs even for classes that had none to begin with. 不幸的是,即使对于没有开头的类,它也会生成javadocs。 Is it possible to configure this goal to fix only existing javadocs? 是否可以配置此目标以仅修复现有的javadocs?

I can't seem to find anything for this in maven-javadoc-plugin 我似乎在maven-javadoc-plugin中找不到任何东西

Or is there a better option besides this maven plugin? 还是除了这个Maven插件还有更好的选择?

Take a look at the JAutodoc plugin for eclipse. 看看Eclipse的JAutodoc插件。 It has templates and modes that allow you to configure what parts of the javadoc to be updated. 它具有模板和模式,可让您配置要更新的Javadoc的哪些部分。 It is pretty easy to use. 它很容易使用。

JAutodoc is an Eclipse Plugin for automatically adding Javadoc and file headers to your source code. JAutodoc是一个Eclipse插件,用于自动将Javadoc和文件头添加到源代码中。 It optionally generates initial comments from element name by using Velocity templates for Javadoc and file headers. 它可以选择使用Javadoc和文件头的Velocity模板从元素名称生成初始注释。

声明:本站的技术帖子网页,遵循CC BY-SA 4.0协议,如果您需要转载,请注明本站网址或者原文地址。任何问题请咨询:yoyou2525@163.com.

 
粤ICP备18138465号  © 2020-2024 STACKOOM.COM