CVS的常 用命令速查 手冊
本文出自:http://www.linuxforum.net 作者:車東 chedong@bigfoot.com

CVS環境初始 化：CVS環 境的搭建
CVS的 日常使用：日常開發中最常用的CVS命令
CVS的分支開發：項目按照不同進度和目標并發進行
CVS的用戶認證：通過SSH的遠程用戶認證，安全，簡單
CVSWEB：CVS的WEB 訪問界面大大提高比較代碼修改的效率
CVS TAG：將$Id$加入代碼注釋中，方便開發過程的跟蹤

CVS環境初始化
===========

環境設置：
tcsh
setenv CVSROOT /path/to/cvsroot
bash
CVSROOT=/path/to/cvsroot ; export CVSROOT

初始化：
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"

注意：很多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

更方便的定位文件修改和比較版本區別的辦法請看后面的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 解決

刪除，移動目錄：
最方便的方法是直接移動，刪除CVSROOT里相應目錄：CVS所有項目都 是按目錄獨立的：
好比一顆樹，其實砍下任意一枝都能獨立存活，對目錄修改后，要求其開發人員
cvs checkout project_name 或者 cvs update -dP同步

CVS Branch：多分支同步開發
=========================

確認版本里程碑：多個文件各自版本號不一樣，項目到一定階段，可以給所有文件統一
指定一個階段里程碑版本號，方便以后按照 這個階段里程碑版本號導出項目，同時也是
項目的多個分支開發的基礎。
cvs tag release_1_0

在 開發proj的2.0版本的時候發現1.0有問題，但2.0又不敢用，則從release_1_0標記出
一個分支 release_1_0_patch
cvs rtag -b -r release_1_0 release_1_0_patch proj

一些人先在另外一個目錄下導出這個分支：解決1.0中的緊急問題，而其他人員2.0仍舊
在項目的主干上開發
cvs checkout -r release_1_0_patch

在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進行認證 是比較好的辦法，通過在profile里設置一
下內容：
CVSROOT=:ext:$USER@test.server.address#port:/path/to/cvsroot CVS_RSH=ssh; export CVSROOT CVS_RSH
所有用戶都可以獲得CVS服務器的

如果CVS所在服務器 的SSH端口不在缺省的22，或者和客戶端與服務器端SSH缺省端口
不一致，則創建一個ssh_cvs腳本，有時候設置了：
:ext:$USER@test.server.address#port:/path/to/cvsroot 仍然不行，比如有以下錯誤信息：
ssh: 133.133.33.33#3333: Name or service not known
cvs [checkout aborted]: end of file from server (consult above messages if any)

解決的方法是做一個標本指定端口轉向（不能使用alias，會出找不到文件錯誤）：
more ssh_cvs
#!/usr/bin/sh
ssh -p 34567 $*
然后：chmod +x /usr/bin/ssh_cvs
并CVS_RSH=ssh_cvs; export CVS_RSH

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.cgi
$config = $ENV{'CVSWEB_CONFIG'} || 'cvsweb.conf';

修改：cvsweb.conf
%CVSROOT = (
'Development' => '/path/to/cvsroot',
);
"hideattic" => "1",

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: 最后是誰，什么時間修改了文件
=====================================

將$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:
# Copyright (c) 2002 Company Name.
# $Id$

# file comments here

#!/usr/bin/perl -w
use strict;



相關資源：

CVS HOME：
http://www.cvshome.org

CVS FAQ：
http://www.loria.fr/~molli/cvs-index.html

相關網站:
http://directory.google.com/Top/Computers/Software/
Configuration_Management/Tools/Concurrent_Versions_System/

CVS 免費書:
http://cvsbook.red-bean.com/
CVS 速查卡片：
http://www.refcards.com/about/cvs.html