Prayer

轉載說明 此轉載基于原作者最后更新于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：

1. 修改CVSROOT路徑設置：
   %CVSROOT = (
   'Development' => '/path/to/cvsroot', #<==修改指向本地的CVSROOT
   );
2. 缺省不顯示已經刪除的文檔：
   "hideattic" => "1",#<==缺省不顯示已經刪除的文檔
3. 在配置文件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