Emacs CVS customization
1. 当然，先用命令行 check out 出源码拷贝
$ cd ~/work
$ cvs -d :pserver:user@host:/path/to/repository co MODULE
2. 从 Emacs 开始
几个命令都可以进入 PCL-CVS 中，例如用 cvs-examine：
M-x cvs-examine RET path/to/MODULE RET
RET 表示回车键；path/to/MODULE，源码复本的目录，cvs-examine 缺省为当前
目录。此时 Emacs 打开名为 *cvs* 的缓冲，就是 PCL-CVS 的主界面。
PCL-CVS 只是命令行 cvs 的前端界面。在 *cvs* 缓冲中的命令，基本只需要按
一两下键盘，Emacs 将其翻译为 cvs 控制命令。每执行一次，Emacs 会在缓冲
底部显示对应的 cvs 命令，以供参考。
3. 在 cvs 缓冲中常用的命令
n, p 移动光标。
f, o, RET 打开当前文件。
M-s 列出所有文件的当前状态。
x 在缓冲中去掉所有是 Up-To-Date 的状态的文件，这样比较干净。
M-u 更新本地拷贝。
U 放弃所做的改动，小心别把你没有提交的工作弄没了。
m 标记文件，用于对多个文件同时操作。u 去掉标记并下移；Backspace
去掉标记并上移；M-Backspace 同时去掉 buffer 中所有标记。% 用正
则表达式标记文件。
c 准备提交所做的改动，会弹出一个 *cvs-commit* 缓冲，用来写修改的
日志，写完完按 C-c C-c，执行提交。如果有标记，同时对所标记的所
有文件相库提交。
C 和 c 类似，但是清除上次提交时留在 *cvs-commit* 缓冲中的内容，不
过如果当前目录里的 ChangeLog 文件中有相关内容，会自动插入。
d 有一个提示，询问用哪种方式 diff。此时常用的可能是：
d d 或 d =，比较文件，本地拷贝和最后一次提交时的修订版；
d h 比较本地拷贝和当前源码库中最新版；
d b 比较本地拷贝和该文件的备份；
d e 用 ediff 比较文件，本地拷贝和最后一次提交时的修订版。
d y 和前一天的比较
r 删除文件，从当前拷贝的工作目录中删除，需要提交。
a 添加文件，添加到当前拷贝的工作目录中，需要提交。
i 把某个文件的名字添加到 .cvsignore 文件，这样在运行 cvs 命令时，
cvs 不再理会此文件。编辑 .cvsignore 文件，每一行一个或一类文件。
下面是一个 .cvsignore 文件的例子。有些类型的文件 cvs 缺省就是忽
略的，比如 .o 文件。
t 设置 tag，提示输入 tag 名字。
l 查看一个文件，所标记的多个文件，或目录文件的 log 信息。
s 通过 cvs status 命令查看文件或目录的状态，会弹出一个漂亮的
*cvs-info* 缓冲，列出文件的状态信息。
z, q 关闭 *cvs* 缓冲。
4. cvs buffer 中几种状态的说明（括号中是此时可能需要用到的命令）：
cvs buffer 中按一下 M-s 可以列出所有文件。每个一行，分别列出了当前的
CVS 状态、修订版和文件名。
"Up-to-date" 文件和库中文件一致，也就是说，目前是最新的修订版，而且没
有被改动过。（按 f 或 RET，进入文件进行编辑，l 看修改历史，+ 看 tag 信
息）
"Need-Update" 文件相对于源码库，不是最新的，需要更新。（M-u 更新，d h
比较当前文件和源码库中的区别）
"Modified" 文件已经被改动过，但还没有提交到源码库。（c/C 提交，d d 比
较，d e 用 ediff 比较，U 放弃修改，小心使用）
"Added" 用 cvs add 命令新添加的文件，添加了新文件只在本地有效，需要提
交到源码库。（c/C 提交）
"Removed" 用 cvs 的 remove 命令删除的文件，同 add 一样，需要提交到源码
库。（c/C 提交）
"Needs-Merge" 你编辑文件的时候，别人又向源码库提交过，因此本地的改动，
和源码库中的需要合并。（先 M-u 更新，如果发生冲突，手工修改，再 c/C 提
交，d b 和原来的备份比较，d h 和库中比较）
"Conflict" 你的提交和源码库中当前的状态有冲突，需要手工修改，并再提交
一次。（手工修改，再 c/C 提交）
"Unknown" 源码库中没有该文件，这或许不是你想要的，或许是刚刚新建的。
（如果想让 cvs 忽略此文件，按 i；想添加到源码库，按 a，再提交；用 r 删
除）
"Missing" 源码库中有，可是本地拷贝中却没有了。（M-u 更新，可以从新从源
码库得到拷贝）
5. 用 Emacs 的前缀参数修改 cvs 命令的选项
很多 cvs 命令可以给一个前缀参数，改变缺省的行为。多数的前缀参数都是
C-u，而多数改变的行为，就是修改传递给 cvs 的默认选项。
每执行一次操作，pcl-cvs 的 *cvs* 缓冲底部都会显示实际执行的 cvs 命令，
这些命令往往带有一些参数，如何修改这些参数呢？就通过给 pcl-cvs 的命令
加前缀 C-u。一般的，一个 C-u 只改变当前命令所用的 cvs 选项，如果前缀两
个 C-u，则是永久改变所用选项。
例如，d d 缺省比较当前拷贝和库中你check out时的修订版。
如果用 C-u d d 会提示输入 cvs 的选项，此时你可以给任意的 cvs diff
选项，用以进行各种各样灵活的比较。比如，输入 -r1.10 -r2.3 RET，此
次比较的就是源码库中当前文件修订版 1.10 和 2.3 之间的区别。
如果 C-u C-u d d，输入 -r1.10 RET，以后的 d d 命令都会带着 -r1.10
仿佛永久修改了默认选项。当然，可以再 C-u C-u d d 修改回去。
再如，cvs add 命令添加二进制文件需要 -kb 选项，用 C-u a 则提示输入cvs
add flags，输入 -kb RET，OK。
6. 查看一些信息
在一个文件或目录上，或标记了一些文件，按 l 可以在 *cvs-info* 缓冲中看
到这些文件的 log 信息，就是提交到源码库中的更新日志；按 s 可以看到状态
信息；按 + 也是状态信息，但是 tag 表为树型结构。
按 l 查看 log 信息时，*cvs-info* 缓冲的状态为 (Log-View CVS)。此时，有
很多方便的操作，比如比较两个修订版之间的不同，修改源码库中的 log 信息，
打开某个文件任意的修订版。比如，在 *cvs* 的某个目录上面按了 l，然后转
到 *cvs-info* 缓冲中，这里面列出的时该目录中所有文件的 log 信息，此时
的常用命令如下。
n, p 移动光标，在一个文件内的不同修订版之间
N, P 移动光标，在不同的文件之间，M-n, M-p 同样
m 设置 mark
d 和设置 mark 的那个修订版进行 diff
e 修改当前 log，编辑完，C-c C-c 提交
f, o, RET
这几个都是打开当前的修订版，稍有区别。用 f 的时候如果提示
vc-find-version 没有定义，手工加载一下 vc 库
M-x load-library RET vc RET。
z 关闭该缓冲
如果在 *cvs* 的目录里按 s，此时的 *cvs-info* 缓冲为(CVS-Status CVS)状
态，在这个缓冲中，也可以做类似的一些操作：
N, P 在文件之间移动, M-n, M-p 同样
n, p 上一行，下一行
f, o, RET
把光标移动到某个 tag 的名字上，则可以直接打开那个 tag 所在
的修订版
T, t 把每个文件所列的 tag 表转为树型结构，T 为横向的树，t 为竖向
的树
diff 命令产生的 *cvs-diff* 缓冲中也类似，N/P 在文件之间移动，n/p 在不
同的 diff 之间移动。此外，在任何一行代码的未知按 o 或 RET 可以直接转到
文件中的实际未知，很方便的。
7. Emacs 的 VC 的方便之处
在 PCL-CVS 中，几乎可以做任何 CVS 相关的操作。但有时候未免有些麻烦，配
合 Emacs 的 VC (Version Control) 会方便很多。
Emacs 的 VC 模式的作者就是著名的 Eric S. Raymond。VC 的功能很强大，而
且方便灵活。可以使用在三种版本管理系统中：RCS、CVS、SCCS，操作方式一致。
和 PCL-CVS 不同的是，VC 使用 C-x v 前缀完成大部分功能，不像PCL-CVS 使
用一个主界面，这使 VC 显得更方便。
几个主要的命令：
C-x v v vc-next-action
顾名思义，执行下一个动作，下一个动作是什么就执行什么，如果
是 Unknown 就 cvs add，如果是 Modified 就 commit，如果是
Up-to-date 就什么都不用做了。最方便的是只需在当前 buffer 中
执行。
C-x v m vc-merge
将库中别人所做的改动与本地的改动合并，和库中的版本保持一致。
C-x v a vc-update-change-log
更新更改日志文件 ChangeLog。如果源码库或本地拷贝中还没有，
试一下这个，它会根据 cvs 的提交日志，自动产生 ChangeLog，如
果已经有了，但已经有一段时间没有更新过，它会自动更新
ChangeLog 文件到最新的一条记录。
C-x v ~ vc-version-other-window
PCL-CVS 也可以方便的查看某个历史版本，不过都需要转到相应的
控制界面(*cvs* 或 *cvs-info* buffer)中。而 VC 的这个命令可
以在当前缓冲中用，会提示输入版本号，然后显示在另一个窗口中，
并保存在当前目录，文件名为 FILENAME.~REV~。
有时候，用 CVS 管理的东西不需要整体的控制，比如自己的笔记、随笔之类，
用 Emacs 设置上 bookmark，打开就写点，写完马上就提交，往往不必打开
PCL-CVS，恰恰 VC 这些灵活的命令非常合适。
继续了解 VC:
C-x v = vc-diff
比较文件。如果用了前缀参数，会询问和哪个文件的哪个版本比较。
C-x v u vc-revert-buffer
放弃没有提交的改动，恢复原状，也就是你的本地拷贝的版本，并
不管库中的最新改动。如果想同时和库中别人所做的改动保持一致，
用 C-u 作为前缀参数。
C-x v g vc-annotate
看看你的每行代码的状态(编辑历史)。每行的颜色用来表示这行代
码的新旧程度，蓝色的时间最长，红色的最短，其他的居中。默认
的最长时间为一年，超过一年的都显示为蓝色。用前缀参数可以修
改所显示的版本和默认最长时间。
这个缓冲中还有一些有趣的功能，可以直接转到某个修订版。每行
的最前面为当前行最后一次修改的修订版，在这行上按 J，整个缓
冲中的内容全都替换为这个修订版；按 N (或 P) 为缓冲中当前的
后一个(前一个)修订版；按 A 转到当前行上次被修改的版本。N/P
按修订版历史浏览，A 按当前行修改历史浏览，J 跳转该行所指修
订版，W 回到该文件的当前修订版。注意，模式行上文件名的后面
标注了缓冲当前内容的修订版。另外，D 可以比较当前行上的修订
版和前一修订版的区别，N/P 可以使用前缀参数。
C-x v d vc-directory
打开一个带版本控制功能的 Dired buffer，功能和 pcl-cvs 的
*cvs* buffer 有些类似。或许对非 CVS 的版本管理比较有用。
8. 相关配置
由 CVS 管理的模块中都有 "CVS" 目录，打开 cvs-dired-use-hook 时，在
"CVS" 目录上按 F，直接进入该模块的 *cvs* buffer：
(setq cvs-dired-use-hook 'always)
给 cvs-examine 一个方便的绑定：
(define-key global-map "\C-xve" 'cvs-examine) 绑定到 C-x v e。
$ cd ~/work
$ cvs -d :pserver:user@host:/path/to/repository co MODULE
2. 从 Emacs 开始
几个命令都可以进入 PCL-CVS 中，例如用 cvs-examine：
M-x cvs-examine RET path/to/MODULE RET
RET 表示回车键；path/to/MODULE，源码复本的目录，cvs-examine 缺省为当前
目录。此时 Emacs 打开名为 *cvs* 的缓冲，就是 PCL-CVS 的主界面。
PCL-CVS 只是命令行 cvs 的前端界面。在 *cvs* 缓冲中的命令，基本只需要按
一两下键盘，Emacs 将其翻译为 cvs 控制命令。每执行一次，Emacs 会在缓冲
底部显示对应的 cvs 命令，以供参考。
3. 在 cvs 缓冲中常用的命令
n, p 移动光标。
f, o, RET 打开当前文件。
M-s 列出所有文件的当前状态。
x 在缓冲中去掉所有是 Up-To-Date 的状态的文件，这样比较干净。
M-u 更新本地拷贝。
U 放弃所做的改动，小心别把你没有提交的工作弄没了。
m 标记文件，用于对多个文件同时操作。u 去掉标记并下移；Backspace
去掉标记并上移；M-Backspace 同时去掉 buffer 中所有标记。% 用正
则表达式标记文件。
c 准备提交所做的改动，会弹出一个 *cvs-commit* 缓冲，用来写修改的
日志，写完完按 C-c C-c，执行提交。如果有标记，同时对所标记的所
有文件相库提交。
C 和 c 类似，但是清除上次提交时留在 *cvs-commit* 缓冲中的内容，不
过如果当前目录里的 ChangeLog 文件中有相关内容，会自动插入。
d 有一个提示，询问用哪种方式 diff。此时常用的可能是：
d d 或 d =，比较文件，本地拷贝和最后一次提交时的修订版；
d h 比较本地拷贝和当前源码库中最新版；
d b 比较本地拷贝和该文件的备份；
d e 用 ediff 比较文件，本地拷贝和最后一次提交时的修订版。
d y 和前一天的比较
r 删除文件，从当前拷贝的工作目录中删除，需要提交。
a 添加文件，添加到当前拷贝的工作目录中，需要提交。
i 把某个文件的名字添加到 .cvsignore 文件，这样在运行 cvs 命令时，
cvs 不再理会此文件。编辑 .cvsignore 文件，每一行一个或一类文件。
下面是一个 .cvsignore 文件的例子。有些类型的文件 cvs 缺省就是忽
略的，比如 .o 文件。
t 设置 tag，提示输入 tag 名字。
l 查看一个文件，所标记的多个文件，或目录文件的 log 信息。
s 通过 cvs status 命令查看文件或目录的状态，会弹出一个漂亮的
*cvs-info* 缓冲，列出文件的状态信息。
z, q 关闭 *cvs* 缓冲。
4. cvs buffer 中几种状态的说明（括号中是此时可能需要用到的命令）：
cvs buffer 中按一下 M-s 可以列出所有文件。每个一行，分别列出了当前的
CVS 状态、修订版和文件名。
"Up-to-date" 文件和库中文件一致，也就是说，目前是最新的修订版，而且没
有被改动过。（按 f 或 RET，进入文件进行编辑，l 看修改历史，+ 看 tag 信
息）
"Need-Update" 文件相对于源码库，不是最新的，需要更新。（M-u 更新，d h
比较当前文件和源码库中的区别）
"Modified" 文件已经被改动过，但还没有提交到源码库。（c/C 提交，d d 比
较，d e 用 ediff 比较，U 放弃修改，小心使用）
"Added" 用 cvs add 命令新添加的文件，添加了新文件只在本地有效，需要提
交到源码库。（c/C 提交）
"Removed" 用 cvs 的 remove 命令删除的文件，同 add 一样，需要提交到源码
库。（c/C 提交）
"Needs-Merge" 你编辑文件的时候，别人又向源码库提交过，因此本地的改动，
和源码库中的需要合并。（先 M-u 更新，如果发生冲突，手工修改，再 c/C 提
交，d b 和原来的备份比较，d h 和库中比较）
"Conflict" 你的提交和源码库中当前的状态有冲突，需要手工修改，并再提交
一次。（手工修改，再 c/C 提交）
"Unknown" 源码库中没有该文件，这或许不是你想要的，或许是刚刚新建的。
（如果想让 cvs 忽略此文件，按 i；想添加到源码库，按 a，再提交；用 r 删
除）
"Missing" 源码库中有，可是本地拷贝中却没有了。（M-u 更新，可以从新从源
码库得到拷贝）
5. 用 Emacs 的前缀参数修改 cvs 命令的选项
很多 cvs 命令可以给一个前缀参数，改变缺省的行为。多数的前缀参数都是
C-u，而多数改变的行为，就是修改传递给 cvs 的默认选项。
每执行一次操作，pcl-cvs 的 *cvs* 缓冲底部都会显示实际执行的 cvs 命令，
这些命令往往带有一些参数，如何修改这些参数呢？就通过给 pcl-cvs 的命令
加前缀 C-u。一般的，一个 C-u 只改变当前命令所用的 cvs 选项，如果前缀两
个 C-u，则是永久改变所用选项。
例如，d d 缺省比较当前拷贝和库中你check out时的修订版。
如果用 C-u d d 会提示输入 cvs 的选项，此时你可以给任意的 cvs diff
选项，用以进行各种各样灵活的比较。比如，输入 -r1.10 -r2.3 RET，此
次比较的就是源码库中当前文件修订版 1.10 和 2.3 之间的区别。
如果 C-u C-u d d，输入 -r1.10 RET，以后的 d d 命令都会带着 -r1.10
仿佛永久修改了默认选项。当然，可以再 C-u C-u d d 修改回去。
再如，cvs add 命令添加二进制文件需要 -kb 选项，用 C-u a 则提示输入cvs
add flags，输入 -kb RET，OK。
6. 查看一些信息
在一个文件或目录上，或标记了一些文件，按 l 可以在 *cvs-info* 缓冲中看
到这些文件的 log 信息，就是提交到源码库中的更新日志；按 s 可以看到状态
信息；按 + 也是状态信息，但是 tag 表为树型结构。
按 l 查看 log 信息时，*cvs-info* 缓冲的状态为 (Log-View CVS)。此时，有
很多方便的操作，比如比较两个修订版之间的不同，修改源码库中的 log 信息，
打开某个文件任意的修订版。比如，在 *cvs* 的某个目录上面按了 l，然后转
到 *cvs-info* 缓冲中，这里面列出的时该目录中所有文件的 log 信息，此时
的常用命令如下。
n, p 移动光标，在一个文件内的不同修订版之间
N, P 移动光标，在不同的文件之间，M-n, M-p 同样
m 设置 mark
d 和设置 mark 的那个修订版进行 diff
e 修改当前 log，编辑完，C-c C-c 提交
f, o, RET
这几个都是打开当前的修订版，稍有区别。用 f 的时候如果提示
vc-find-version 没有定义，手工加载一下 vc 库
M-x load-library RET vc RET。
z 关闭该缓冲
如果在 *cvs* 的目录里按 s，此时的 *cvs-info* 缓冲为(CVS-Status CVS)状
态，在这个缓冲中，也可以做类似的一些操作：
N, P 在文件之间移动, M-n, M-p 同样
n, p 上一行，下一行
f, o, RET
把光标移动到某个 tag 的名字上，则可以直接打开那个 tag 所在
的修订版
T, t 把每个文件所列的 tag 表转为树型结构，T 为横向的树，t 为竖向
的树
diff 命令产生的 *cvs-diff* 缓冲中也类似，N/P 在文件之间移动，n/p 在不
同的 diff 之间移动。此外，在任何一行代码的未知按 o 或 RET 可以直接转到
文件中的实际未知，很方便的。
7. Emacs 的 VC 的方便之处
在 PCL-CVS 中，几乎可以做任何 CVS 相关的操作。但有时候未免有些麻烦，配
合 Emacs 的 VC (Version Control) 会方便很多。
Emacs 的 VC 模式的作者就是著名的 Eric S. Raymond。VC 的功能很强大，而
且方便灵活。可以使用在三种版本管理系统中：RCS、CVS、SCCS，操作方式一致。
和 PCL-CVS 不同的是，VC 使用 C-x v 前缀完成大部分功能，不像PCL-CVS 使
用一个主界面，这使 VC 显得更方便。
几个主要的命令：
C-x v v vc-next-action
顾名思义，执行下一个动作，下一个动作是什么就执行什么，如果
是 Unknown 就 cvs add，如果是 Modified 就 commit，如果是
Up-to-date 就什么都不用做了。最方便的是只需在当前 buffer 中
执行。
C-x v m vc-merge
将库中别人所做的改动与本地的改动合并，和库中的版本保持一致。
C-x v a vc-update-change-log
更新更改日志文件 ChangeLog。如果源码库或本地拷贝中还没有，
试一下这个，它会根据 cvs 的提交日志，自动产生 ChangeLog，如
果已经有了，但已经有一段时间没有更新过，它会自动更新
ChangeLog 文件到最新的一条记录。
C-x v ~ vc-version-other-window
PCL-CVS 也可以方便的查看某个历史版本，不过都需要转到相应的
控制界面(*cvs* 或 *cvs-info* buffer)中。而 VC 的这个命令可
以在当前缓冲中用，会提示输入版本号，然后显示在另一个窗口中，
并保存在当前目录，文件名为 FILENAME.~REV~。
有时候，用 CVS 管理的东西不需要整体的控制，比如自己的笔记、随笔之类，
用 Emacs 设置上 bookmark，打开就写点，写完马上就提交，往往不必打开
PCL-CVS，恰恰 VC 这些灵活的命令非常合适。
继续了解 VC:
C-x v = vc-diff
比较文件。如果用了前缀参数，会询问和哪个文件的哪个版本比较。
C-x v u vc-revert-buffer
放弃没有提交的改动，恢复原状，也就是你的本地拷贝的版本，并
不管库中的最新改动。如果想同时和库中别人所做的改动保持一致，
用 C-u 作为前缀参数。
C-x v g vc-annotate
看看你的每行代码的状态(编辑历史)。每行的颜色用来表示这行代
码的新旧程度，蓝色的时间最长，红色的最短，其他的居中。默认
的最长时间为一年，超过一年的都显示为蓝色。用前缀参数可以修
改所显示的版本和默认最长时间。
这个缓冲中还有一些有趣的功能，可以直接转到某个修订版。每行
的最前面为当前行最后一次修改的修订版，在这行上按 J，整个缓
冲中的内容全都替换为这个修订版；按 N (或 P) 为缓冲中当前的
后一个(前一个)修订版；按 A 转到当前行上次被修改的版本。N/P
按修订版历史浏览，A 按当前行修改历史浏览，J 跳转该行所指修
订版，W 回到该文件的当前修订版。注意，模式行上文件名的后面
标注了缓冲当前内容的修订版。另外，D 可以比较当前行上的修订
版和前一修订版的区别，N/P 可以使用前缀参数。
C-x v d vc-directory
打开一个带版本控制功能的 Dired buffer，功能和 pcl-cvs 的
*cvs* buffer 有些类似。或许对非 CVS 的版本管理比较有用。
8. 相关配置
由 CVS 管理的模块中都有 "CVS" 目录，打开 cvs-dired-use-hook 时，在
"CVS" 目录上按 F，直接进入该模块的 *cvs* buffer：
(setq cvs-dired-use-hook 'always)
给 cvs-examine 一个方便的绑定：
(define-key global-map "\C-xve" 'cvs-examine) 绑定到 C-x v e。