CVS简单教程3

time

（再续转贴）

现在服务器和客户端都设置好了，那么怎么用呢，我在这里写一个最简单的（估计也是最常用的）命令介绍：

首先，建立一个新的CVS项目，一般我们都已经有一些项目文件了，这样我们可以用下面步骤生成一个新的CVS项目：

进入到你的已有项目的目录，比如叫 cvstest：
$cd  cvstest
运行命令：
$cvs import -m "this is a cvstest project" cvstest     v_0_0_1     start
说明：import 是cvs的命令之一，表示向cvs仓库输入项目文件．
              -m参数后面的字串是描述文本，随便写些有意义的东西，如果不加 -m 参
数，那么cvs会自动运行一个编辑器（一般是vi，但是可以通过修改环境变量
EDITOR来改成你喜欢用的编辑器．）让你输入信息，
             cvstest 是项目名称（实际上是仓库名，在CVS服务器上会存储在以这个名字
命名的仓库里．）
             v_0_0_1是这个分支的总标记．没啥用（或曰不常用．）
             start 是每次 import 标识文件的输入层次的标记，没啥用．
这样我们就建立了一个CVS仓库了，然后，我们可以把这个测试项目的文件删除．试验一下如何从仓库获取文件．这里我假设上面的所有客户端工作你都已经做过了．
运行下面的命令：
   $cvs checkout cvstest
从仓库中检索出cvstest项目的源文件．
如果你已经做过一次checkout了，那么不需要重新checkout，只需要进入cvstest项目的目录，更新一把就行了：
$cd cvstest
$cvs update
一下即可．又或者你不想直接更新，只是想看看有没有更新的东西，那么：
$cvs status
这时后会打印出一长串状态报告（你可能需要用类似less这样的命令分页显示，或者定向到一个输出文件里慢慢看．），对项目中的每个文件有一份状态报告，类似这样：
===================================================================
File: foo.c             Status: Up-to-date
   Working revision:    1.1.1.1 'Some Date'
   Repository revision: 1.2     /home/cvsroot/cvstest/foo.c,v
   Sticky Tag:          (none)
   Sticky Date:         (none)
   Sticky Options:      (none)

这里最重要的就是 Status 栏，这里总共可能有四种状态：
Up-to-date：表明你要到的文件是最新的．
Locally Modified：表明你曾经修改过该文件，但还没有提交，你的版本比仓库里的新．
Needing Patch：表明有个哥们已经修改过该文件并且已经提交了！你的版本比仓库里的旧．
Needs Merge：表明你曾经修改过该文件，但是偏偏有个不识相的也修改了这个文件，而且还提交给仓库了！

如果你只是想保持软件的同步的话（象我），那么上面的东西就足够用了．可是如果多人协作开发项目的话，可就不是了这么简单了．当你参加项目，维护文件时，就需要更多命令，比如说你我都是某 nasdaq 项目的开发人员：

1，你对某个文件做了修改，比如说改了ceo.c，加了一行程序：printf("where can I find VC to cheat!");
改完之后你要把修改提交给仓库，用命令：
$cvs commit -m "add a complain" ceo.c
或者就是：
$cvs commit -m "worry about money"
让cvs帮你检查哪个文件需要提交．

2，当我开始干活的时候，可能我先：
$cvs status
一把，这时候我会看到：

==================================================================
File: ceo.c             Status: Needing Patch

   Working revision:    1.1.1.1 'Some Date'
   Repository revision: 1.2     /home/cvsroot/nastaq/ceo.c,v
   Sticky Tag:          (none)
   Sticky Date:         (none)
   Sticky Options:      (none)

于是我知道有人改了ceo.c，于是我就：
$cvs update ceo.c
或者干脆：
$cvs update
把ceo.c这个文件更新为最新版本，然后再干活．然后提交．

如果这天你修改了coo.c，加了一行 puts("how about another kind of bragging?");
并且提交了，但是这时候我已经 $cvs status 过了，就是说我不知道你的修改．
而我加了一行printf("You must shamelessly and seems knowingness to act as a coo");
并且傻乎乎地提交：
$cvs commit coo.c
这时候，CVS会告诉我
cvs commit: Examing .
cvs server: Up-to-date check failed for 'coo.c'
cvs [server aborted]: correct above error first!

