wincvs操作使用說(shuō)明

WINCVS用戶手冊(cè)編寫：相偉版本號(hào)：4黑龍江傲立信息產(chǎn)業(yè)有限企業(yè)

目錄TOC\o"1-3"\h\z1. 環(huán)境規(guī)定 22. wincvs界面與基本設(shè)置 23. 登錄CVS服務(wù)器 44. 導(dǎo)入文獻(xiàn)（Import）與檢出文獻(xiàn)（Checkout） 65. 同步（Update）--將服務(wù)端文獻(xiàn)更新到當(dāng)?shù)?156. 文獻(xiàn)提交修改(Commit) 177. 刪除文獻(xiàn) 188. 找回被刪除的文獻(xiàn) 199. 添加目錄到模塊中 1910. 刪除模塊中的目錄 2011. 標(biāo)簽(Tag)操作 2112. 分支(Branch)版本操作 2113. 查看文獻(xiàn)的狀態(tài) 2214. 需求要尤其注意的事項(xiàng) 2415. 創(chuàng)立分支的注意事項(xiàng) 24

CVS（ConcurrentVersionSystem）版本控制系統(tǒng)是一種GNU軟件包，重要用于在多人開發(fā)環(huán)境下的源碼的維護(hù)。實(shí)際上CVS可以維護(hù)任意文檔的開發(fā)和使用，例如共享文獻(xiàn)的編輯修改，而不僅僅局限于程序設(shè)計(jì)。CVS維護(hù)的文獻(xiàn)類型可以是文本類型也可以是二進(jìn)制類型。CVS用Copy-Modify-Merge（拷貝、修改、合并）變化表支持對(duì)文獻(xiàn)的同步訪問(wèn)和修改。它明確地將源文獻(xiàn)的存儲(chǔ)和顧客的工作空間獨(dú)立開來(lái)，并使其并行操作。CVS基于客戶端/服務(wù)器的行為使其可容納多種顧客，構(gòu)成網(wǎng)絡(luò)也很以便。這一特性使得CVS成為位于不一樣地點(diǎn)的人同步處理數(shù)據(jù)文獻(xiàn)（尤其是程序的源代碼）時(shí)的首選。所有重要的軟件項(xiàng)目都可以使用CVS作為其程序員之間的中心點(diǎn)，以便可以綜合各程序員的改善和更改。CVS的基本工作思緒是這樣的：在一臺(tái)服務(wù)器上建立一種源代碼庫(kù)，庫(kù)里可以寄存許多不一樣項(xiàng)目的源程序。由源代碼庫(kù)管理員統(tǒng)一管理這些源程序。每個(gè)顧客在使用源代碼庫(kù)之前，首先要把源代碼庫(kù)里的項(xiàng)目文獻(xiàn)下載到當(dāng)?shù)?，然后顧客可以在?dāng)?shù)厝我庑薷模罱K用winCVS的Commit(提交修改)功能進(jìn)行提交，由CVS源代碼庫(kù)統(tǒng)一管理修改。這樣，就好象只有一種人在修改文獻(xiàn)同樣，既防止了沖突，又可以做到跟蹤文獻(xiàn)變化等。下面將詳細(xì)闡明該系統(tǒng)的操作使用措施。環(huán)境規(guī)定CPU：P3-450以上、內(nèi)存>64M、8M以上顯卡、自由硬盤空間不小于2G。操作系統(tǒng)：Windows操作系統(tǒng)（pack2/pack3）。WNCVS：\\websrv\software\winCVS1.3.11\wincvs1.3.11.1beta11.exewincvs界面與基本設(shè)置安裝好wincvs后，啟動(dòng)該系統(tǒng)，可以看到如下圖的操作界面：目前需要進(jìn)行基本配置。配置環(huán)節(jié)如下：點(diǎn)擊菜單Admin->login，彈出的窗口如下所示:

