删除注释“由 Javadoc 在<日期>生成”<时间>”在生成的 Javadoc 中时间>日期>
插入一条注释,内容如下:
<!-- Generated by javadoc (build 1.6.0_17) on Thu Apr 07 18:32:31 CEST 2011 -->
javadoc 命令会自动在每个生成的 HTML 文件中
这完全阻止了版本化 javadoc 的更改跟踪,因为在重新生成文档时每个文件都会被修改。
我问的上一个问题说服我不要对任何 javadoc 进行版本控制,但它也提出了这个问题,问题仍然存在:有没有办法摆脱这个评论?我在 javadoc 选项中没有找到这种可能性的踪迹。
A javadoc command automatically inserts a comment stating something like:
<!-- Generated by javadoc (build 1.6.0_17) on Thu Apr 07 18:32:31 CEST 2011 -->
in every generated HTML file.
This is quite preventing change tracking for versioned javadoc, since every file will be modified when regenerating the doc.
A previous question I asked convince me not to version any javadoc, but it also raised this problem and the question remains: is there a way to get rid of this comment? I did not find trace of such possibility in the javadoc options.
如果你对这篇内容有疑问,欢迎到本站社区发帖提问 参与讨论,获取更多帮助,或者扫码二维码加入 Web 技术交流群。
绑定邮箱获取回复消息
由于您还没有绑定你的真实邮箱,如果其他用户或者作者回复了您的评论,将不能在第一时间通知您!
发布评论
评论(1)
感谢JackMc的评论,我找到了命令行参数
-notimestamp
。它有效(至少对于我的 1.6.0_20 这里)。如果使用 ant,您必须使用
嵌套元素将其添加到
任务中,或者additionalparam="-notimestamp"
属性。(我只是将其用于我的github管理的JSch 文档。。)
Thank to JackMc's comment, I found the command line parameter
-notimestamp
. It works (at least for my 1.6.0_20 here).If using ant, you'll have to add it to the
<javadoc>
task using either the<arg value="-notimestamp" />
nested element or anadditionalparam="-notimestamp"
attribute.(I just used this for my github-managed JSch documentation..)