1489.html

著名的linux英雄站点的文档打包

<br>
版权声明：可以任意转载，转载时请务必标明原始出处和作者信息<br>
<br>
关键词：CVS CVSWeb CVSTrac WinCVS CVSROOT<br>
<br>
内容摘要：<br>
<br>
CVS是一个C/S系统，多个开发人员通过一个中心版本控制系统来记录文件版本，从而达到保证文件同步的目的。工作模式如下：<br>
<br>
       CVS服务器（文件版本库）<br>
     /     |       <br>
     （版 本 同 步）<br>
   /       |         <br>
开发者1  开发者2   开发者3             <br>
<br>
开发人员入门可以主要挑选2,6看就可以了，CVS的管理员则更需要懂的更多一些，最后还简单介绍了一些Windows下的cvs客户端使用，远程用户认证的选择，及与BUG跟踪系统等开发环境的集成问题。<br>
<br>
   1. CVS环境初始化：CVS环境的搭建                                          管理员<br>
   2. CVS的日常使用：日常开发中最常用的CVS命令，              开发人员      管理员<br>
   3. CVS的分支开发：项目按照不同进度和目标并发进行                         管理员<br>
   4. CVS的用户认证：通过SSH的远程用户认证，安全，简单                      管理员<br>
   5. CVSWEB：CVS的WEB访问界面大大提高代码版本比较的效率                    管理员<br>
   6. CVS TAG：将$Header$加入代码注释中，方便开发过程的跟踪   开发人员<br>
   7. CVS vs VSS: CVS和Virsual SourceSafe的比较               开发人员      管理员<br>
   8. WinCVS:  通过SSH认证的WinCVS认证设置<br>
   9. CVS的小组协同开发：开发组级的开发环境搭建，通过CVSTrac实现web界面的CVS用户管理及集成的BUG跟踪和WIKI交流。<br>
