CVS使用简介
发布者：netbull
这里有一篇有关CVS的使用简介，是我以前做项目时为
初学者翻译的，本着“够用”的原则翻的，还有很多精
华没有翻出来，但作为一个入门进阶是够了。
CVS 使用简介
============
CVS是RCS的前端工具，它是用于多用户并行开发的版本控制工具，它的最大特点是使用了“copy-modify-merge”机制而不是“lock-modify-unlock”。通过使用CVS生成一个存储文件的仓库（repository），存储在仓库中的每个目录叫做模块（module），在修改时将相应的模块检出到工作目录中（working directory）生成对应的目录，所有的修改都在工作目录中完成，修改完成后再提交到仓库中生成新的版本号，并加以保存。
1． CVS初始化
-------------
（1） 创建CVSROOT根目录
编辑有关的环境变量，加入CVSROOT的定义（比如在 /etc/bashrc 文件中加入下面两行）：
CVSROOT=/usr/local/cvsroot
export CVSROOT
然后在相应位置开始创建CVSROOT
$cd /usr/local/
$mkdir cvsroot
$cvs –d /usr/local/cvsroot init
这时就会产生/usr/local/cvsroot/CVSROOT 目录，这下面放着有关CVS的配置文件。同时/usr/local/cvsroot/也作为文件仓库存放所有的文件。
(2） 创建开发项目
如果从头开始一个新的项目，就需要创建一个单独的目录，并把所有要使用的文件做一个有效的组织。而如果在开始使用源文件的目录之前就有了，则只需进入该目录就行了。
$cd /work/tang
$ls cvstest
. .. c/
$cd cvstest
然后，就可以输入源文件目录：
$cvs import –m “Create Source Dir” cvstest/c tang cvstest
这样会生成 $CVSROOT/cvstest/c 目录。 其中 -m 用来指定注释信息，如果后面在命令行不指定注释信息，则会启动缺省编辑器（vi）要求输入注释信息。 tang, cvstest分别标识了厂商和发行标识。
注意，使用import命令会把当前目录下的所有文件和目录（包括子目录）引入到文件仓库中指定模块（目录）下。
2． 命令简介
-------------
（1） 检出源文件
cvs checkout [-r rev][-D date][-d dir][-j merg1] [-j merg2] modules
-r 检出指定版本的模块
-D 检出指定日期的模块
-d 检出指定目录而不是模块
-j 合并当前版本和指定版本
使用下面的命令会检出刚才生成的模块，并在当前目录下生成与文件仓库中完全一样的目录结构：
$cvs checkout cvstest/c
对于目录结构比较复杂的模块可以在 $CVSROOT/CVSROOT/modules中加以指定:
1) $cvs checkout CVSROOT/modules
2) 在modules文件中加入下面一行：
SOURCE cvstest/c
3) 然后执行：
$cvs commit –m “Add SOURCE”
以后就可以使用下面的命令在当前路径下生成 cvstest/c 目录
$cvs checkout SOURCE
在当前路径下生成的这个目录就被称为工作目录，对源文件的所有修改都应该在这个目录下完成，而绝对不允许去改动在 文件仓库中$CVSROOT 目录下的文件。
（2） 删除、增加、重命名文件和目录
cvs add [-k kflags][-m message] files...
-k 指定以后该文件的缺省检出目录
-m 对文件的描述
上述命令会加入一个新的文件到文件仓库里，但直到使用了提交命令它才会真正更新文件仓库。
cvs remove [options] files
上述命令会从文件仓库中删除文件，但也要到提交之后才有作用。
例1：增加文件
$cvs checkout SOURCE
$cd cvstest/c
$touch test.c
$cvs add test.c
$cvs commit –m “add test.c”
例2：删除文件
$cvs checkout SOURCE
$cd cvstest/c
$rm test.c
$cvs remove test.c
使用 –f 选项能上面两步合做一步。
$cvs remove –f test.c
如果在提交之前想恢复刚才删除的文件，可以如下：
$cvs add test.c
如果只执行了第一步删除（rm），则可以用下面的方法恢复：
$cvs update test.c
对于重命名的文件，可以先删除再添加。
对于目录的修改（重命名），可能需要修改cvs 管理文件，一般应该遵循以下步骤：
1) 确认所有有关的修改都已经提交；
2) 进入文件仓库中要修改的模块目录，对相应的目录进行修改（重命名或删除）
$cd $CVSROOT/modules
$mv old_dir new_dir
3) 如果有必要，修改管理文件，比如modules 文件
如果要删除目录，则应该先对目录中每个文件都进行了删除（包括使用cvs remove ）处理之后再执行上面的第2步。
（3） 提交源文件
cvs commit [-Rl][-m mesg] files
-R 连子目录一起提交
-l 只提交本地目录（不提交子目录）
-m 注释信息
在检出源文件之后，在工作目录中对源文件进行的所有修改都必须在提交之后才能对文件仓库中的源文件起作用，并且新的文件才能够被分配一个新的版本号。
（4） 释放工作目录
cvs release –d SOURCE
这个命令会删除工作目录 cvstest/c （建议在提交了修改的模块后执行这一步）， 它比使用 rm –rf cvstest 要好。
3． 多用户开发
---------------
在多用户的情况下，如果不同用户修改的是同一个文件的不同部分，则使用下面的命令就能进行版本合并（把检出的文件与当前的最新版本合并）：
$cvs update
（1） 冲突解决
在有多个用户对同一个文件进行修改时，如果修改了其中的相同部分，而修改后的内容如果有不同的话，出现冲突是不可避免的。如果在CVS 文件仓库中有一个文件 test.c ，它的版本是 1.4， 用户A 先检出该文件进行修改，而稍后有用户B 检出该文件进行修改，并提前提交成 1.5， 而在用户A再提交时就会出现冲突（如果文件内容不同的话），这时CVS会提示需要手工解决。
文件仓库中的版本1.4:
#include stdio.h
main()
{
int i;
for(i = 0; i < 100; i++)
printf(“Count: %d\n”, i);
}
用户B 1.5:
#include stdio.h
main()
{
int i;
for(i = 0; i < 10; i++)
printf(“Count: %d\n”, i);
printf(“Over\n”);
}
用户A :
#include stdio.h
main()
{
int i;
for(i = 0; i < 50; i++)
printf(“Count: %d\n”, i);
return;
}
提交时会提示有冲突，需要手工编辑，这时运行了$cvs update 之后再编辑test.c， 会看到：
#include stdio.h
main()
{
int i;
<<<<<<< test.c
for(i = 0; i < 50; i++)
=======
for(i = 0; i < 10; i++)
>>>>>>> 1.5
printf("Count: %d\n", i);
<<<<<<< test.c
return;
=======
printf("Over\n");
>>>>>>> 1.5
}
（2） 文件版本管理
cvs log [-lR][-r rev][-d date][-w login][files…]
-l 不处理子目录
-R 对子目录做同样处理
-r 指定版本号
-d 指定时间
-w 指定登录名
使用上面的命令可以参看当前模块或指定文件的所有历史版本信息。
cvs annotate [-lR][-r rev|-D date] files
-l 不处理子目录
-R 对子目录做同样处理
-r 指定版本号
使用上面的命令可以参看指定文件（检出之后）的所有修改信息。
例：$cvs annotate cvstest/c/test.c
输出：
版本 修改人 修改时间 源代码
1.1 (tang 18-Jan-00): #include stdio.h
1.1 (tang 18-Jan-00): #include string.h
1.1 (tang 18-Jan-00):
1.1 (tang 18-Jan-00): main()
1.1 (tang 18-Jan-00): {
1.1 (tang 18-Jan-00): int i = 0 ;
1.1 (tang 18-Jan-00):
1.1 (tang 18-Jan-00): for(i = 0; i < 20; i++)
1.1 (tang 18-Jan-00): printf("Count: %d\n", i);
1.1 (tang 18-Jan-00):
1.3 (tang 18-Jan-00): printf("222222\n");
1.4 (tang 18-Jan-00): printf("333333\n");
1.1 (tang 18-Jan-00): }
使用下面的命令可以生成相对于一个指定主版本的分支版本：
cvs rtag –b –r rev_root rev_branch file_name
-b 指定生成一个分支版本
-r 指定该分支的主干节点版本号
rev_root 主干版本号
rev_branch 分支版本号
file_name 指定文件，使用“.”表示当前目录下所有文件
使用上面的命令可以生成一个对应版本号的分支版本，由于CVS 版本号是用数字表示的，而且在同一个模块下不同文件的版本完全可能是不同的，所以使用标识会更方便。
例：
$cvs rtag –b –r 1.2 tlb-1 SOURCE
以后要访问该分支版本，可以使用“-r” 选项
$cvs checkout –r tlb-1 SOURCE
从当前检出的版本切换到一个分支版本：
$cvs update –r tlb-1 SOURCE
使用下面的命令可以看版本信息：
cvs status [–vlR] files
-v 显示所有信息
-l 不显示子目录信息
-R 显示子目录信息
cvs update –j rev module
把当前所做的修改与指定版本的文件进行合并。
主干 1.1 ? 1.2 ? 1.3 ? 1.4 ? 1.5 ? 1.6
↓
分支tlb-1 ? 1.2.2.1 ? 1.2.2.2 ? 1.2.2.3
如果要合并分支tlb-1上的版本：
$cvs update –j 1.2.2.3 –j tlb-1 test.c
其中1.2.2.3可以通过tag命令生成一个容易记忆的标识。
如果要合并分支tlb-1到主干上1.2 ：
$cvs update –j tlb-1 test.c
如果要合并主干上的不同版本（注意顺序很重要，同时在指定版本之间的所有修改将被丢弃）：
$cvs update –j 1.5 –j 1.2 test.c
如果在不同版本之间模块的文件有增减，则可以：
$cvs update –A
$cvs updata –jbranch_name
4． 在远程机器上使用CVS
----------------------
通过网络使用CVS 有很多种方式，但在这里只介绍比较简单的一种：通过rsh 执行cvs 命令。
1) 在远程机器的.rhosts中加入对本地机的访问许可：
tom tang
2) 使用下面的命令检出模块ESMSTRG
$cvs –d :ext:tang@esmpro:/work/cvsroot checkout SOURCE
其中， ext 指明了连接方式为 rsh， tang 指明了本地用户， esmpro 指明了远地主机，/work/cvsroot 指明了在远地主机上的$CVSROOT路径，可以在本地设置CVS_SERVER环境变量指明这个目录。
5． 参看帮助
----------------
cvs –H command
可以参看指定命令的帮助信息。
