cvs常用命令

cvs常用命令
登陸：cvs -d :pserver:[email protected]:/home1/cvsroot/it login
導出項目：cvs checkout -d product proudct_local
添加文件：cvs add filename
提交文件：cvs commit filename


刪除文件：cvs remove -f filename
確認刪除文件：cvs commit -m "why delete file"


重命名文件：cvs move cvs rename
確認重命名文件 cvs commit


添加目錄cvs add dirname
確認添加目錄：cvs commit


查看修改該歷史： cvs log filename


一個項目的首次導入
cvs import -m "write some comments here" project_name vendor_tag release_tag
執行後：會將所有源文件及目錄導入到/path/to/cvsroot/project_name目錄下
vender_tag: 開發商標記
release_tag: 版本發佈標記


項目導出：將代碼從CVS庫裏導出
cvs checkout project_name
cvs 將創建project_name目錄，並將最新版本的源代碼導出到相應目錄中。這個checkout和Virvual SourceSafe中的check out不是一個概念，相對於Virvual SourceSafe的check out是cvs update， check in是cvs commit。


CVS的日常使用


注意：第一次導出以後，就不是通過cvs checkout來同步文件了，而是要進入剛纔cvs checkout project_name導出的project_name目錄下進行具體文件的版本同步（添加，修改，刪除）操作。


將文件同步到最新的版本
cvs update
不制定文件名，cvs將同步所有子目錄下的文件，也可以制定某個文件名/目錄進行同步
cvs update file_name
最好每天開始工作前或將自己的工作導入到CVS庫裏前都要做一次，並養成“先同步 後修改”的習慣，和Virvual SourceSafe不同，CVS裏沒有文件鎖定的概念，所有的衝突是在commit之前解決，如果你修改過程中，有其他人修改並commit到了CVS 庫中，CVS會通知你文件衝突，並自動將衝突部分用
>>>>>>
content on cvs server
<<<<<<
content in your file
>>>>>>
標記出來，由你確認衝突內容的取捨。
版本衝突一般是在多個人修改一個文件造成的，但這種項目管理上的問題不應該指望由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庫裏是一個很好的習慣，但難免有時候忘了指定文件名，把多個文件以同樣註釋commit到CVS庫裏了，以下命令可以允許你修改某個文件某個版本的註釋：
cvs admin -m 1.3:"write some comments here" file_name


添加文件
創建好新文件後，比如：touch new_file
cvs add new_file
注意：對於圖片，Word文檔等非純文本的項目，需要使用cvs add -kb選項按2進制文件方式導入(k表示擴展選項，b表示binary)，否則有可能出現文件被破壞的情況
比如：
cvs add -kb new_file.gif
cvs add -kb readme.doc


如果關鍵詞替換屬性在首次導入時設置錯了怎麼辦？
cvs admin -kkv new_file.css


然後確認修改並註釋
cvs ci -m "write some comments here"


刪除文件
將某個源文件物理刪除後，比如：rm file_name
cvs rm file_name
然後確認修改並註釋
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/get; remove=>rm;


添加目錄
cvs add dir_name


查看修改歷史
cvs log file_name
cvs history file_name


查看當前文件不同版本的區別
cvs diff -r1.3 -r1.5 file_name
查看當前文件（可能已經修改了）和庫中相應文件的區別
cvs diff file_name
cvs的web界面提供了更方便的定位文件修改和比較版本區別的方法，具體安裝設置請看後面的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 解決


移動文件/文件重命名
cvs裏沒有cvs move或cvs rename，因爲這兩個操作是可以由先cvs remove old_file_name，然後cvs add new_file_name實現的。


刪除/移動目錄
最方便的方法是讓管理員直接移動，刪除CVSROOT裏相應目錄（因爲CVS一個項目下的子目錄都是獨立的，移動到$CVSROOT目錄下都可以作爲新的獨立項目：好比一顆樹，其實砍下任意一枝都能獨立存活），對目錄進行了修改後，要求其開發人員重新導出項目cvs checkout project_name 或者用cvs update -dP同步。


項目發佈導出不帶CVS目錄的源文件
做開發的時候你可能注意到了，每個開發目錄下，CVS都創建了一個CVS/目錄。裏面有文件用於記錄當前目錄和CVS庫之間的對應信息。但項目發佈的時候你一般不希望把文件目錄還帶着含有CVS信息的CVS目錄吧，這個一次性的導出過程使用cvs export命令，不過export只能針對一個TAG或者日期導出，比如：
cvs export -r release1 project_name
cvs export -D 20021023 project_name
cvs export -D now project_name
CVS Branch：項目多分支同步開發
確認版本里程碑：多個文件各自版本號不一樣，項目到一定階段，可以給所有文件統一指定一個階段里程碑版本號，方便以後按照這個階段里程碑版本號導出項目，同時也是項目的多個分支開發的基礎。


cvs tag release_1_0


開始一個新的里程碑：
cvs commit -r 2 標記所有文件開始進入2.x的開發


注意：CVS裏的revsion和軟件包的發佈版本可以沒有直接的關係。但所有文件使用和發佈版本一致的版本號比較有助於維護。


版本分支的建立
在開發項目的2.x版本的時候發現1.x有問題，但2.x又不敢用，則從先前標記的里程碑：release_1_0導出一個分支 release_1_0_patch
cvs rtag -b -r release_1_0 release_1_0_patch proj_dir


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


在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