annotate¶

简介¶

打印指定文件所有修改信息。

vb annotate|blame|praise [OPTIONS] PATH

示例¶

打印 annotate_example 文件的所有版本的逐行分析：

$ vb annotate -l annotate_example.txt
version   1: 2024-07-25 502fd34edb file c3c6669f91
version   2: 2024-07-25 404d5068c0 file f6caa37f50
version   3: 2024-07-25 ed0efeadb2 file e9701e0d71
---------------------------------------------------
ed0efeadb2 2024-07-25     1: this is test
404d5068c0 2024-07-25     2: "添加内容更改文件示例"
502fd34edb 2024-07-25     3: "更改最后一个版本"

打印 annotate_example 文件的所有版本的逐行分析并显示签入用户：

$ vb blame -l annotate_example.txt
version   1: 2024-07-25 502fd34edb file c3c6669f91
version   2: 2024-07-25 404d5068c0 file f6caa37f50
version   3: 2024-07-25 ed0efeadb2 file e9701e0d71
---------------------------------------------------
ed0efeadb2 2024-07-25        zdsyao: this is test
404d5068c0 2024-07-25        zdsyao: "添加内容更改文件示例"
502fd34edb 2024-07-25        zdsyao: "更改最后一个版本"

说明¶

该命令打印出指定文件信息，提交的每个版本信息，显示文件的逐行注释，指出每行的最后修改者及修改时间，可用于详细跟踪更改。

如果一个文件有多个版本，可以用 -r 来指定其他版本。

annotate命令显示行号并省略用户名，而 blame 和 praise 命令显示每次签入的用户。

备注

反向注释：通常，这些命令会查看文件的版本，时间追溯到最早的版本，因此输出会显示每行的最新更改。可以使用 -o|--origin 参数指定最后的更改。在过去的版本中用 -o trunk 会显示文件签入后更改或删除的时间。

该命令通常是遇到错误或问题时使用，可以追踪哪些特定行被更改了以及由谁更改了，从而帮助识别问题的根源。

选项¶

`--filevers`	显示文件版本号而不是签入版本
`-r\|--revision VERSION`	包含该文件的特定签入
`-l\|--log`	列出所有的版本
`-n\|--limit N/Xs/none`	最多N个版本/在X秒内尽可能多/没有限制
`-o\|--origin VERSION`	原始签入。文件的原始版本
`-w\|--ignore-all-space`	比较行时忽略空格
`-Z\|--ignore-trailing-space`	忽略行末的空格

参见

info, finfo, timeline