history—显示文件和用户的状态

• 语法: history [-report] [-flags] [-options args] [files...]
• 需要: $CVSROOT/CVSROOT/history 文件
• 修改: 无。

cvs 用一个历史日志文件来跟踪大多数的 cvs 命令的使用。你可以用 history 以各种格式显示此信息。

要打开日志功能，`LogHistory' 配置选项必须设置为非空，而且 `HistoryLogPath' 选项指定的历史文件，必须能被 cvs 指向的所有用户写入(参阅 config)。

要使用 history 命令，日志功能必须如上打开，`HistorySearchPath' 配置选项必须指定一些历史日志的数字，这些文件要能被任何运行 history 命令的用户读取。

通过 cvs init 命令创建的仓库，将打开所有可能的日志事件到一个单一的历史日志文件 ($CVSROOT/CVSROOT/history)，它能被所有的用户读写(参阅 Creating a repository)。

注意: history 使用的 `', `', `' 和 `' 的方式与普通 -f-l-n-pcvs 的方式冲突 (参阅 Common options)。

 

 

history options

有一些选项可以控制报告的生成(如 `-report' 显示):

-c

报告每次提交(即，仓库的每次修改)。

-e

任何事情(所有的记录类型)。等同于给所有的记录类型指定 ` -x'。当然，` -e' 还包括以后 cvsCVS 将要包含的类型; 如果你要在脚本里面只处理特定的记录类型，需要使用 ` -x'`-x' 来指定。

-m module

报告特定的模块。(可以在命令行上多次使用使用 ` -m'。)

-o

报告检出的模块。此为默认的报告类型。

-T

报告所有的标签。

-x type

从 cvs 历史中取出特定 type 类型的记录。类型用单独的字母表示，你也可以组合起来指定。

一些命令有一个单独的记录类型:

F

release

O

checkout

E

export

T

rtag

update 产生的记录类型:

C

合并后有冲突发生(需要手动合并)。

G

合并成功。

U

从仓库复制了工作文件。

P

为工作文件打补丁，与仓库中相配。

W

更新期间删除了工作副本(因为在仓库里面已经删除)。

commit 产生的三种记录类型:

A

首次增加文件。

M

修改了文件。

R

删除了文件。

显示为 `-flags' 方式的选项强迫或展开报告而不需要参数:

-a

显示所有用户的数据(默认只显示执行 history 的用户数据)。

-l

只显示最后的修改。

-w

只显示 history 所执行目录的最后修改。

显示为 `-options args' 的选项强迫报告基于一个参数:

-b str

显示在模块名，文件名，或记录路径中包含字符串 str 的记录。

-D date

显示自从 date 开始的数据。这与 ` -D date' 有一些不同，那是选择 date 日期之前的最新修订版。

-f file

显示指定文件的数据(你可以在同一命令行上指定多个 ` -f' 选项)。这与在命令行上指定文件相同。

-n module

显示指定模块的数据(你可以在同一命令行上指定多个 ` -n' 选项)。

-p repository

显示指定源码仓库的数据(你可以在同一命令行上指定多个 ` -p' 选项)。

-r rev

显示名为 rev 的单独 rcs 文件修订版或标签名的记录。每个 rcs 文件都被搜索。

-t tag

显示最后添加到历史文件的 tag 标签。与上面 ` -r' 标识不同的是仅从历史文件读取，而不是 rcs 文件，所以更快。

-u name

显示用户 name 的记录。

-z timezone

使用指定的时区而非 UTC 显示所选记录的时间。