Authenticatio：pserver（認(rèn)證方式，這里選擇的是PC機(jī)連接服務(wù)器）；Path：輸入CVS服務(wù)器上配置的途徑，即“數(shù)據(jù)庫(kù)根”；Hostaddress：輸入CVS服務(wù)器端的IP地址或主機(jī)名；Username：輸入自己在CVS服務(wù)器上的顧客名；選擇此窗口的Globals標(biāo)簽；注意"checkoutread-only"選項(xiàng)，表達(dá)“檢出時(shí)文獻(xiàn)只讀”（提議選中此項(xiàng)）。注意"prune（remove）emptydirectories"選項(xiàng)，表達(dá)“自動(dòng)刪掉空目錄”。

點(diǎn)擊【確定】按鈕，配置完畢。企業(yè)服務(wù)器數(shù)據(jù)庫(kù)根、CVS服務(wù)器IP及主機(jī)名由配置管理員告知。登錄CVS服務(wù)器配置完后，開始登陸CVS服務(wù)器端，登陸過(guò)程如下：點(diǎn)擊菜單Admin->login，彈出的窗口如下所示:

點(diǎn)擊【確定】按鈕，出現(xiàn)選擇當(dāng)?shù)毓ぷ髂夸洿翱冢ㄌ嶙h選擇一種空目錄）；例如選擇：“D:\CVS”選擇目錄之后，點(diǎn)擊【確定】按鈕，會(huì)彈出如下所示窗口：

輸入顧客口令之后，點(diǎn)擊【OK】按鈕，出現(xiàn)界面如下：

查看上圖所示紅色圈選部分，假如提醒為“cvsexitednormallywithcode0”接下來(lái)就是系統(tǒng)的詳細(xì)使用了，它的工作流程如下圖：圖中名詞定義：導(dǎo)入(Import):將當(dāng)?shù)卦脊ぷ髂夸浿械奈墨I(xiàn)或文獻(xiàn)夾導(dǎo)入到CVS的倉(cāng)庫(kù)中。檢出(Checkout):將自己或其他人員上傳到CVS倉(cāng)庫(kù)中的文獻(xiàn)或文獻(xiàn)夾下載到當(dāng)?shù)氐囊环N工作目錄中（服務(wù)器端已經(jīng)有對(duì)應(yīng)模塊）。提交(Commit):將當(dāng)?shù)刈魍晷薷暮蟮奈墨I(xiàn)提交到CVS的倉(cāng)庫(kù)中。同步(Update):將CVS倉(cāng)庫(kù)中最新的修改后文獻(xiàn)下載到當(dāng)?shù)毓ぷ髂夸浿小?dǎo)入文獻(xiàn)（Import）與檢出文獻(xiàn)（Checkout）將當(dāng)?shù)匚墨I(xiàn)導(dǎo)入到服務(wù)器端對(duì)應(yīng)的“數(shù)據(jù)庫(kù)根”中的模塊中。若服務(wù)器端沒(méi)有建立對(duì)應(yīng)的模塊，則需自己導(dǎo)入模塊；若服務(wù)器端己建立好模塊，則直接導(dǎo)入文獻(xiàn)即可。服務(wù)器端未建模塊時(shí)，操作環(huán)節(jié)如下：

如圖：選擇放置模塊（項(xiàng)目）的目錄，即當(dāng)?shù)毓ぷ髂夸?，如下圖選擇：“D:\CVS”為當(dāng)?shù)毓ぷ髂夸?

設(shè)置好當(dāng)?shù)毓ぷ髂夸浐?，首先在資源管理器中將要導(dǎo)入到服務(wù)器端的模塊及模塊下的文獻(xiàn)拷貝到當(dāng)?shù)毓ぷ髂夸浿?，回到CVS界面，如下圖所示:

選中模塊名，例如下圖中的“源代碼”，然后選擇菜單“Create->Importmodule...”選項(xiàng)，出現(xiàn)如下界面：

Wincvs會(huì)自動(dòng)檢測(cè)所添加的目錄中的文獻(xiàn)類型，提成兩類：binary和TEXT類，并祈求確認(rèn)點(diǎn)擊【Continue】按鈕，出現(xiàn)如下界面：

