logo标签列表

在生成的Javadoc中删除注释 "Generated by Javadoc on <date> <time>"

htmlversion-controljavadoc
18

一个javadoc命令会自动插入一条注释，类似于：

<!-- Generated by javadoc (build 1.6.0_17) on Thu Apr 07 18:32:31 CEST 2011 -->

在每个生成的HTML文件中。

这会很大程度上防止版本化Javadoc的更改跟踪，因为每个文件都将在重新生成文档时被修改。

我之前提出的一个问题使我相信不要对任何javadoc进行版本控制，但它也引起了这个问题，并且问题仍然存在：是否有一种方法可以摆脱这个注释？ 我没有在javadoc选项中找到这种可能性的痕迹。

2
你看过这个 bug 吗？：http://bugs.sun.com/bugdatabase/view_bug.do?bug_id=5025224 - JackMc
我找不到更多关于这个的信息，而且它也不起作用... - Dunaril
@JackMc：如果你添加一个类似于我的答案，我将删除我的答案并点赞你的答案。这太重要了，不能隐藏在评论中。 - Paŭlo Ebermann
@Paulo，你说得很好。我也同意。虽然你增加了一些精度，但你可以留下你的答案，我也会点赞的；当我有新的投票机会时。不过这个__-notimestamp__对我不起作用，尽管我认为我的JRE是最新的。 - Dunaril
@Dunaril：它是否只是忽略了该选项，仍然添加了注释（这是您问题中显示的注释，不是吗？），还是会出现错误消息？ - Paŭlo Ebermann
你确定 1. 你正在查看刚生成的文档（将文档中的时间戳与当前时间进行比较），2. 你真的在使用该选项执行命令吗？如果之前使用的是 IDE 或 ant 等工具，请尝试从命令行开始。 - Paŭlo Ebermann
1个回答
25

感谢JackMc的评论，我找到了命令行参数-notimestamp。它有效（至少对于我的1.6.0_20版本）。

如果使用ant构建工具，则需要将其添加到<javadoc>任务中，可以使用<arg value="-notimestamp" />嵌套元素或additionalparam="-notimestamp"属性。

（我刚刚在我的Github上管理的JSch文档中使用了这个参数。）

1
非常感谢。在Java 1.7.0_03上对我有效。 - Drew Noakes
网页内容由stack overflow 提供, 点击上面的
可以查看英文原文，
原文链接