历史记录
描述
显示文件或目录的历史记录。
用法
cm history | hist <item_path>[ ...] [--long | --format=<str_format>] [--symlink] [--xml[=<output_file>]] [--encoding=<name>] [--moveddeleted]
选项
| 选项 / 参数 | 描述 |
|---|---|
| --long | 显示更多信息。 |
| --format | 以特定格式检索输出消息。有关更多信息，请参见备注。此选项不可与 '--xml' 结合使用。 |
| --symlink | 将历史操作应用于符号链接，而不是目标。 |
| --xml | 以 XML 格式将输出打印到标准输出。可以指定一个输出文件。此选项不可与 '--format' 结合使用。 |
| --encoding | 与 '--xml' 选项一起使用，指定 XML 输出中使用的编码，例如：utf-8。有关支持的编码及其格式的表，请参见 MSDN 文档 http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx（在页面末尾的“名称”列中）。 |
| --moveddeleted | 在历史记录中包含移动和删除操作。 |
| --limit | 显示指定项目的 N 个最新修订版，按日期和变更集 ID 排序。如果提供负数，则将返回一个空列表。如果提供大于修订版数量的数字，则将返回关于该项目的可用所有修订版。 |
| item_path | 项目的路径。使用空格分隔路径。使用双引号 (“ ”) 指定包含空格的路径。路径也可以是服务器路径修订版。（使用 'cm help objectspec' 了解有关规范的更多信息。） |
帮助
备注
此命令显示给定项目的修订版列表，以及每个修订版的标签、分支和注释信息。
输出格式参数（--format 选项）
此命令接受一个格式字符串以显示输出。此命令的输出参数如下所示
| 选项 / 参数 | 描述 |
|---|---|
| {0} | {date} | 日期。 |
| {1} | {changesetid} | 变更集编号。 |
| {2} | {branch} | 分支。 |
| {4} | {comment} | 注释。 |
| {5} | {owner} | 所有者。 |
| {6} | {id} | 修订版 ID。 |
| {7} | {repository} | 存储库。 |
| {8} | {server} | 服务器。 |
| {9} | {repspec} | 存储库规范。 |
| {10} | {datastatus} | 修订版数据的可用性。 |
| {11} | {path} | 作为 <item_path> 传递的路径或规范。 |
| {12} | {itemid} | 项目 ID。 |
| {13} | {size} | 大小。 |
| {14} | {hash} | 哈希码。 |
| {tab} | 插入一个制表符空格。 |
| {newline} | 插入一个新行。 |
示例
cm history file1.txt "file 2.txt"
cm hist c:\workspace --long
(显示所有信息。)
cm history link --symlink
(将历史操作应用于符号链接文件，而不是目标。)
cm history serverpath:/src/foo/bar.c#br:/main/task001@myserver
(从给定分支中的服务器路径检索修订版历史记录。)
cm history bar.c, foo.c --long --limit=2
(检索 bar.c 和 foo.c 项目的 2 个最新修订版。)