在“Enterthelogmessage”中輸入“注釋”信息，點(diǎn)擊【確定】按鈕看到如下圖所示提醒，顯示“CVSexitednormallywithcode0”，即操作成功，將當(dāng)?shù)匚墨I(xiàn)導(dǎo)入到服務(wù)端后，當(dāng)?shù)夭](méi)有跟服務(wù)端建立聯(lián)絡(luò)。如要建立聯(lián)絡(luò)，必須再將模塊從服務(wù)端檢出（checkout）才行服務(wù)器端己建好模塊時(shí)（企業(yè)服務(wù)器，配置管理員己建好對(duì)應(yīng)模塊），操作環(huán)節(jié)如下：

按如下圖所示紅色圈選的按鈕，選擇放置模塊（項(xiàng)目）的目錄，即當(dāng)?shù)毓ぷ髂夸?。下圖例中選擇了：“D:\CVS”作為當(dāng)?shù)氐墓ぷ髂夸洠?/p>

按此按鈕選擇當(dāng)?shù)毓ぷ髂夸淈c(diǎn)擊菜單Create－>checkoutmodule，輸入模塊名即可，例如：輸入模塊名為“源代碼”：

按此按鈕選擇當(dāng)?shù)毓ぷ髂夸洿藭r(shí)要注意，假如服務(wù)器端的模塊是空的，即模塊里沒(méi)有文獻(xiàn)（如初始配置管理員建立模塊時(shí)，模塊是空的），則必須在Globals標(biāo)簽上將"prune（remove）emptydirectories"選項(xiàng)去掉，如下圖所示：

點(diǎn)擊【確定】按鈕，即將服務(wù)器端的模塊下載到當(dāng)?shù)亓??？梢宰筮叀癕odules”中看到目前目錄中，下載的模塊名為“源代碼”的目錄，源代碼的文獻(xiàn)夾顯示前有黑色箭頭顯示，表明其是CVS模塊。

在資源管理器中將文獻(xiàn)拷入當(dāng)?shù)毓ぷ髂夸浿?，然后回到WINCVS操作界面，點(diǎn)右上角的刷新按鈕，可看到如下圖所示界面：

先選中文獻(xiàn)，然后點(diǎn)擊"添加按鈕"。出現(xiàn)如下圖所示界面：注意此處有三個(gè)按鈕，第一種添加一般的文獻(xiàn)；第二個(gè)添加二進(jìn)制文獻(xiàn)，如圖片文獻(xiàn)；第三個(gè)添加采用雙字節(jié)對(duì)字符進(jìn)行編碼的文獻(xiàn)。（除.txt文檔可以第一種按鈕外，其他均用第二個(gè)按紐，提議所有用第二個(gè)按鈕添加）

點(diǎn)擊【Ignore】按鈕，出現(xiàn)如下界面：

Commit（提交修改） 添加后的文獻(xiàn)顯示為紅色，其屬性“Rev”中顯示“0”，即文獻(xiàn)己添加到當(dāng)?shù)毓ぷ髂夸浿?，然后保持選中狀態(tài)，右鍵選擇“Commitselection...”則會(huì)出現(xiàn)如下所示界面：

在“Enterthelogmessage”中輸入注釋信息(這里一般輸入的是軟件在企業(yè)的版本號(hào))，點(diǎn)擊【確定】按鈕，則界面如下所示：