于是我知道有个狗屎在我修改文件的当口做了提交，于是我
$cvs update
这时cvs会报告：
RCS file: /home/cvsroot/nasdaq/coo.c,v
retrieving revision 1.1.1.1
retrieving revision 1.2
Merging differences between 1.1.1.1 and 1.2 into coo.c
rcsmerge: warning: conflicts during merge
cvs update: conflicts found in coo.c
C coo.c
告诉你coo.c有版本冲突，于是我编辑coo.c，这时一般文件里看起来象这样：
  ...
printf("You must shamelessly and seems knowingness to act as a coo");
<<<<<<< foo.c
=======
...
  puts("how about another kind of bragging?");
>>>>>>> 1.2
...

于是我把上面改成：
printf("You must shamelessly and seems knowingness to act as a coo");
puts("how about another kind of bragging?");
然后
$cvs commit -m "merged" coo.c
于是下回你再更新的时候就有新的补钉要打．．．如此往复，直到完成所有修改．
不过这里有一些要注意的地方就是删除程序，如果你删掉一行对你可能没有用的程序
puts("to be honest"); 而我不想删除（因为我有用），而我不知情地直接：
$cvs update
了，那么我的这行程序也完蛋了，所以这里我们要注意所有开发人员的协调，千万不要乱删东西，大不了用
#if    0
#endif
宏定义对括起来．实在要删东西，那最好先标记一个版本：
$cvs tag v_0_0_1

然后你可以发布并删除你自己的工作目录里这个版本的文件（注意：不是删除仓库里的．）：

$cvs release -d nasdaq

然后你再生成一个新分支：

$cvs rtag -b -r v_0_0_1 v_0_0_1_1 nasdaq

然后再建立v_0_0_1_1的分支

$cvs checkout -r v_0_0_1_1 nasdaq

编辑并修改这个分支的文件，这样的做法比较好．

不过要注意的是，新标记和新分支的建立最好由项目的管理人员负责，否则每个人都做一个分支，那么仓库就太乱了．因此，比较的开发人员之间的直接沟通是不能忽略的．一般来说，在互联网上的标准模式是有一个管理员（可能自己并不写程序），有一个邮递列表，大家都在邮递列表上交流看法和做各种决议．当形成决议之后，管理员做一个新版本的标记．以此循环．
  

还有一些命令，比如要增加一个文件 garbage_china_concept_stocks_list：

$cvs add garbage_china_concept_stocks_list

然后还要：

$cvs commit  garbage_china_concert_stocks_list

看起来有点象数据库里的事务？的确是这样．CVS维护着一个本地的参考文件（在CVS/Entries里），这样提交的时候就可以一次地把所有改变放到服务器端，这样也更安全．同样，如果想删除文件 bankrupted_web_site：

$rm bankrupted_web_site
$cvs remove bankrupted_web_site
$cvs commit bankrupted_web_site

3，一些小技巧：
$Header$ 标记：把这个标记放在文件的任何地方都会被 cvs 替换成最后修改的 cvs 用户名，该文件当前版本号，最后修改时间，该文件的 cvs 仓库路径，看起来象下面这个样子：

// $Header: /home/cvsroot/simhost/simhost.cpp,v 1.2 2001/04/20 08:26:10 jqliu Exp $

一般我们把它放在开头，这样对程序员修改文件非常便利，很多时候你只要看一眼开头就知道文件是否最新．

$Id$标记：把这个标记放在文件的任何地方都会被 cvs 替换成最后修改的 cvs 用户名，该文件当前版本号，最后修改时间，该文件的 cvs 仓库路径，看起来象下面这个样子：

$Id: simhost.cpp,v 1.3 2001/04/24 02:27:36 simhost Exp $

好了，上面所有的东西，估计就是我们用cvs时80%情况下用的命令和内容，包括文件的更新，提交，冲突的解决，分支的派生，增删文件等．实际上cvs的功能之强大，远远超出我在这里描述的内容，我这个＂速成＂也就管不了太多了，希望随着时间的推移，我们能够更加有效地使用CVS．也希望大家能够不断补充这篇文章，最后能够成为手册，而不仅仅是速成．当然，还要更多地参考别的文档．

（转自：何伟平 “ CVS 简单教程 ”）