<br>
一个系统20%的功能往往能够满足80%的需求，CVS也不例外，以下是CVS最常用的功能，可能还不到它全部命令选项的20%，更多的功能在实际应用过程中体会，你想用多少就学多少，不时回头看看经常有意外的收获。<br>
<br>
<br>
CVS环境初始化<br>
============<br>
<br>
环境设置：指定CVS库的路径CVSROOT<br>
tcsh<br>
setenv CVSROOT /path/to/cvsroot<br>
bash<br>
CVSROOT=/path/to/cvsroot ; export CVSROOT<br>
<br>
后面还提到远程CVS服务器的设置：<br>
CVSROOT=:ext:$[e-mail]#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH<br>
<br>
初始化：CVS版本库的初始化。<br>
cvs init<br>
<br>
一个项目的首次导入<br>
cvs import -m "write some comments here" project_name vendor_tag release_tag<br>
执行后：会将所有源文件及目录导入到/path/to/cvsroot/project_name目录下<br>
vender_tag: 开发商标记<br>
release_tag: 版本发布标记<br>
<br>
项目导出：将代码从CVS库里导出<br>
cvs checkout project_name<br>
cvs 将创建project_name目录，并将最新版本的源代码导出到相应目录中。这个checkout和Virvual SourceSafe中的check out不是一个概念，相对于Virvual SourceSafe的check out是cvs update， check in是cvs commit。<br>
<br>
CVS的日常使用  <br>
=============<br>
<br>
注意：第一次导出以后，就不是通过cvs checkout来同步文件了，而是要进入刚才cvs checkout project_name导出的project_name目录下进行具体文件的版本同步（添加，修改，删除）操作。<br>
<br>
将文件同步到最新的版本<br>
cvs update<br>
不制定文件名，cvs将同步所有子目录下的文件，也可以制定某个文件名/目录进行同步<br>
cvs update file_name<br>
最好每天开始工作前或将自己的工作导入到CVS库里前都要做一次，并养成“先同步 后修改”的习惯，和Virvual SourceSafe不同，CVS里没有文件锁定的概念，所有的冲突是在commit之前解决，如果你修改过程中，有其他人修改并commit到了CVS库中，CVS会通知你文件冲突，并自动将冲突部分用<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
content on cvs server<br>
&lt;&lt;&lt;&lt;&lt;&lt;<br>
content in your file<br>
&gt;&gt;&gt;&gt;&gt;&gt;<br>
标记出来，由你确认冲突内容的取舍。<br>
版本冲突一般是在多个人修改一个文件造成的，但这种项目管理上的问题不应该指望由CVS来解决。<br>
<br>
确认修改写入到CVS库里<br>
cvs commit -m "write some comments here" file_name<br>
<br>
注意：CVS的很多动作都是通过cvs commit进行最后确认并修改的，最好每次只修改一个文件。在确认的前，还需要用户填写修改注释，以帮助其他开发人员了解修改的原因。如果不用写-m "comments"而直接确认`cvs commit file_name` 的话，cvs会自动调用系统缺省的文字编辑器(一般是vi)要求你写入注释。<br>
注释的质量很重要：所以不仅必须要写，而且必须写一些比较有意义的内容：以方便其他开发人员能够很好的理解<br>
不好的注释，很难让其他的开发人员快速的理解：比如： -m "bug fixed" 甚至 -m ""<br>
好的注释，甚至可以用中文: -m "在用户注册过程中加入了Email地址校验"<br>
<br>
修改某个版本注释：每次只确认一个文件到CVS库里是一个很好的习惯，但难免有时候忘了指定文件名，把多个文件以同样注释commit到CVS库里了，以下命令可以允许你修改某个文件某个版本的注释：<br>
cvs admin -m 1.3:"write some comments here" file_name<br>
<br>
添加文件<br>
创建好新文件后，比如：touch new_file<br>
cvs add new_file<br>
注意：对于图片，Word文档等非纯文本的项目，需要使用cvs add -b选项按2进制文件方式导入，否则有可能出现文件被破坏的情况<br>
比如：<br>
cvs add -b new_file.gif<br>
cvs add -b readme.doc<br>
<br>
然后确认修改并注释<br>
cvs ci -m "write some comments here"<br>
<br>
删除文件<br>
将某个源文件物理删除后，比如：rm file_name<br>
cvs rm file_name<br>
然后确认修改并注释<br>
cvs ci -m "write some comments here"<br>
以上面前2步合并的方法为：<br>
cvs rm -f file_name<br>
cvs ci -m "why delete file"<br>
注意：很多cvs命令都有缩写形式：commit=&gt;ci; update=&gt;up; checkout=&gt;co/get; remove=&gt;rm;<br>
<br>
添加目录<br>
cvs add dir_name<br>
<br>
查看修改历史<br>
cvs log file_name<br>
cvs history file_name<br>
<br>
查看当前文件不同版本的区别<br>
cvs diff -r1.3 -r1.5 file_name<br>
查看当前文件（可能已经修改了）和库中相应文件的区别<br>
cvs diff file_name<br>
cvs的web界面提供了更方便的定位文件修改和比较版本区别的方法，具体安装设置请看后面的cvsweb使用<br>
<br>
正确的通过CVS恢复旧版本的方法：<br>
如果用cvs update -r1.2 file.name<br>
这个命令是给file.name加一个STICK TAG： "1.2" ，虽然你的本意只是想将它恢复到1.2版本<br>
正确的恢复版本的方法是：cvs update -p -r1.2 file_name &gt;file_name<br>
如果不小心已经加成STICK TAG的话：用cvs update -A 解决<br>
<br>
移动文件/文件重命名<br>
cvs里没有cvs move或cvs rename，因为这两个操作是可以由先cvs remove old_file_name，然后cvs add new_file_name实现的。<br>
<br>
删除/移动目录<br>
最方便的方法是让管理员直接移动，删除CVSROOT里相应目录（因为CVS一个项目下的子目录都是独立的，移动到$CVSROOT目录下都可以作为新的独立项目：好比一颗树，其实砍下任意一枝都能独立存活），对目录进行了修改后，要求其开发人员重新导出项目cvs checkout project_name 或者用cvs update -dP同步。<br>
<br>
项目发布导出不带CVS目录的源文件<br>
做开发的时候你可能注意到了，每个开发目录下，CVS都创建了一个CVS/目录。里面有文件用于记录当前目录和CVS库之间的对应信息。但项目发布的时候你一般不希望把文件目录还带着含有CVS信息的CVS目录吧，这个一次性的导出过程使用cvs export命令，不过export只能针对一个TAG或者日期导出，比如：<br>
cvs export -r release1 project_name <br>
cvs export -D 20021023  project_name<br>
cvs export -D now project_name<br>
<br>
CVS Branch：项目多分支同步开发<br>
=============================<br>
<br>
确认版本里程碑：多个文件各自版本号不一样，项目到一定阶段，可以给所有文件统一指定一个阶段里程碑版本号，方便以后按照这个阶段里程碑版本号导出项目，同时也是项目的多个分支开发的基础。<br>
cvs tag release_1_0<br>
<br>
开始一个新的里程碑：<br>
cvs commit -r 2 标记所有文件开始进入2.x的开发<br>
<br>
注意：CVS里的revsion和软件包的发布版本可以没有直接的关系。但所有文件使用和发布版本一致的版本号比较有助于维护。<br>
<br>
版本分支的建立<br>
在开发项目的2.x版本的时候发现1.x有问题，但2.x又不敢用，则从先前标记的里程碑：release_1_0导出一个分支release_1_0_patch<br>
cvs rtag -b -r release_1_0 release_1_0_patch proj_dir<br>
<br>
一些人先在另外一个目录下导出release_1_0_patch这个分支：解决1.0中的紧急问题，<br>
cvs checkout -r release_1_0_patch<br>
而其他人员仍旧在项目的主干分支2.x上开发<br>
<br>
在release_1_0_patch上修正错误后，标记一个1.0的错误修正版本号<br>
cvs tag release_1_0_patch_1<br>
<br>
如果2.0认为这些错误修改在2.0里也需要，也可以在2.0的开发目录下合并release_1_0_patch_1中的修改到当前代码中：<br>
cvs update -j release_1_0_patch_1<br>
<br>
CVS的远程认证：通过SSH远程访问CVS<br>
================================<br>
<br>
使用cvs本身基于pserver的远程认证很麻烦,需要定义服务器和用户组，用户名，设置密码等，<br>
常见的登陆格式如下：<br>
cvs -d :pserver:[e-mail]:/path/to/cvsroot login<br>
例子：<br>
cvs -d :pserver:[e-mail]:/cvsroot login<br>
<br>
不是很安全，因此一般是作为匿名只读CVS访问的方式。从安全考虑，通过系统本地帐号认证并通过SSH传输是比较好的办法，通过在客户机的/etc/profile里设置一下内容：<br>
CVSROOT=:ext:$[e-mail]#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH<br>
所有客户机所有本地用户都可以映射到CVS服务器相应同名帐号了。<br>
<br>
比如:<br>
<br>
CVS服务器是192.168.0.3，上面CVSROOT路径是/home/cvsroot，另外一台开发客户机是192.168.0.4，如果tom在2台机器上都有同名的帐号，那么从192.168.0.4上设置了：<br>
export CVSROOT=:ext:tom@192.168.0.3:/home/cvsroot<br>
export CVS_RSH=ssh<br>
tom就可以直接在192.168.0.4上对192.168.0.3的cvsroot进行访问了（如果有权限的话）<br>
cvs checkout project_name<br>
cd project_name<br>
cvs update<br>
...<br>
cvs commit<br>
<br>
如果CVS所在服务器的SSH端口不在缺省的22，或者和客户端与CVS服务器端SSH缺省端口不一致，有时候设置了：<br>
:ext:$[e-mail]#port:/path/to/cvsroot <br>
<br>
仍然不行，比如有以下错误信息：<br>
ssh: test.server.address#port: Name or service not known<br>
cvs [checkout aborted]: end of file from server (consult above messages if any)<br>
<br>
解决的方法是做一个脚本指定端口转向（不能使用alias，会出找不到文件错误）：<br>
创建一个/usr/bin/ssh_cvs文件：<br>
#!/usr/bin/sh<br>
/path/to/ssh -p 34567 "$@"<br>
然后：chmod +x /usr/bin/ssh_cvs<br>
并CVS_RSH=ssh_cvs; export CVS_RSH<br>
<br>
注意：port是指相应服务器SSH的端口，不是cvs pserver的端口<br>
<br>
CVSWEB：提高文件浏览效率<br>
=======================<br>
<br>
CVSWEB就是CVS的WEB界面，可以大大提高程序员定位修改的效率:<br>
使用的样例可以看：http://www.freebsd.org/cgi/cvsweb.cgi<br>
<br>
CVSWEB的下载：CVSWEB从最初的版本已经演化出很多功能界面更丰富的版本，这个是我个人感觉安装设置比较方便的：<br>
http://www.spaghetti-code.de/software/linux/cvsweb/<br>
<br>
下载解包：<br>
tar zxf cvsweb.tgz<br>
把配置文件cvsweb.conf放到安全的地方（比如和apache的配置放在同一个目录下），<br>
修改：cvsweb.cgi让CGI找到配置文件：<br>
$config = $ENV{'CVSWEB_CONFIG'} || '/path/to/apache/conf/cvsweb.conf';<br>
<br>
转到/path/to/apache/conf下并修改cvsweb.conf：<br>
<br>
   1. 修改CVSROOT路径设置：<br>
      %CVSROOT = (<br>
      'Development' =&gt; '/path/to/cvsroot', #&lt;==修改指向本地的CVSROOT<br>
      );<br>
   2. 缺省不显示已经删除的文档：<br>
      "hideattic" =&gt; "1",#&lt;==缺省不显示已经删除的文档<br>
   3. 在配置文件cvsweb.conf中还可以定制页头的描述信息，你可以修改$long_intro成你需要的文字<br>
<br>
CVSWEB可不能随便开放给所有用户，因此需要使用WEB用户认证：<br>
先生成 passwd:<br>
/path/to/apache/bin/htpasswd -c cvsweb.passwd user<br>
<br>
修改httpd.conf: 增加<br>