CVS的常用命令速查手册

CVS的常用命令速查手册

转载说明 此转载基于原作者最后更新于2002-06-15 23:18:05的版本。原作可以在这里找到，本文的版权归原作者所有。本文作者原为网易公司的资深开发人员。 版权声明 可以任意转载，转载时请务必标明原始出处和作者信息 概述：CVS是一个C/S系统，多个开发人员通过一个中心版本控制系统来记录文件版本，从而达到保证文件同步的目的。        CVS服务器（文件版本库）      /     |       / （版 本 同 步）    /       |         /   开发者1  开发者2   开发者3 以下是本文主要内容：开发人员可以主要挑选2, 6看就可以了，CVS的管理员则更需要懂的更多一些 标题 内容简介 读者对象 CVS环境初始化 CVS环境的搭建 管理员 CVS的日常使用 日常开发中最常用的CVS命令 开发人员、管理员 CVS的分支开发 项目按照不同进度和目标并发进行 管理员 CVS的用户认证 通过SSH的远程用户认证，安全，简单 管理员 CVSWEB CVS的WEB访问界面大大提高代码版本比较的效率 管理员 CVS TAG 将$Id$加入代码注释中，方便开发过程的跟踪 开发人员 一个系统20%的功能往往能够满足80%的需求，CVS也不例外，以下是CVS最常用的功能，可能用到的还不到它全部命令选项的10%，更多的功能请在实际应用过程中体会，学习过程中应该是用多少，学多少，用到了再学也不迟。 CVS环境初始化 ============ 环境设置：指定CVS库的路径CVSROOT tcsh setenv CVSROOT /path/to/cvsroot bash CVSROOT=/path/to/cvsroot ; export CVSROOT 后面还提到远程CVS服务器的设置： CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH 初始化：中心库版本库的初始化，其实就是一个目录 cvs init 项目首次导入 cvs import -m "write some comments here" project_name vender_tag r_tag 项目导出：将代码从CVS库里导出 cvs checkout project_name CVS的日常使用   ============= 确认修改：确认自己的修改并写入到CVS库里 cvs commit -m "write some comments here" file_name 注意：CVS的很多动作都是通过cvs commit进行最后确认并修改的，在确认的前，还需要用户填写修改注释，以帮助其他开发人员了解修改的原因。如果不用写-m "comments"而直接确认`cvs commit file_name` 的话，cvs会自动调用系统缺省的文字编辑器(一般是vi)要求你写入注释。 注释的质量很重要：所以不仅必须要写，而且必须写一些比较有意义的内容：以方便其他开发人员能够很好的理解。不好的注释，很难让其他的开发人员快速的理解：比如： -m "bug fixed" 甚至 -m ""。好的注释，甚至可以用中文: -m "在用户注册过程中加入了Email地址校验" 同步最近修改：开始工作前和将自己的工作导入到CVS库里前都要做一次：先同步 后修改 cvs update -m "write some comments here" file_name 注意：不要使用项目首次导出后，以后就要用cvs update在导出的项目目录下进行同步了，而不是每次重新cvs checkout来同步文件了。如果导出后修改了文件，然后再次从导出的项目目录的上一级cvs checkout proj等于是删除了proj目录然后重新导出，上次导出后的修改就全丢了。 修改某个版本注释：每次只确认一个文件到CVS库里是一个很好的习惯，但难免有时候忘了指定文件名，把多个文件以同样注释commit到CVS库里了，以下命令可以允许你修改某个文件某个版本的注释： cvs admin -m 1.3:"write some comments here" file_name 删除文件： 文件删除后，比如： rm file_name cvs rm file_name cvs ci -m "write some comments here" 以上面前2步合并的方法为： cvs rm -f file_name cvs ci -m "why delete file" 注意：很多cvs命令都有缩写形式：commit=>ci; update=>up; checkout=>co; remove=>rm; 添加文件 文件添加后，比如： touch new_file cvs add new_file cvs ci -m "write some comments here" 添加目录： cvs add dir_name 查看修改历史： cvs log file_name cvs history file_name 查看当前文件不同版本的区别 cvs diff -r1.3 -r1.5 file_name 查看当前文件（可能已经修改了）和库中相应文件的区别 cvs diff file_name cvs的web界面提供了更方便的定位文件修改和比较版本区别的方法，具体安装设置请看后面的cvsweb使用 正确的通过CVS恢复旧版本的方法： 如果用 cvs update -r1.2 file.name 这个命令是给file.name加一个STICK TAG： "1.2" ，虽然你的本意只是想将它恢复到1.2版本 正确的恢复版本的方法是 cvs update -p -r1.2 file_name >file_name 如果不小心已经加成STICK TAG的话：用cvs update -A 解决 移动文件：文件重命名 cvs里没有cvs move或cvs rename，因为这两个操作是先cvs remove old_file_name，然后cvs add new_file_name实现的。 删除，移动目录： 最方便的方法是让管理员直接移动，删除CVSROOT里相应目录（因为CVS一个项目下的子目录都是独立的，移动到$CVSROOT目录下都可以作为新的独立项目：好比一颗树，其实砍下任意一枝都能独立存活），对目录进行了修改后，要求其开发人员重新导出项目cvs checkout project_name 或者用cvs update -dP同步。 CVS Branch：项目多分支同步开发 ============================= 确认版本里程碑：多个文件各自版本号不一样，项目到一定阶段，可以给所有文件统一指定一个阶段里程碑版本号，方便以后按照这个阶段里程碑版本号导出项目，同时也是项目的多个分支开发的基础。 cvs tag release_1_0 开始一个新的里程碑： cvs commit -r 2 标记所有文件开始进入2.x的开发 注意：CVS里的revsion和软件包的发布版本可以没有直接的关系。但所有文件使用和发布版本一致的版本号比较有助于维护。 在开发项目的2.x版本的时候发现1.x有问题，但2.x又不敢用，则从先前标记的里程碑：release_1_0导出一个分支release_1_0_patch cvs rtag -b -r release_1_0 release_1_0_patch proj_dir 一些人先在另外一个目录下导出release_1_0_patch这个分支：解决1.0中的紧急问题， cvs checkout -r release_1_0_patch 而其他人员仍旧在项目的主干分支2.x上开发 在release_1_0_patch上修正错误后，标记一个1.0的错误修正版本号 cvs tag release_1_0_patch_1 如果2.0认为这些错误修改在2.0里也需要，也可以在2.0的开发目录下合并release_1_0_patch_1中的修改到当前代码中： cvs update -j release_1_0_patch_1 CVS的远程认证：通过SSH远程访问CVS ================================ 使用cvs本身的远程认证很麻烦,需要定义服务器和用户组，用户名，设置密码等，而且不安全，因此和系统本地帐号认证并通过SSH传输是比较好的办法，通过在客户机的/etc/profile里设置一下内容： CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH 所有客户机所有本地用户都可以映射到CVS服务器相应同名帐号了。 如果CVS所在服务器的SSH端口不在缺省的22，或者和客户端与CVS服务器端SSH缺省端口不一致，有时候设置了： :ext:$USER@test.server.address#port:/path/to/cvsroot 仍然不行，比如有以下错误信息： ssh: test.server.address#port: Name or service not known cvs [checkout aborted]: end of file from server (consult above messages if any) 解决的方法是做一个脚本指定端口转向（不能使用alias，会出找不到文件错误）： 创建一个/usr/bin/ssh_cvs文件： #!/usr/bin/sh /path/to/ssh -p 34567 "$@" 然后：chmod +x /usr/bin/ssh_cvs 并CVS_RSH=ssh_cvs; export CVS_RSH 注意：port是指相应服务器SSH的端口，不是cvs pserver的端口 CVSWEB：提高程序员比较文件修改效率 ================================ CVSWEB就是CVS的WEB界面，可以大大提高程序员定位修改的效率: 使用的样例可以看：http://www.freebsd.org/cgi/cvsweb.cgi CVSWEB的下载：CVSWEB从最初的版本已经演化出很多功能界面更丰富的版本，这个是个人感觉觉得安装设置比较方便的：http://www.spaghetti-code.de/software/linux/cvsweb/ 下载解包： tar zxf cvsweb.tgz 把配置文件cvsweb.conf放到安全的地方（比如和apache的配置放在同一个目录下）， 修改：cvsweb.cgi让CGI找到配置文件： $config = $ENV{'CVSWEB_CONFIG'} || '/path/to/apache/conf/cvsweb.conf'; 转到/path/to/apache/conf下并修改cvsweb.conf： 修改CVSROOT路径设置： %CVSROOT = ( 'Development' => '/path/to/cvsroot', #<==修改指向本地的CVSROOT ); 缺省不显示已经删除的文档： "hideattic" => "1",#<==缺省不显示已经删除的文档 在配置文件cvsweb.conf中还可以定制页头的描述信息，你可以修改$long_intro成你需要的文字 CVSWEB可不能随便开放给所有用户，因此需要使用WEB用户认证： 先生成 passwd: /path/to/apache/bin/htpasswd -c cvsweb.passwd user 修改httpd.conf: 增加 <Directory "/path/to/apache/cgi-bin/cvsweb/"> AuthName "CVS Authorization" AuthType Basic AuthUserFile /path/to/cvsweb.passwd require valid-user </Directory> CVS TAGS: who? when? ==================== 将$Id$ 加在程序文件开头的注释里是一个很好的习惯，cvs能够自动更新其中的内容成：file_name version time user_name 的格式，比如：cvs_card.txt,v 1.1 2002/04/05 04:24:12 chedong Exp，可以这些信息了解文件的最后修改人和修改时间 几个常用的缺省文件： default.php <?php /* * Copyright (c) 2002 Company Name. * $Id$ */ ?> Default.java: 注意文件头一般注释用 /* 开始 JAVADOC注释用 /** 开始的区别 /* * Copyright (c) 2002 Company Name. * $Id$ */ package com.netease; import java.io; /** * comments here */ public class Default {     /**     *     * @param     * @return     */     public toString() {     } } default.pl: #!/usr/bin/perl -w # Copyright (c) 2002 Company Name. # $Id$ # file comments here use strict; 相关资源： CVS HOME： http://www.cvshome.org/ CVS FAQ： http://www.loria.fr/~molli/cvs-index.html 相关网站: Google: CVS CVS 免费书: http://cvsbook.red-bean.com/ CVS 命令的速查卡片： http://www.refcards.com/about/cvs.html