跨所有文件更新Javadoc版本和作者?
我需要在我的项目中保持所有类Javadoc的@version
标记以及@author
标记。 但是我不知道这么做的简单方法。
是否有可以实现此目的的插件(最好是maven插件)? 不,maven-release插件不会为我做这个。
我使用@version
的方式与@since
一起使用。 恕我直言,我认为@version
代表修改 @since
时的软件版本,而@since
代表创建此文件/类时的软件版本。
在@author
,我的策略是每个为该课程做出贡献的开发人员(以某种主要方式)都应该附加他/她的名字。
因此,如果您看到所有这些过程都是手动的,则需要在编码时由类创建者/修饰符完成。 而且,显然你会有不同版本的文件。 而且,我认为这是有道理的。
如果有人不同,我想听听。
当然,有一种maven方式可以做到这一点,但这很不寻常:
使用固定的outputDirectory将src / main / java文件夹定义为
。 然后重新配置javadoc和jar插件,如下所示:
src/main/java sources true org.apache.maven.plugins maven-javadoc-plugin 2.6.1 ${project.build.outputDirectory}/sources org.apache.maven.plugins maven-jar-plugin 2.3 sources/**
现在,您可以在源文件中使用占位符并使用maven属性进行插值(请参阅maven过滤以供参考)