cvs完全手册

cvs完全手册====================================================================== ====he wehzhu, kerlion@, created at 2003-11-5updated at 2003-11-12版权声明：可以任意转载，转载时请务必标明原始出处和作者信息====================================================================== ====内容概述cvs环境设置登录cvs服务器：cvs命令格式cvs的日常使用其他常用命令cvs宏/keywordcvs分支管理cvs服务器的安装和配置watcherswincvs的安装和配置cvsweb的安装概述==================================cvs是一个并行版本控制系统，它采用c/s模式，它的复杂度和功能性属于中等，是当今最流行的版本控制系统。

它有两个基本的特点：*保存修改记录：保存了所有文件的修改历史，并可以建立分支*协作与并行：cvs不推荐使用lock-modify-unlock的串行的工作模式，而采用多人可以并行地修改同一个文件，而在提交时merge conflict；它更适合于大型的工作团体。

使用cvs的好处：*文件集中管理，大家都可以方便的看到所有人员的最新文件,规范化了文件的管理*可以查看以前任何的一个版本或修改历史*可以同时维护多个版本和分支cvs环境设置==================================先不要管cvs服务器的配置，我们先假设已经有一台配置好的服务器，要访问cvs，必需先设置环境变量cvsrootcvsroot=:pserver:user@server#port:/path/to/cvsroot*pserver是访问方式，口令认证的意思，这是最常用的方式，其他还有gserver,kserver,ext *user是cvs服务器的用户名，*server是cvs服务器的名称或者ip地址*/path/to/cvsroot是你的cvs服务器的cvsroot目录，根据你的cvs服务器设置做修改或者询问管理员你可以把设置放到你的shell的profile里（.bash_profile，.profile等）这样就不用每次敲一长串命令了高级功能：现在比较流行是使用ssh来加密口令和数据流cvsroot=:ext:user@server#port:/path/to/cvsrootcvs_rsh=sshhints:实际上没有cvsroot也可以，你可以每次用cvs -d :pserver:user@server#port:/path/to /cvsroot 来访问，而且它将忽略cvsroot环境变量，也许你会笑我只有疯子才这么用，不过，cvs可以把每次使用的命令参数放到一个文件中，所以在~/.cvsrc中加入cvs -d :pserver:user@server#port:/path/to/cvsroot即可，它最大的好处是修改了立刻生效，而且它的优先级高于cvsroot环境变量，到时候不要傻乎乎地来问我，我的环境变量真么不起作用了。

登录cvs服务器：==================================$cvs login，这时候cvs会问你口令，请把你在cvs服务器上的口令敲进去如果没有任何错误信息，恭喜你，成功了！成功登录后将建立一个~/.cvspass文件，保存你的口令，以后就不用输入口令了．cvs命令格式==================================cvs [global_opts] command [command_opts] [command_args]global options 属于左边cvs的，是全局的command_opts 属于左边command的，是局部的cvs --help-commands查看命令列表cvs -h command/cvs -help command 查看该命令的选项hints:如果你每次使用一些命令都带同样的参数的话，可以把它们放到~/.cvsrc文件中去update -cdiff -cadd -kbcvs -qcvs global-option comand comand-option argumentscvs的日常使用==================================cvs使用流程a checkout 尽当本地没有working copy时使用b staus 检查服务器上是否有新版本c update 如果有,则用update同步文件d 做你自己的修改，并保证正确e update 看是否有人修改了你的文件f 如果有冲突，合并冲突g commit 提交你的修改，如果因为又有人提交修改而失败，回到e步h 回到b步1 cvs checkout module_name-------------------------------------module_name可以暂时理解为目录名，它会在本地但前目录下建立module_name目录，在把服务器上说有module_name目录下的文件copy到本地module_name目录下。

注意：第一次checkout后，就不是通过cvs checkout来同步文件了，而是要进入该目录下进行具体文件的版本同步（添加，修改，删除）操作。

2 cvs update filename-------------------------------------将文件同步到最新的版本：不指定文件名，cvs将同步所有子目录下的文件。

最好每天开始工作前或将自己的工作导入到cvs库里前都要做一次，并养成"先同步后修改"的习惯，和virvual sourcesafe不同，cvs里没有文件锁定的概念，所有的冲突是在commit 之前解决，如果你修改过程中，有其他人修改并commit到了cvs库中，cvs会通知你文件冲突;>;>;>;>;>;>; latest revision number in the repository由你确认冲突内容的取舍。

也可以多人协商解决，修改完成后去掉文件中的冲突标志conflict:多人修改同一文件的同一区域这就叫冲突，它必须由人来解决，cvs不处理冲突，它只是告诉你存才冲突3 cvs commit -m "write some comments here" file_name------------------------------------确认修改写入到cvs库里。

注意：cvs的很多动作都是通过cvs commit进行最后确认并修改的，最好每次只修改一个文件。

在确认的前，还需要用户填写修改注释，以帮助其他开发人员了解修改的原因。

如果不用写-m "comments"而直接确认`cvs commit file_name` 的话，cvs会自动调用系统缺省的文字编辑器(一般是vi)要求你写入注释。

注释的质量很重要：所以不仅必须要写，而且必须写一些比较有意义的内容：以方便其他开发人员能够很好的理解不好的注释，很难让其他的开发人员快速的理解：比如：-m "bug fixed" 甚至-m ""好的注释，甚至可以用中文: -m "在用户注册过程中加入了email地址校验"修改某个版本注释：每次只确认一个文件到cvs库里是一个很好的习惯，但难免有时候忘了指定文件名，把多个文件以同样注释commit到cvs库里了，以下命令可以允许你修改某个文件某个版本的注释：cvs admin -m 1.3:"write some comments here" file_name4 查看状态------------------------------------cvs status filename状态报告，类似这样：file:foo.c status:up-to-dateworking revision: 1.1.1.1'some date'repository revision: 1.2/home/cvsroot/cvstest/foo.c,vsticky tag:(none)sticky date:(none)sticky options:(none)这里最重要的就是status栏，这里总共可能有四种状态：up-to-date：表明你要到的文件是最新的．locally modified：表明你曾经修改过该文件，但还没有提交，你的版本比仓库里的新．needing patch：表明有个哥们已经修改过该文件并且已经提交了！你的版本比仓库里的旧．needs merge：表明你曾经修改该文件，但是偏偏有个不识相的也修改了这个文件，而且还提交了!5 查看修改历史和注释信息------------------------------------cvs log file_name其他常用命令==================================1 添加文件和目录------------------------------------cvs add new_file_namecvs add -kb new_file_namecvs add dir_namecvs一般只处理文本文件，它会扩展keyword(宏)并转换行结束符对于图片，word文档等非纯文本的项目，需要使用cvs add -kb选项，否则有可能出现文件被破坏的情况然后确认修改并注释cvs ci -m "write some comments here" new_file_name2 删除文件------------------------------------将某个源文件物理删除后cvs remove file_name然后确认修改并注释cvs ci -m "write some comments here" file_name注意：很多cvs命令都有缩写形式：commit=>;ci; update=>;up; checkout=>;co; remove=>;rm;3.修改文件名------------------------------------移动文件：文件重命名cvs里没有cvs move或cvs rename，因为这两个操作是先cvs remove old_file_name，然后cvs add new_file_name实现的。