查看修订日志
仓库浏览器中的每个路径都包含一个指向修订日志的上下文导航链接。修订日志显示了当前路径或其下方任何其他路径被修改过的最新变更集的列表。
修订日志表单
可以使用“查看日志起始于”字段设置修订日志应从哪个修订版本开始。空值或“最新版本”值被解释为最新变更集。
还可以使用“返回到”字段指定日志应在哪个修订版本停止。默认情况下,该字段为空,这意味着修订日志将显示默认日志限制,即默认显示最近100个修订版本。
修订日志有三种操作模式。
默认情况下,修订日志会“复制时停止”,这意味着每当检测到“添加”、“复制”或“重命名”操作时,将不会显示更旧的修订版本。这在使用分支时非常方便,因为这样只会看到该分支的历史记录。
还可以通过选择“跟踪复制”模式来指示要包含“复制”或“重命名”更改之前发生的内容。这将继续列出跨复制和重命名的所有修订版本。每次路径名称更改时,都会有一个额外的缩进级别。这样,不同路径上的更改可以轻松地在视觉上归类在一起。
甚至可以跳过“添加”更改,以查看在该“添加”之前,该路径上是否发生过“删除”更改。此模式标记为“仅显示添加、移动和删除”。此操作可能相当耗费资源,因此可能需要一些时间才能显示。
最后,有一个复选框“显示完整日志消息”,它控制着是否应为每个更改显示提交日志消息的完整内容,还是仅显示其缩短版本。
修订日志信息
对于每个修订日志条目,会显示以下列:
- 第一列包含一对单选按钮,用于选择将用于查看实际更改的旧修订版本和新修订版本。
- 颜色代码(与用于变更集的颜色代码类似)指示更改的类型。点击此列会刷新修订日志,使其从此更改重新开始。
- 修订版本号,显示为
@xyz
。这是一个指向Trac浏览器的链接,使用显示的修订版本作为基准线。旁边您可以看到一个小小的“轮子”图标,它可以点击并引导到该修订版本的Trac变更集视图。
- 更改发生时的距今时间/日期。根据您的会话偏好设置,日期将以相对或绝对格式显示。
- 相对格式显示距今时间:以小时、天、周、月或年为单位的经过时间。
- 绝对格式显示修订版本的日期,以日期时间表示。
- 更改的作者。
- 日志消息,根据上方表单中“显示完整日志消息”复选框的值,它包含截断或完整的提交日志消息。
检查修订版本之间的更改
“查看更改...”按钮(位于更改列表的上方和下方,左侧)将显示从旧修订版本(第一个单选按钮)到新修订版本(第二个单选按钮)的聚合更改所对应的差异集,并在Trac变更集视图中显示。
请注意,旧修订版本实际上不必比新修订版本更旧:它只是提供了差异比较的基准。因此,完全有可能轻松生成一个反向差异,用于撤销给定修订版本范围内已完成的操作。
最后,如果两个修订版本相同,则会显示相应的变更集。这与点击变更集编号具有相同的效果。
其他格式
变更日志文本
在页面底部,有一个“变更日志”链接,它将显示当前显示的修订版本范围,但以纯文本形式显示,符合变更日志文件的常用约定。
RSS支持
修订日志还提供RSS订阅源以监控更改。要订阅文件或目录的RSS订阅源,请在浏览器中打开其修订日志,然后点击页面底部的橙色“XML”图标。有关Trac中RSS支持的更多信息,请参阅TracRss。