CVS RCS HOWTO 原始程式碼版本控制系統 (1)
2024-07-26 00:30:59
供稿:網友
作者:Al Dev (Alavoor Vasudevan) alavoor@yahoo.com
譯者:Cyril Huang cyril_huang@yahoo.com
v7.0, 20 Feb 2000 翻譯日期: 5 APRil 2000
--------------------------------------------------------------------------------
這份文件是一份 "實際操作的說明" ,以便於能使您很快的設定 CVS/RCS 原始程式碼控制系統。這份文件里也有一些將 CVS 上常用的混合命令包成可設定的 shell scripts 。這些 scripts 為 CVS 提供了一個簡單的使用者介面。這份文件的內容不僅能適用於 linux 系統也適用於其他像 Unix 的系統,例如Solaris, HPUX, AIX, SCO, Sinix, BSD, SCO 等等。
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
1. 簡介
原始碼控制系統是一個必須能管理那些在軟體計劃發展時原始碼所做的改變。軟體開發者需要一個完整的原始碼改變歷史紀錄,以便於在發生問題時,能夠追溯到以前穩定的版本。既然原始程式碼對於任何的軟體計劃與開發,都是花時間與金錢中最關鍵的部分,所以花時間藉由使用原始碼控制系統像 CVS 和 RCS 來安全的保護(safe-guarding)原始程式碼是非常重要的。
CVS (Concurrent Version Control System) 是一個能讓很多程式開發者同時做軟體開發的非常強大工具。它使用了RCS 的檔案規定格式但多了一層像應用程式介面的包裝,架在 RCS 的上層。
(譯注: RCS 是較老的版本控制,一個受 RCS 管制的檔案看起來是這樣子的 proj1.c,v ,CVS 沿用了一些 RCS 的規定。)
CVS 能夠紀錄你的檔案的歷史紀錄( 通常是原始程式碼,但是其他型態的檔案則不一定)。 CVS 只存了不同版本中檔案的差異,而不是你所建立的每個版本中的每個檔案。 CVS 也保持了一個何時,何人更改檔案,為什麼更改檔案等等不同觀點的歷史紀錄。
CVS 對於軟體的發行和多人同時更改目前原始碼的管理是非常的有幫助。他并不只是要對單一目錄下的檔案提供版本控制,相反的,CVS 更提供了多層有組織的目錄檔案的版本控制。在這個目錄下除了你的原始程式碼外,還包含有一個 CVS 所建立的改版控制目錄與檔案。
這些目錄與檔案最後被合并在一起形成一個軟體的發行。
CVS 能被使用在 "C", "C++", java, Perl, HTML 和其他檔案。
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
2. 那一種版本控制系統適合我? CVS 或 RCS
CVS 實際上是架在 RCS 之上的, CVS 只是一堆更強大能控制一個有完整原始程式碼階層目錄的工具。我們非常強烈的推薦您使用 CVS,因為您能夠很有彈性的用 perl , korn bash shell 等 scripts 語言設定您自己的 CVS 系統。請看一些 korn shell scripts 的□例 Shell Scripts 。
CVS 的優點
CVS 是非集中式的管理,使用者從儲存柜 (repository) 登出一個檔案目錄,并且有他自己的獨立的穩定目錄樹。
CVS 能夠在發行整個計劃的原始目錄樹中"蓋上印記" ("STAMP")。
CVS 能夠使大家同時修改檔案。
CVS 能夠用 shell scripts 或 perl 設定成檔案鎖住成單一使用或同時修改檔案模式。
CVS 的缺點
需要比 RCS 多一點的管理。
非常成熟復雜的系統,是目前應用上已有的最高技術。(感謝網友tsaipaw@mars.seed.net.tw來信指證我的錯誤)
有豐富的命令還有命令選項,因此對於初學者來說有很陡的學習曲線。簡單使用的 shell scripts 可在這里找到 Shell Scripts 。
RCS 的優點
RCS 非常容易設定。較少一些管理上的工作。
RCS 用在一個每個人在一起工作的集中區域。
RCS 對於簡單的系統很有用。
非常嚴謹的單一檔案修改模式 - 同步與同時是不允許的。
RCS 的缺失
由於使用單一目錄控制與檔案鎖住,不可能由很多的程式設計者做同時的開發。因為單一目錄下很多人對檔案的改變,會造成 make 的使用錯誤。
不能對整個軟體計劃戳上發行(releases)的印記。
這份文件也包含一些 shell scripts 以提供簡單的命令來作登出 (check-out), 登錄 (check-in), 送交(commit) 檔案的動作。請看一些 shell scripts 的□例 Shell Scripts 。
對於 RCS 而言,請看 Linux CD-ROM 里面的RCS mini-howto。
--------------------------------------------------------------------------------
cd /mnt/cdrom/Redhat/RPMS
ls -l howto-6.0-*.noarch.rpm
rpm -qpl howto-6* | grep -i rcs
--------------------------------------------------------------------------------
或者看 http://sunsite.unc.edu/LDP/HOWTO/mini/RCS-HOWTO.html
--------------------------------------------------------------------------------
--------------------------------------------------------------------------------
3. 設定 CVS
首先,你需要安裝 CVS 套件,在Redhat Linux 上請用
--------------------------------------------------------------------------------
cd /mnt/cdrom/Redhat/RPMS
rpm -i rcs*.rpm
rpm -i cvs*.rpm
To see the list of files installed do -
rpm -qpl cvs*.rpm | less
--------------------------------------------------------------------------------
然後用 j, k, CTRL+f, CTRL+D, CTRL+B, CTRL+U 或上下左右鍵, page up/down 瀏覽一下結果。請用 'man less' 查看 less 的用法
在其他的 unix 機器上,你可能需要下載 RCS CVS 的 tar.gz 檔案,然後根據 README, INSTALL 檔的指示來安裝 CVS。請到 http://www.cyclic.com 和 http://www.loria.fr/~molli/cvs-index.html
3.1 CVS 的專有環境變數
下列的環境變數需要在 /etc/profile 檔中設定,/etc/profile 是對所有使用者都有效的內定值設定檔,如果沒有設定 /etc/profile,那麼你應該加這些設定到你自己的設定檔 /.bash_profile 內。
--------------------------------------------------------------------------------
export EDITOR=/bin/vi
export CVSROOT=/home/cvsroot
export CVSREAD=yes
--------------------------------------------------------------------------------
建造一個目錄來存你原始程式碼的儲藏柜 (repository) 并且給予 unix group 與 user 讀寫的權力。 (譯注:這個目錄下將會有很多你將來的原始碼。)
--------------------------------------------------------------------------------
export CVSROOT=/home/cvsroot
mkdir $CVSROOT
chmod o-rwx $CVSROOT
chmod ug+rwx $CVSROOT
--------------------------------------------------------------------------------
要初始化你的 CVS ,并且從現在開始把你的原始程式碼交給 CVS 管理。請做 -
--------------------------------------------------------------------------------
cvs init
(譯注;這個初始化的動作在於建造一個儲藏柜,是一個目錄$CVSROOT/。
同時 $CVSROOT/CVSROOT 也在此時被建造,這個模組目錄下面是控制你CVS的administration files,
里面的檔案做一些修改後,可以使CVS更強大好用。
$CVSROOT 下的目錄每個都是 module 的意思,一個 module 可以就是一個專案計劃。
但也可能是你把一個計劃拆成很多 module ,不同 module 交給不同的 team 去發展。)
# 一定要換到想要 CVS 控制的計劃目錄下喔
cd $HOME/my_source_code_dir
# 把整個目錄納入管理用 import 命令
cvs import my_source_code_dir V1_0 R1_0
(譯注:其實是 cd 到你的project下後,cvs import 模組 vendor_tag release_tag,
不一定要是目錄名稱 my_source_code_dir,vendor_tag, release_tag 只是識別用的東西,
將來你可以用 tag 來存取你要的特定版本
這個動作會在 $CVSROOT/ 下開個" 模組 "的目錄,然後把 my_source_code_dir 整個放到 CVS 下管理,
$HOME/my_source_code_dir 就沒用了。import 的動作是把已經寫好的一堆 code 擺進來,
如果將來想新增檔案xxxx.c,必須先寫好xxxx.c,再用 cvs add xxxx.c)
--------------------------------------------------------------------------------
3.2 從 RCS 轉換到 CVS 系統
要轉換已經存在的 RCS 檔案到 CVS ,請使用下面的 script 。并確定你從你的 Linux CD-ROM 安裝了 korn shell 套件 pdksh*.rpm。
注意 : Korn shell /bin/ksh 在你從Linux CD-ROM 安裝 pdksh*.rpm 時就會產生
--------------------------------------------------------------------------------
#!/bin/ksh
#############################################################
# Program to Migrate the existing source code in RCS to CVS
#
# Needs the korn shell RPM package pdksh*.rpm from Linux
# contrib cdrom
#############################################################
#
# rcs2cvs - convert source tree from RCS to CVS
#
# project to convert
PROJECT='project'
# current RCS root
RCSROOT="$HOME/rcs"
if cd "$RCSROOT/$PROJECT"
then
cd "$RCSROOT"
else
echo >&2 "`basename "$0"`: can't change to RCS directory '$RCSROOT/$PROJECT'."
exit 1
fi
# current CVS root
CVSROOT="$HOME/cvs"
# create new CVS directory for project 'project'
if mkdir "$CVSROOT/$PROJECT"
then
:
else
echo >&2 "`basename "$0"`: can't create CVS directory '$CVSROOT/$PROJECT'."
exit 2
fi
# create CVS project tree from RCS tree
find "$PROJECT" -type d -name RCS -print |
while read RCS
do
CVS="`dirname "$RCS"`"
(if cd "$RCS"
then
# if find . -type f -name '*,v' -print | cpio -pdmv "$CVSROOT/$CVS"
if find . -type f -print | cpio -pdmv "$CVSROOT/$CVS"
then
:
else
echo >&2 "`basename "$0"`: can't convert RCS subdirectory '$RCSROOT/$RCS' to CVS subdirectory '$CVSROOT/$CVS'."
fi
else
echo >&2 "`basename "$0"`: can't change to RCS subdirectory '$RCSROOT/$RCS'."
fi)
done
--------------------------------------------------------------------------------
現在 RCS 已經被改成 CVS 系統下的 'project'. 你可以開始用CVS命令來存取 'project' 這個模組了.
--------------------------------------------------------------------------------