cvs server
===================
1. cvs -d /path/cvsroot init
2. groupadd cvs
3. chgrp -R cvs /path/cvsroot
4. chmod -R ug+rxw /path/cvsroot
5. edit /etc/groups, add cvs-user to cvs group ( cvs:::scott,may)
6. edit /etc/services,add following line:
cvspserver ... 2401
7. create /etc/xinetd.d/cvspserver, add following text:
service cvspserver
{
disable = no
flags = REUSE
protocal = tcp
socket_type = stream
wait = no
user = root
server = /usr/bin/cvs
server_args = --allow-root=/home/cvsroot pserver
}
8. service restart xinetd
cvs client setting
===================
1. vi .bash_profile,add CVSROOT varaible
CVSROOT=:pserver:user@host#2401:/server/path/cvsroot
2. cvs login
3. cvs import -m="test" project vendor release_version
4. cvs checkout project
CVS環(huán)境初始化
============
環(huán)境設(shè)置：指定CVS庫的路徑CVSROOT
tcsh
setenv CVSROOT /path/to/cvsroot
bash
CVSROOT=/path/to/cvsroot ; export CVSROOT
后面還提到遠(yuǎn)程CVS服務(wù)器的設(shè)置：
CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH
初始化：CVS版本庫的初始化。
cvs init
一個(gè)項(xiàng)目的首次導(dǎo)入
cvs import -m "write some comments here" project_name vendor_tag release_tag
執(zhí)行后：會(huì)將所有源文件及目錄導(dǎo)入到/path/to/cvsroot/project_name目錄下
vender_tag: 開發(fā)商標(biāo)記
release_tag: 版本發(fā)布標(biāo)記
項(xiàng)目導(dǎo)出：將代碼從CVS庫里導(dǎo)出
cvs checkout project_name
cvs 將創(chuàng)建project_name目錄，并將最新版本的源代碼導(dǎo)出到相應(yīng)目錄中。這個(gè)checkout和Virvual SourceSafe中的check out不是一個(gè)概念，相對于Virvual SourceSafe的check out是cvs update， check in是cvs commit。
CVS的日常使用
=============
注意：第一次導(dǎo)出以后，就不是通過cvs checkout來同步文件了，而是要進(jìn)入剛才cvs checkout project_name導(dǎo)出的project_name目錄下進(jìn)行具體文件的版本同步（添加，修改，刪除）操作。
將文件同步到最新的版本：
cvs update
不制定文件名，cvs將同步所有子目錄下的文件，也可以制定某個(gè)文件名/目錄進(jìn)行同步
cvs update file_name
最好每天開始工作前或?qū)⒆约旱墓ぷ鲗?dǎo)入到CVS庫里前都要做一次，并養(yǎng)成“先同步 后修改”的習(xí)慣，和Virvual SourceSafe不同，CVS里沒有文件鎖定的概念，所有的沖突是在commit之前解決，如果你修改過程中，有其他人修改并commit到了CVS庫中，CVS會(huì)通知你文件沖突，并自動(dòng)將沖突部分用
>>>>>>
content on cvs server
<<<<<<
content in your file
>>>>>>
標(biāo)記出來，由你確認(rèn)沖突內(nèi)容的取舍。
版本沖突一般是在多個(gè)人修改一個(gè)文件造成的，但這種項(xiàng)目管理上的問題不應(yīng)該指望由CVS來解決。
確認(rèn)修改寫入到CVS庫里：
cvs commit -m "write some comments here" file_name
注意：CVS的很多動(dòng)作都是通過cvs commit進(jìn)行最后確認(rèn)并修改的，最好每次只修改一個(gè)文件。在確認(rèn)的前，還需要用戶填寫修改注釋，以幫助其他開發(fā)人員了解修改的原因。如果不用寫-m "comments"而直接確認(rèn)`cvs commit file_name` 的話，cvs會(huì)自動(dòng)調(diào)用系統(tǒng)缺省的文字編輯器(一般是vi)要求你寫入注釋。
注釋的質(zhì)量很重要：所以不僅必須要寫，而且必須寫一些比較有意義的內(nèi)容：以方便其他開發(fā)人員能夠很好的理解
不好的注釋，很難讓其他的開發(fā)人員快速的理解：比如： -m "bug fixed" 甚至 -m ""
好的注釋，甚至可以用中文: -m "在用戶注冊過程中加入了Email地址校驗(yàn)"
修改某個(gè)版本注釋：每次只確認(rèn)一個(gè)文件到CVS庫里是一個(gè)很好的習(xí)慣，但難免有時(shí)候忘了指定文件名，把多個(gè)文件以同樣注釋commit到CVS庫里了，以下命令可以允許你修改某個(gè)文件某個(gè)版本的注釋：
cvs admin -m 1.3:"write some comments here" file_name
添加文件
創(chuàng)建好新文件后，比如：touch new_file
cvs add new_file
注意：對于圖片，Word文檔等非純文本的項(xiàng)目，需要使用cvs add -b選項(xiàng)，否則有可能出現(xiàn)文件被破壞的情況
比如：cvs add -kb new_file.gif
然后確認(rèn)修改并注釋
cvs ci -m "write some comments here"
刪除文件：
將某個(gè)源文件物理刪除后，比如：rm file_name
cvs rm file_name
然后確認(rèn)修改并注釋
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;
添加目錄：
cvs add dir_name
查看修改歷史：cvs log file_name
cvs history file_name
查看當(dāng)前文件不同版本的區(qū)別
cvs diff -r1.3 -r1.5 file_name
查看當(dāng)前文件（可能已經(jīng)修改了）和庫中相應(yīng)文件的區(qū)別
cvs diff file_name
cvs的web界面提供了更方便的定位文件修改和比較版本區(qū)別的方法，具體安裝設(shè)置請看后面的cvsweb使用
正確的通過CVS恢復(fù)舊版本的方法：
如果用cvs update -r1.2 file.name
這個(gè)命令是給file.name加一個(gè)STICK TAG： "1.2" ，雖然你的本意只是想將它恢復(fù)到1.2版本
正確的恢復(fù)版本的方法是：cvs update -p -r1.2 file_name >file_name
如果不小心已經(jīng)加成STICK TAG的話：用cvs update -A 解決
移動(dòng)文件：文件重命名
cvs里沒有cvs move或cvs rename，因?yàn)檫@兩個(gè)操作是先cvs remove old_file_name，然后cvs add new_file_name實(shí)現(xiàn)的。
刪除，移動(dòng)目錄：
最方便的方法是讓管理員直接移動(dòng)，刪除CVSROOT里相應(yīng)目錄（因?yàn)镃VS一個(gè)項(xiàng)目下的子目錄都是獨(dú)立的，移動(dòng)到$CVSROOT目錄下都可以作為新的獨(dú)立項(xiàng)目：好比一顆樹，其實(shí)砍下任意一枝都能獨(dú)立存活），對目錄進(jìn)行了修改后，要求其開發(fā)人員重新導(dǎo)出項(xiàng)目cvs checkout project_name 或者用cvs update -dP同步。
CVS Branch：項(xiàng)目多分支同步開發(fā)
=============================
確認(rèn)版本里程碑：多個(gè)文件各自版本號(hào)不一樣，項(xiàng)目到一定階段，可以給所有文件統(tǒng)一指定一個(gè)階段里程碑版本號(hào)，方便以后按照這個(gè)階段里程碑版本號(hào)導(dǎo)出項(xiàng)目，同時(shí)也是項(xiàng)目的多個(gè)分支開發(fā)的基礎(chǔ)。
cvs tag release_1_0
開始一個(gè)新的里程碑：
cvs commit -r 2 標(biāo)記所有文件開始進(jìn)入2.x的開發(fā)
注意：CVS里的revsion和軟件包的發(fā)布版本可以沒有直接的關(guān)系。但所有文件使用和發(fā)布版本一致的版本號(hào)比較有助于維護(hù)。
在開發(fā)項(xiàng)目的2.x版本的時(shí)候發(fā)現(xiàn)1.x有問題，但2.x又不敢用，則從先前標(biāo)記的里程碑：release_1_0導(dǎo)出一個(gè)分支release_1_0_patch
cvs rtag -b -r release_1_0 release_1_0_patch proj_dir
一些人先在另外一個(gè)目錄下導(dǎo)出release_1_0_patch這個(gè)分支：解決1.0中的緊急問題，
cvs checkout -r release_1_0_patch
而其他人員仍舊在項(xiàng)目的主干分支2.x上開發(fā)
在release_1_0_patch上修正錯(cuò)誤后，標(biāo)記一個(gè)1.0的錯(cuò)誤修正版本號(hào)
cvs tag release_1_0_patch_1
如果2.0認(rèn)為這些錯(cuò)誤修改在2.0里也需要，也可以在2.0的開發(fā)目錄下合并release_1_0_patch_1中的修改到當(dāng)前代碼中：
cvs update -j release_1_0_patch_1
CVS的遠(yuǎn)程認(rèn)證：通過SSH遠(yuǎn)程訪問CVS
================================
使用cvs本身的遠(yuǎn)程認(rèn)證很麻煩,需要定義服務(wù)器和用戶組，用戶名，設(shè)置密碼等，而且不安全，因此和系統(tǒng)本地帳號(hào)認(rèn)證并通過SSH傳輸是比較好的辦法，通過在客戶機(jī)的/etc/profile里設(shè)置一下內(nèi)容：
CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH
所有客戶機(jī)所有本地用戶都可以映射到CVS服務(wù)器相應(yīng)同名帳號(hào)了。
如果CVS所在服務(wù)器的SSH端口不在缺省的22，或者和客戶端與CVS服務(wù)器端SSH缺省端口不一致，有時(shí)候設(shè)置了：
:ext:$USER@test.server.address#port:/path/to/cvsroot
仍然不行，比如有以下錯(cuò)誤信息：
ssh: test.server.address#port: Name or service not known
cvs [checkout aborted]: end of file from server (consult above messages if any)
解決的方法是做一個(gè)腳本指定端口轉(zhuǎn)向（不能使用alias，會(huì)出找不到文件錯(cuò)誤）：
創(chuàng)建一個(gè)/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是指相應(yīng)服務(wù)器SSH的端口，不是cvs pserver的端口
CVSWEB：提高程序員比較文件修改效率
================================
CVSWEB就是CVS的WEB界面，可以大大提高程序員定位修改的效率:
使用的樣例可以看：http://www.freebsd.org/cgi/cvsweb.cgi
CVSWEB的下載：CVSWEB從最初的版本已經(jīng)演化出很多功能界面更豐富的版本，這個(gè)是個(gè)人感覺覺得安裝設(shè)置比較方便的：
http://www.spaghetti-code.de/software/linux/cvsweb/
下載解包：
tar zxf cvsweb.tgz
把配置文件cvsweb.conf放到安全的地方（比如和apache的配置放在同一個(gè)目錄下），
修改：cvsweb.cgi讓CGI找到配置文件：
$config = $ENV{'CVSWEB_CONFIG'} || '/path/to/apache/conf/cvsweb.conf';
轉(zhuǎn)到/path/to/apache/conf下并修改cvsweb.conf：
1. 修改CVSROOT路徑設(shè)置：
%CVSROOT = (
'Development' => '/path/to/cvsroot', #<==修改指向本地的CVSROOT
);
2. 缺省不顯示已經(jīng)刪除的文檔：
"hideattic" => "1",#<==缺省不顯示已經(jīng)刪除的文檔
3. 在配置文件cvsweb.conf中還可以定制頁頭的描述信息，你可以修改$long_intro成你需要的文字
CVSWEB可不能隨便開放給所有用戶，因此需要使用WEB用戶認(rèn)證：
先生成 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$ 加在程序文件開頭的注釋里是一個(gè)很好的習(xí)慣，cvs能夠自動(dòng)解釋更新其中的內(nèi)容成：file_name version time user_name 的格式，比如：cvs_card.txt,v 1.1 2002/04/05 04:24:12 chedong Exp，可以這些信息了解文件的最后修改人和修改時(shí)間
幾個(gè)常用的缺省文件：
default.php
<?php
/*
* Copyright (c) 2002 Company Name.
* $Header$
*/
?>
====================================
Default.java: 注意文件頭一般注釋用 /* 開始 JAVADOC注釋用 /** 開始的區(qū)別
/*
* Copyright (c) 2002 Company Name.
* $Header$
*/
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.
# $Header$
# file comments here
use strict;
CVS vs VSS
===========
CVS沒有文件鎖定模式，VSS在check out同時(shí)，同時(shí)記錄了文件被導(dǎo)出者鎖定。
CVS是update commit， VSS是check out check in
在CVS中，標(biāo)記自動(dòng)更新功能缺省是打開的，這樣也帶來一個(gè)潛在的問題，就是不用-kb方式添加binary文件的話在cvs自動(dòng)更新時(shí)可能會(huì)導(dǎo)致文件失效。
Virsual SourceSafe中這個(gè)功能稱之為Keyword Explaination，缺省是關(guān)閉的，需要通過OPITION打開，并指定需要進(jìn)行源文件關(guān)鍵詞掃描的類型：*.txt,*.java,*.html...
對于Virsual SourceSafe和CVS都通用的TAG有：
$Header$
$Author$
$Date$
$Revision$
盡量使用通用的關(guān)鍵詞保證代碼在CVS和VSS都能方便的跟蹤。