此時(shí)文獻(xiàn)己提交到服務(wù)器端，默認(rèn)版本號(hào)為“1.1”，即初始版本（注：初次提交文獻(xiàn)時(shí)，一定要有初始版本，即每個(gè)文獻(xiàn)都應(yīng)有1.1版本。）同步（Update） 同步的操作：使用鼠標(biāo)選擇一種目錄或者一種文獻(xiàn)，也可選擇多種，使用下面三種等效操作即可：1)菜單:Modify->Update2)快捷鍵：Ctrl+U3)點(diǎn)擊Update工具按鈕，如下圖所示點(diǎn)擊該選項(xiàng)后，出現(xiàn)下面界面使用后三項(xiàng)，更新服務(wù)器上最新版本的文獻(xiàn)，若要按rev版本（tag標(biāo)簽、branch分支）更新則使用輸入對(duì)應(yīng)版本號(hào)（標(biāo)簽、分支），則更新到當(dāng)?shù)氐奈墨I(xiàn)與輸入的版本相似，而不是服務(wù)器上的最新版本。好習(xí)慣“先同步后工作”。每次使用WinCvs開始工作前，應(yīng)當(dāng)先Update一次，這樣我們就能在文獻(xiàn)的最新版本上工作。Update與Checkout之間的區(qū)別Checkout是把CVS服務(wù)器上的module下載到當(dāng)?shù)剡M(jìn)行工作。Update重要同步當(dāng)?shù)匚墨I(xiàn)（目錄）和CVS服務(wù)器庫(kù)中對(duì)應(yīng)文獻(xiàn)（目錄）之間的差異，使當(dāng)?shù)貙?duì)應(yīng)文獻(xiàn)是最新版本，此外Update也能執(zhí)行獲取文獻(xiàn)舊版本的操作。同步（Update）--將服務(wù)端文獻(xiàn)更新到當(dāng)?shù)卦趯?duì)當(dāng)?shù)氐奈墨I(xiàn)修改前，最佳先從服務(wù)端更新文獻(xiàn)，由于多人操作同一種文獻(xiàn)時(shí)，沒(méi)有及時(shí)更新輕易引起沖突。如甲乙檢出的版本同為1.2，甲修改提交后的版本為1.3，乙此時(shí)沒(méi)有更新，在當(dāng)?shù)?.2的基礎(chǔ)上修改提交，CVS服務(wù)器此時(shí)不容許提交動(dòng)作。同步（Update）的操作措施如下：點(diǎn)擊選中文獻(xiàn)（可多選），從右鍵菜單中選擇“updateselection”。出現(xiàn)提醒窗口（如下圖）后直接點(diǎn)擊【確定】按鈕命令，即可將服務(wù)端的最新文獻(xiàn)更新到當(dāng)?shù)?。此措施只合用更新此時(shí)所在的分支上的版本。模塊級(jí)同步同步當(dāng)?shù)啬K時(shí)，可選中當(dāng)?shù)啬K，從右鍵菜單中選擇“updateselection”。出現(xiàn)提醒窗口（如上圖），選中后三項(xiàng)，點(diǎn)擊【確定】按鈕，則更新主干版本；若要更新分支版本，可繼續(xù)在“updateptions”標(biāo)簽頁(yè)中選中“Retrieverev/tag/bran”選項(xiàng)，輸入分支名稱，點(diǎn)擊【確定】按鈕即可。Updatesettings標(biāo)簽中選項(xiàng)的含義：Resetanystickydate/tag/’-k’options：不按當(dāng)?shù)啬K所在的分支進(jìn)行下載。假如不與“Updateoptions”標(biāo)簽中的“Retrieverev./tag/bran”輸入框進(jìn)行配合，下載的文獻(xiàn)會(huì)按當(dāng)?shù)啬K所在的分支進(jìn)行下載。Createmissiondirectoriesthatexistintherev：當(dāng)下Checkout到當(dāng)?shù)睾?，其他開發(fā)人員對(duì)此模塊又作了提交或刪除文獻(xiàn)的動(dòng)作，選擇此選項(xiàng)可下載這些錯(cuò)過(guò)的文獻(xiàn)。Updateoptions標(biāo)簽中選項(xiàng)的含義：Beforedate：準(zhǔn)時(shí)間更新文獻(xiàn)；Retrieverev./tag/bran：按版本、tag、分支號(hào)更新文獻(xiàn)；文獻(xiàn)提交修改(Commit)從服務(wù)端checkout項(xiàng)目后，會(huì)在當(dāng)?shù)亟⑽墨I(xiàn)的拷貝，在客戶端修改后提交（Commit）到服務(wù)端即可將最新的文獻(xiàn)保留到服務(wù)端，如下圖，修改后的文獻(xiàn)顯示為紅色。 此時(shí)的修改只修改了當(dāng)?shù)氐奈墨I(xiàn)，假如要提交到服務(wù)器端，點(diǎn)擊選中被修改正的文獻(xiàn)，從右鍵菜單中選擇“commitselection”命令即可提交到服務(wù)器。提交之后，文獻(xiàn)版本會(huì)自動(dòng)加1。也可在提交時(shí)強(qiáng)制提交后的版本號(hào)，原則是在本分支中，版本號(hào)要比提交前的版本要大?？蛇x擇要提交的模塊名稱，如上圖中選中“源代碼”模塊，從右鍵菜單中選擇“commitselection”命令，提交時(shí)的選項(xiàng)如下圖：此時(shí)可強(qiáng)制提高到1.5版本。在文檔沒(méi)有通過(guò)改動(dòng)的狀況下，也可使用此措施。注意：當(dāng)提交單個(gè)未經(jīng)變化的文檔時(shí)，有時(shí)需選中“Forcecommit”選項(xiàng)。刪除文獻(xiàn)選中文獻(xiàn)后，點(diǎn)擊刪除按鈕，或菜單命令：“Modify→Remove”,將文獻(xiàn)從當(dāng)?shù)貏h除。刪除后，從右鍵菜單中選擇"commiteselection"命令，才能將服務(wù)端的文獻(xiàn)刪除。

