說明

　　本操作主要針對客戶端的使用者，因為linux高一點(diǎn)的版本自帶cvs的服務(wù)端，不詳細(xì)說明。如需要安裝服務(wù)端，可到http://www./ 去下載安裝。Windows NT版的server端可到 http://www./ 去下載安裝。

安裝步驟

　　1.安裝wincvs136.zip （http:///project/showfiles.php?group_id=10072）
　　2.安裝python-2.1.1.exe （ http:///ftp/python/2.1.1/Python-2.1.1.exe ）
　　3.安裝ActiveTcl8.3.4.1-9.win32-ix86.exe (http://www. )

英文版手冊

　　http://www./cn/cvs/docs/manual/

簡明目錄

　　1． 配置
　　2． 登錄
　　3． 檢出（checkout）項目--從服務(wù)端檢出
　　4． 修改提交文件到服務(wù)端
　　5． 更新文件--將服務(wù)端文件更新到本地
　　6． 添加文件
　　7． 刪除文件
　　8． 找回被刪除的文件
　　9． 合并不同分支（版本）的文件（merge）
　　10． 導(dǎo)入模塊(文件夾)--將本地文件夾添加到服務(wù)端
　　11． 創(chuàng)建標(biāo)簽、分支
　　12． 創(chuàng)建標(biāo)簽、分支
　　13． 查看文件的狀態(tài)

一、配置

　　安裝好cvs后，就需要配置服務(wù)端了。

　　從開始菜單中打開cvs，配置步驟如下：
　　1．點(diǎn)擊菜單Admin->preferences，在彈出的窗口中設(shè)置如下：

　　在 User name框中填入你們自己在linux上的用戶名

　　2．Globals標(biāo)簽上注意"checkout read-only"和 "prune（remove）empty directories"兩個選項，分別表示“檢出時文件只讀”和“自動刪掉空目錄”。

　　3．設(shè)置編輯器和存放口令的目錄（第一次登錄輸入口令保存后，下次登錄就不需要再輸入了）

二、登錄

　　配置完后，應(yīng)該登錄以使服務(wù)端記住你的登錄名和密碼。
　　點(diǎn)擊菜單Admin->preferences，輸入口令即可。登錄名和口令會存放在上圖你設(shè)置的HOME folder文件夾的.cvspass文件中，下次進(jìn)入不需要再輸入口令。

三、檢出（checkout）項目--從服務(wù)端檢出

　　如果在服務(wù)端，項目已建立，只需checkout到本地來即可
　　1． 如圖：選擇放置模塊（項目）的目錄

　　2． 點(diǎn)擊菜單Create－>checkout module，輸入模塊名即可。
　　注意此處不需要先建立模塊名，直接checkout

(作者:李芯)

四、修改提交文件

　　從服務(wù)端checkout項目后，會在本地建立文件的拷貝，在客戶端修改后提交（commit）到服務(wù)端即可將最新的文件保存到服務(wù)端如下圖，修改后的文件顯示為紅色。此時的修改只修改了本地的文件，如果要提交到服務(wù)器端，點(diǎn)擊選中被修改過的文件，從右鍵菜單中選擇"commit selection"命令即可提交到服務(wù)斷后，文件版本會自動加1。

五、更新文件--將服務(wù)端文件更新到本地

　　在對本地的文件修改前，最好先從服務(wù)端更新文件，因為多人操作同一個文件時，沒有及時更新容易引起沖突。如甲乙檢出的版本同為1.2，甲修改提交后的版本為1.3，乙此時沒有更新，在本地1.2的基礎(chǔ)上修改提交，此時就會有沖突如下圖，沖突的文件會顯示。

　　更新文件，點(diǎn)擊選中文件（可多選），從右鍵菜單中選擇"update selection"命令即可將服務(wù)端的最新文件更新到本地。

六、添加文件

　　在本地添加文件后，要提交到服務(wù)端。
　　先選中文件，然后點(diǎn)擊"添加按鈕"，添加文件后，再在右鍵菜單中選擇提交命令"commit selection"即可。注意此處有兩個按鈕，一個添加一般的文件；一個添加二進(jìn)制文件，如圖片文件。

七、刪除文件

　　1. 選中文件后，點(diǎn)擊刪除按鈕，將文件從本地刪除。
　　2. 刪除后，從右鍵菜單中選擇"commite selection"命令，才能將服務(wù)端的文件刪除。

八、找回被刪除的文件

　　如果只是點(diǎn)擊刪除按鈕刪除文件，則點(diǎn)擊添加按鈕即可將文件找回。

　　如果已提交到服務(wù)端，將文件從服務(wù)端刪除，則應(yīng)在本地建立一個同名的文件（可以為空文件），將文件添加提交到服務(wù)端，此時，可以找到丟失的文件，只不過會在原來被刪除版本的基礎(chǔ)上將本地的創(chuàng)建的文件升級一個版本。文件的歷史版本仍然存在。如果想要將歷史版本覆蓋當(dāng)前版本，最簡單的辦法是合并（merge） 。

九、合并不同分支（版本）的文件（merge）

　　在update文件時，第三個tab就是合并選項。也即合并文件是通過update來進(jìn)行的。如下，說明了幾種合并方式。

　　如上圖設(shè)置，將v_ds版本覆蓋另v_xj 。

　　如上圖設(shè)置，將v_ds版本與當(dāng)前版本比較合并，將only this reg./tag 中指定的版本與當(dāng)前版本進(jìn)行合并，通常會有沖突發(fā)生。例如
　　v_xj 為當(dāng)前版本，文件內(nèi)容為：
　　--xj
　　xj

　　v_ds文件內(nèi)容為：
　　ds before merge --ds
　　now it become the file of ds
　　I want to merge agagin

　　按上圖設(shè)置合并版本，會顯示文件沖突，打開文件如下：
　　<<<<<<< test.txt
　　--xj
　　xj

　　=======
　　ds before merge --ds
　　now it become the file of ds
　　I want to merge agagin
　　>>>>>>> 1.1.4.4
　　在這里，ds版本的文件比當(dāng)前的xj版多出了一行，在合并時不能一行行對應(yīng)合并，會顯示文件沖突（?quot;5．從服務(wù)端更新文件"一節(jié)中的顯示），將cvs添加的沖突標(biāo)識符去掉，修改文件為所需的樣子commit即可。

(作者:李芯)

十、導(dǎo)入模塊(文件夾)--將本地文件夾添加到服務(wù)端

　　1． 如圖，在cvs中選中要導(dǎo)入的文件夾。

　　2． 右鍵菜單中選擇"import module"，cvs檢查文件后，彈出如下窗口。輸入模塊及路徑，設(shè)置其他tab的屬性即可。

　　3． 將本地文件導(dǎo)入到服務(wù)斷后，本地并沒有跟服務(wù)端建立聯(lián)系，如要建立聯(lián)系，必須再將模塊從服務(wù)端檢出（checkout）才行。

　　如果文件夾里的文件比較少，可以直接采用添加的方式。先添加文件夾，再添加下面的文件，與添加文件方式一樣。

十一、創(chuàng)建標(biāo)簽、分支

　　在cvs有幾種概念容易混淆。

　　version ：一般我們所指的版本翻譯成英文應(yīng)該是這個詞。在cvs中，確用revision這個詞來代替這種說法，大概他們覺得正式版才能叫version，而我們平時不斷修改的版本只能叫revision。

　　tag：tag顧名思義就是做個標(biāo)簽，如張三的文件，他就可以做個標(biāo)簽為"張三"以表明是他的文件。Tag只是在文件上做了一個標(biāo)簽，并沒有創(chuàng)建不同的文件，這一點(diǎn)跟branch不同。。

　　Branch：分支是個很有用的概念，當(dāng)我們在原來的版本基礎(chǔ)上需要創(chuàng)建另外一個版本（項目）時，可創(chuàng)建一個分支，分支跟主版本可獨(dú)立開發(fā)，又可以相互合并。如我們的新疆項目跟德賽項目基本上相同，可直接在新疆的基礎(chǔ)上創(chuàng)建一個分支v_ds。新疆上有用的地方直接合并到德賽分支上。

　　一般是有個發(fā)布版v1.0，在開發(fā)v1.2的基礎(chǔ)上，同時又在修改v1.0，這時創(chuàng)建分支就也可以互相合并。

　　在cvs中，update某個tag或branch或revision是通過同一個界面選項，如下圖，只需要根據(jù)名稱來輸入即可。

十二、創(chuàng)建標(biāo)簽、分支

　　在modify菜單下有"create a tag onselection"條目，選中文件后，即可通過這個菜單給文件創(chuàng)建tag
在create菜單下有"create a tag by module"，可對模塊創(chuàng)建標(biāo)簽。創(chuàng)建分支跟tag一樣，也在modify和create菜單下，只不過條目不同而已，就不多解釋了。

十三、看文件的狀態(tài)

　　右鍵菜單中選擇"status selection"可查看文件的當(dāng)前狀態(tài)，如下例
　　===================================================================
　　File: test.txt Status: Up-to-date

　　Working revision: 1.4
　　Repository revision: 1.4 /usr1/tt/test1/test.txt,v
　　Sticky Tag: (none)
　　Sticky Date: (none)
　　Sticky Options: (none)

　　Existing Tags:
　　v_zs (revision: 1.3)
　　v_ds (branch: 1.1.4)
　　v_xj (branch: 1.1.2)
　　test (revision: 1.1)
　　V2 (branch: 1.0.4)
　　v1_2 (branch: 1.0.2)

　　右鍵菜單中選擇"log selection"可查看文件的歷史信息，包括修改者，修改時間等，如下例
　　----------------------------
　　Revision : 1.4
　　Date : 2002/1/16 2:14:25
　　Author : ‘lixin‘
　　State : ‘Exp‘
　　Lines : +1 -1
　　Description :
　　no message

　　----------------------------
　　Revision : 1.3
　　Date : 2002/1/16 2:1:59
　　Author : ‘lixin‘
　　State : ‘Exp‘
　　Lines : +4 0
　　Description :
　　no message