有没有办法指定类文件的最后修改日期?我希望每个 javadoc 页面都包含类文件的最后修改时间戳,最好在页脚中。
我以为我前段时间做过类似的事情,但是在网上找不到任何示例,并且页脚的文档只是表明它可以包含 html。那么在生成 javadoc 时是否可以不设置任何类型的占位符?
谢谢。
有没有办法指定类文件的最后修改日期?我希望每个 javadoc 页面都包含类文件的最后修改时间戳,最好在页脚中。
我以为我前段时间做过类似的事情,但是在网上找不到任何示例,并且页脚的文档只是表明它可以包含 html。那么在生成 javadoc 时是否可以不设置任何类型的占位符?
谢谢。
一些源代码控制系统允许您编写在提交文件时更新的标记。如果你把它放在 javadoc 中,javadoc 会告诉你修订号和上次提交的时间。
我认为将时间戳写入代码是编辑器的工作。这就是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。
我不认为这个功能在 javadoc 中可用。您为什么不依靠源代码管理来为您完成这项工作?如果是 SVN,您可以定义在提交时自动填充的关键字(请参阅svn propset)。这要好得多,您无需担心 javadoc 处理。
如果更简单的方法可以满足,您可以在底部选项中添加一个脚本,例如:
-bottom "<font size=\"-1\">Created by `echo $USER`, at `date +%Y-%m-%d\ %H:%M:%S.%N`.</font>"