找回被刪除的文獻(xiàn)假如只是點(diǎn)擊刪除按鈕刪除文獻(xiàn)，則點(diǎn)擊添加按鈕即可將文獻(xiàn)找回。假如已執(zhí)行了提交操作，將文獻(xiàn)從服務(wù)端刪除，則應(yīng)在當(dāng)?shù)亟⒁环N同名的文獻(xiàn)（若為文本文檔，可為空），將文獻(xiàn)添加并提交到服務(wù)器端。此時(shí)，可以找到丟失的文獻(xiàn)，只不過(guò)會(huì)在本來(lái)被刪除版本的基礎(chǔ)上將當(dāng)?shù)氐膭?chuàng)立的文獻(xiàn)升級(jí)一種版本。文獻(xiàn)的歷史版本仍然存在。純文本文檔可實(shí)現(xiàn)歷史版本覆蓋目前版本，措施是合并（merge）。二進(jìn)制格式文檔實(shí)現(xiàn)歷史版本覆蓋目前版本，只能人為的增長(zhǎng)內(nèi)容之后，提交新版本。添加目錄到模塊中當(dāng)加入一種不包括文獻(xiàn)的空文獻(xiàn)夾時(shí)首先下載要將文獻(xiàn)夾添加入的模塊，見操作“4、檢出（checkout）文獻(xiàn)”，再把要添加的目錄加入當(dāng)?shù)谻VS工作目錄的此模塊文獻(xiàn)夾中（此操作在資源管理器中完畢）。例如添加了一種文獻(xiàn)夾NewFlod。選中此新加的文獻(xiàn)夾，點(diǎn)擊右上角的紅色“添加”按鈕，如下圖所示：最終進(jìn)行Commit（提交修改）操作即可。注意，此操作時(shí)在Perferences菜單中的Globals中“prune（remove）emptydirectories”選項(xiàng)為未選中狀態(tài)，否則提交動(dòng)作失敗。當(dāng)加入一種包括文獻(xiàn)的非空文獻(xiàn)夾時(shí)此項(xiàng)操作可以按上節(jié)的措施作，按上節(jié)的措施做時(shí)，首先應(yīng)當(dāng)加入目錄，然后添加文獻(xiàn)；也可參見“導(dǎo)入文獻(xiàn)”一節(jié)中的“服務(wù)器端未建模塊時(shí)”的操作，只是在添寫的模塊名稱變?yōu)橐峤坏摹澳K名稱”加上要添加的“目錄名稱”。如下圖：例如：我們準(zhǔn)備在“源程序”模塊中加入一種名為“NewF”的文獻(xiàn)夾，則可以按照導(dǎo)入模塊的措施加入。多作的工作只是執(zhí)行“Importmodule”命令后出的的提醒窗口（如下圖）中的模塊名稱中要寫成：要將文獻(xiàn)夾加入的“模塊名稱/要添加的文獻(xiàn)夾名”，即可。刪除模塊中的目錄先下載包括此目錄的文獻(xiàn)的模塊。首先，在當(dāng)?shù)谻VS工作目錄中刪除要?jiǎng)h除的文獻(xiàn)夾中的內(nèi)容，使之變成空目錄，然后在WinCvs中選中要?jiǎng)h除的文獻(xiàn)夾，在右鍵中選擇”CommitSelection”并在彈出的窗口中選擇“prune（remove）emptydirectories”選項(xiàng)，確認(rèn)即可。標(biāo)簽(Tag)操作在modify菜單下有"createatagonselection"條目，可給文獻(xiàn)創(chuàng)立tag。在create菜單下有"createatagbymodule"，可對(duì)模塊創(chuàng)立標(biāo)簽。創(chuàng)立分支跟tag同樣，也在modify和create菜單下，只不過(guò)條目不一樣而已。詳細(xì)環(huán)節(jié)如下：首先選中要為其創(chuàng)立標(biāo)簽的文獻(xiàn)或模塊名，在modify菜單下有"createatagonselection"條目，出現(xiàn)如下界面：在“Newtagname”中輸入標(biāo)簽名稱(建立規(guī)則為CS_0.0.0001即CS_+企業(yè)版本號(hào))，點(diǎn)擊【確定】按鈕，即創(chuàng)立標(biāo)簽成功；刪除標(biāo)簽時(shí)，首先選中己創(chuàng)立過(guò)標(biāo)簽的文獻(xiàn)或模塊，然后選擇modify菜單下有"deleteatag"。分支(Branch)版本操作Branch：分支是個(gè)很有用的概念，當(dāng)我們?cè)诒緛?lái)的版本基礎(chǔ)上需要?jiǎng)?chuàng)立此外一種版本（項(xiàng)目）時(shí)，可創(chuàng)立一種分支，分支跟主版本可獨(dú)立開發(fā)，又可以互相合并。如我們的雙廠項(xiàng)目跟富廠基本上相似，可直接在雙廠的基礎(chǔ)上創(chuàng)立一種分支v_ds。雙廠上有用的地方直接合并到富廠分支上。創(chuàng)立分支措施如下：首先選中要?jiǎng)?chuàng)立分支的文獻(xiàn)或模塊，選擇菜單“modify”中的“Createabranch”選項(xiàng)，出現(xiàn)如下界面：可在“Newbranch”中輸入分支標(biāo)識(shí)（建立規(guī)則為branch_jx即branch_+分支名），點(diǎn)擊【確定】按鈕。此時(shí)僅創(chuàng)立了分支版本，但并未在分支版本上工作，若要在分支版本上工作，則須將分支版本“checkout”到當(dāng)?shù)毓ぷ髂夸浿小Ｔ赾vs中，checkout或update某個(gè)tag或branch或revision是通過(guò)同一種界面選項(xiàng)，如下圖，紅色部分輸入所要下載模塊的tag號(hào)、branch標(biāo)簽或revision，點(diǎn)擊【確定】按鈕即可。查看文獻(xiàn)的狀態(tài)右鍵菜單中選擇"statusselection"可查看文獻(xiàn)的目前狀態(tài)，如下例其中，StickyTag項(xiàng)可表達(dá)此文獻(xiàn)所在的分支名稱，或不在分支上。下例就是不在分支而在主干上，由于StickyTag項(xiàng)為“none”。

===============================================================

File:test.txtStatus:Up-to-date

Workingrevision:1.4

Repositoryrevision:1.4/usr1/tt/test1/test.txt,v

StickyTag:(none)

StickyDate:(none)

StickyOptions:(none)

ExistingTags:

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)右鍵菜單中選擇"logselection"可查看文獻(xiàn)的歷史信息，包括修改者，修改時(shí)間等，如下例

===============================================================

Revision:1.4

Date:/1/162:14:25

Author:'lixin'

State:'Exp'

Li