3

有没有办法指定类文件的最后修改日期?我希望每个 javadoc 页面都包含类文件的最后修改时间戳,最好在页脚中。

我以为我前段时间做过类似的事情,但是在网上找不到任何示例,并且页脚的文档只是表明它可以包含 html。那么在生成 javadoc 时是否可以不设置任何类型的占位符?

谢谢。

4

3 回答 3

1

一些源代码控制系统允许您编写在提交文件时更新的标记。如果你把它放在 javadoc 中,javadoc 会告诉你修订号和上次提交的时间。

于 2011-06-20T22:50:09.833 回答
0

我认为将时间戳写入代码是编辑器的工作。这就是Emacs的做法:

package my.tuple;

/**
 * Implementation of an ordered 2-tuple.
 *
 * @date 2013-07-03
 */

public class Pair<A,B>
{
}

// Local Variables:
// time-stamp-pattern: "0/^ \\* @date %:y-%02m-%02d$"
// End:

之后文档处理器可以读取日期。但是标准的 javadoc 不知道日期。为此,您需要 Eclipse 或 Doxygen。

于 2013-07-03T13:46:21.470 回答
0

我不认为这个功能在 javadoc 中可用。您为什么不依靠源代码管理来为您完成这项工作?如果是 SVN,您可以定义在提交时自动填充的关键字(请参阅svn propset)。这要好得多,您无需担心 javadoc 处理。

如果更简单的方法可以满足,您可以在底部选项中添加一个脚本,例如:

-bottom "<font size=\"-1\">Created by `echo $USER`, at `date +%Y-%m-%d\ %H:%M:%S.%N`.</font>"
于 2011-11-29T05:02:27.713 回答