/**
* 轉(zhuǎn)載請(qǐng)注明作者longdick http://longdick.javaeye.com
*
*/
SVN版本：1.5 及更新版本
名詞說(shuō)明：
WC：Working Copy 你的工作區(qū)
Versioned：受控的；受版本控制的
SVN是什么？
- SVN是開(kāi)源的版本控制系統(tǒng)。
- 比CVS更多的特性。一個(gè)更好的CVS？因此SVN具有大部分CVS擁有的特性。
- 不僅僅是文件受控，目錄也加入版本控制。
- 復(fù)制，刪除，重命名這些操作都是受控的。
- 特殊作用的元數(shù)據(jù)（屬性）。
- 提交事務(wù)原子性。提交完成之前任何一個(gè)部分都不會(huì)正真生效。版本號(hào)基于提交，而不是基于文件。提交時(shí)的log message也是依附于提交的那個(gè)版本。
- 創(chuàng)建分支和標(biāo)記非常簡(jiǎn)單。簡(jiǎn)單的通過(guò)copy命令就可以創(chuàng)建分支和標(biāo)記。
- 合并跟蹤。在合并時(shí)協(xié)助你處理所有的更改點(diǎn)。
- 文件鎖定。svn支持文件鎖定修改策略。
- Unix的link可以受控了。前提是WC必須在Unix下。
- 可選的Apache network server，基于WEBDAV/DeltaV 協(xié)議。熟悉Apache的管理員會(huì)很喜歡這一點(diǎn)。
- 內(nèi)置的server選擇（svnserve）。如果不想用Apache，可以試試Svn自己的server：svnserve。同樣也能提供授權(quán)和驗(yàn)證，ssh通道等功能。
- 方便解析的輸出。svn的輸出盡量做到方便閱讀和方便機(jī)器解析。
- 沖突解決交互性良好。svn命令行客戶端提供多種不同的方式解決沖突。
- svn提供一個(gè)實(shí)用工具，svnsync來(lái)實(shí)現(xiàn)從主庫(kù)到只讀附屬庫(kù)的同步。
- 持續(xù)寫入代理功能讓只讀的附屬庫(kù)專門處理所有的讀請(qǐng)求。所有的寫請(qǐng)求交給主庫(kù)處理。這個(gè)功能只在使用Apache WebDAV server的時(shí)候才有效。
- 基于本地化的客戶機(jī)服務(wù)器體系，分層的庫(kù)，明晰的API方便擴(kuò)展。
- 高效處理二進(jìn)制文件。
- 性能消耗與更改點(diǎn)的數(shù)量成正比。
- svn的api可以和多種語(yǔ)言集成。Python，Perl,Java,Ruby（svn本身是用C寫的）
- ChangeLists功能。
Svn的安裝分客戶端和服務(wù)端。
你可以在如下地址找到下載：http://subversion.tigris.org/
這篇文章主要介紹的是svn客戶端的命令，你至少需要安裝客戶端。默認(rèn)就是以SVN做版本控制的。如果你不想在自己機(jī)器上安裝服務(wù)版，google code是個(gè)練習(xí)svn命令的好地方。
http://code.google.com上申請(qǐng)托管項(xiàng)目很簡(jiǎn)單，但是現(xiàn)在不支持svn lock。目前最大支持1G空間。
以下是svn客戶端常用命令一覽：
svn add [path]
別名：無(wú)
描述：添加文件或目錄到你的wc，打上新增標(biāo)記。這些文件會(huì)在下一次你提交wc的時(shí)候提交到svn服務(wù)器。
在提交前，你也可以用svn revert撤銷新增的文件。
訪問(wèn)庫(kù)：否
eg: svn add file.cpp
svn blame Target[@REV]
別名：praise,annotate,ann
描述：顯示某個(gè)已受控文件的每一行的最后修改版本和作者
訪問(wèn)庫(kù)：是
eg: svn blame file.cpp
eg: svn blame --xml file.cpp ##加上x(chóng)ml參數(shù)可以以xml格式顯示每一行的屬性。
svn cat TARGET[@REV]
別名：無(wú)
描述：輸出指定目標(biāo)的內(nèi)容，這里的目標(biāo)一般是文件。
訪問(wèn)庫(kù)：是
eg:svn cat file.cpp
eg:svn cat file.cpp -r 2 ##顯示版本號(hào)為二的file.cpp內(nèi)容。
eg:svn cat file.cpp --revision HEAD ##顯示最新版本的file.cpp內(nèi)容。
svn changelist CLNAME TARGET...
svn changelist --remove TARGET
別名：cl
描述：可以將wc中的文件從邏輯上分組.
訪問(wèn)庫(kù)：否
eg:svn cl clName file.cpp file2.cpp file3.cpp ##將file.cpp等三個(gè)文件加入名叫clName的changelist
eg:svn commit --changelist clName -m "ci" ##將clName下的所有文件提交
svn checkout URL[@REV]... [PATH]
別名：co
描述：檢出
訪問(wèn)庫(kù)：否
eg:svn checkout file:///var/svn/repos/test file:///var/svn/repos/quiz working-copies
eg:svn checkout -r 2 file:///var/svn/repos/test mine ##check out 版本號(hào)為2的項(xiàng)目
svn cleanup [PATH...]
別名：無(wú)
描述：遞歸的清理WC中過(guò)期的鎖和未完成的操作。
訪問(wèn)庫(kù)：否
eg：svn cleanup
svn commit [PATH...]
別名：ci
描述：把你WC的更改提交到倉(cāng)庫(kù)
訪問(wèn)庫(kù)：是
eg：svn commit -m "added howto section." ##默認(rèn)情況下提交必須提供log message
svn copy SRC[@REV]... DST
別名：cp
描述:copy操作可以從WC到WC；WC到URL；URL到WC；URL到URL?，F(xiàn)在SVN只支持同一個(gè)倉(cāng)庫(kù)內(nèi)文件的拷貝，不允許跨倉(cāng)庫(kù)操作。
訪問(wèn)庫(kù)：是
eg：svn copy -r 11 file:///var/svn/repos/test/trunk \
file:///var/svn/repos/test/tags/0.6.32-prerelease \
-m "Forgot to tag at rev 11"
##copy命令是創(chuàng)建分支和標(biāo)記的常用方式。copy到url的操作隱含了提交動(dòng)作，所以需要提供log messages。
svn delete PATH...
別名：del，remove，rm
描述：刪除
訪問(wèn)庫(kù)：如果PATH是庫(kù)地址時(shí)會(huì)，刪除WC內(nèi)的文件不會(huì)。
eg：svn del localfile.cpp ##刪除WC里的文件，在下一次提交WC的時(shí)候才會(huì)真正在倉(cāng)庫(kù)里將對(duì)應(yīng)文件刪除。
eg: svn del file:///var/svn/repos/test/yourfile ##刪除倉(cāng)庫(kù)里的文件
svn diff
別名：di
描述：用來(lái)比較并顯示修改點(diǎn)。
訪問(wèn)庫(kù)：
eg：svn diff ##最常用的方式，用來(lái)顯示W(wǎng)C基于最近一次更新以后的所有的本地修改點(diǎn)。
eg：svn diff -r 301 bin ## 比較WC和版本301中的bin目錄的修改點(diǎn)
eg：svn diff -r 3000:3500 file:///var/svn/repos/myProject/trunk ##比較庫(kù)里主干3000版和3500版的差異。
eg：svn diff --summarize --xml
http://svn.red-bean.com/repos/test@r2 http://svn.red-bean.com/repos/test
##--summarize --xml 參數(shù)將差異情況以xml文檔的方式顯示出來(lái)。
svn export [-r REV] URL[@PEGREV] [PATH]
svn export [-r REV] PATH1[@PEGREV] [PATH2]
別名：無(wú)
描述：導(dǎo)出一個(gè)干凈的目錄樹(shù)，不包含所有的受控信息。可以選擇從URL或WC中導(dǎo)出。
訪問(wèn)庫(kù)：如果訪問(wèn)的是URL則會(huì)。
eg：svn export file:///var/svn/repos my-export ##導(dǎo)出到my-export目錄。
svn help — Help!
別名：?,h
描述：不用解釋了
訪問(wèn)庫(kù)：否。
svn import [PATH] URL
別名：無(wú)
描述：導(dǎo)入本地一個(gè)目錄到庫(kù)中。但是導(dǎo)入后，本地的目錄并不會(huì)處于受控狀態(tài)。
訪問(wèn)庫(kù)：是。
eg：svn import -m "New import" myproj http://svn.myProject.com/repos/trunk/misc
svn info [TARGET[@REV]...]
別名：無(wú)
描述：顯示指定WC和URL信息。
訪問(wèn)庫(kù)：僅當(dāng)訪問(wèn)的是庫(kù)路徑時(shí)。
eg：svn info --xml http://svn.myProject.com/repos/test ##將信息以xml格式顯示。
svn list [TARGET[@REV]...]
別名：ls
描述：顯示目標(biāo)下的文件和目錄列表。
訪問(wèn)庫(kù)：如果訪問(wèn)的是庫(kù)地址就會(huì)。
eg：svn list --verbose file:///var/svn/repos ##--verbose參數(shù)表示顯示詳細(xì)信息。
svn lock TARGET...
別名：無(wú)
描述：對(duì)目標(biāo)獲得修改鎖。如果目標(biāo)已被其他用戶鎖定，則會(huì)拋出警告信息。用--force參數(shù)強(qiáng)制從其他用戶那里獲得鎖。
訪問(wèn)庫(kù)：是
eg：svn lock --force tree.jpg
svn log [PATH]
svn log URL[@REV] [PATH...]
別名：無(wú)
描述：從庫(kù)中顯示log消息。log消息代碼 A ：added D：deleted M：modified R：replaced
訪問(wèn)庫(kù)：是
eg：svn log -v http://svn.myProject.com/repos/test/ foo.c bar.c ##詳細(xì)顯示指定URL的庫(kù)中foo.c和bar.c所有版本的log信息。
eg：svn log -r 14:15 ##顯示當(dāng)前WC的14和15版本log信息。
eg：##如果版本號(hào)不連續(xù)，只能采用如下方式。
$ svn log -r 14 > mylog
$ svn log -r 19 >> mylog
$ svn log -r 27 >> mylog
svn merge sourceURL1[@N] sourceURL2[@M] [WCPATH]
svn merge sourceWCPATH1@N sourceWCPATH2@M [WCPATH]
svn merge [[-c M]... | [-r N:M]...] [SOURCE[@REV] [WCPATH]]
別名：無(wú)
描述：合并兩個(gè)受控源的不同之處，存放到一個(gè)WC里。
訪問(wèn)庫(kù)：只有當(dāng)訪問(wèn)庫(kù)地址時(shí)。
eg：svn merge --reintegrate http://svn.example.com/repos/calc/branches/my-calc-branch ##合并分支上的改變項(xiàng)到WC，往往用于分支合并到主干。
eg：svn merge -r 156:157 http://svn.example.com/repos/calc/branches/my-calc-branch ##將制定URL版本156到157的所有更新合并到WC。
svn mkdir PATH...
svn mkdir URL...
別名：無(wú)
描述：在WC或庫(kù)路徑創(chuàng)建目錄
訪問(wèn)庫(kù)：只有當(dāng)訪問(wèn)庫(kù)地址時(shí)。
eg：svn mkdir newdir
svn move SRC... DST
別名：mv, rename, ren
描述：等同于svn copy命令跟個(gè)svn delete命令。WC到URL的重命名是不被允許的。
訪問(wèn)庫(kù)：只有當(dāng)訪問(wèn)庫(kù)地址時(shí)。
eg：svn move foo.c bar.c ##將foo.c改名成bar.c。
svn propdel PROPNAME [PATH...]
svn propdel PROPNAME --revprop -r REV [TARGET]
別名：pdel, pd
描述：從受控文件，目錄等刪除屬性。第二種是刪除某個(gè)指定版本上的附加屬性。
訪問(wèn)庫(kù)：只有當(dāng)訪問(wèn)庫(kù)地址時(shí)。
eg：svn propdel svn:mime-type someFile ##從someFile上移除svn:mime-type這個(gè)屬性。
svn propedit PROPNAME TARGET...
svn propedit PROPNAME --revprop -r REV [TARGET]
別名：pedit, pe
描述：編輯屬性
訪問(wèn)庫(kù)：只有當(dāng)訪問(wèn)庫(kù)地址時(shí)。
eg：svn propedit svn:keywords file.c ##修改file.c上的svn:keywords屬性。
svn propget PROPNAME [TARGET[@REV]...]
svn propget PROPNAME --revprop -r REV [URL]
別名：pget,pg
描述：從文件，目錄或版本取得指定屬性的值。
訪問(wèn)庫(kù)：只有當(dāng)訪問(wèn)庫(kù)地址時(shí)。
eg：svn propget svn:keywords file.c ##從file.c中取得svn:keywords屬性的值
svn proplist [TARGET[@REV]...]
svn proplist --revprop -r REV [TARGET]
別名：plist, pl
描述：列出文件、目錄或版本上的所有附加屬性
訪問(wèn)庫(kù)：只有當(dāng)訪問(wèn)庫(kù)地址時(shí)。
eg：svn proplist --verbose file.c
svn propset PROPNAME [PROPVAL | -F VALFILE] PATH...
svn propset PROPNAME --revprop -r REV [PROPVAL | -F VALFILE] [TARGET]
別名：pset,ps
描述：給文件、目錄或版本附加屬性并賦值
訪問(wèn)庫(kù)：只有當(dāng)訪問(wèn)庫(kù)地址時(shí)。
eg：svn propset svn:mime-type image/jpeg file.jpg ##給file.jpg附加屬性svn:mime-type 其值為image/jpeg
eg:svn propset --revprop -r 25 svn:log "Journaled about trip to New York."
##給版本25補(bǔ)上log message
eg:svn propset svn:ignore '.classpath' .
##在本地忽略掉.classpath文件
svn resolve PATH...
別名：無(wú)
描述：將沖突的文件標(biāo)記為已解決，并且刪掉沖突產(chǎn)生的臨時(shí)文件。注意這個(gè)命令并不是能把沖突解決，解決沖突還是得靠人工。
訪問(wèn)庫(kù)：否
eg：svn resolve --accept mine-full foo.c ##1.5版本后，加上--accept參數(shù)，嘗試自動(dòng)處理沖突。
svn resolved PATH...
別名：無(wú)
描述：已過(guò)時(shí)，被resolve --accept取代。去除沖突的狀態(tài)和沖突臨時(shí)文件。
訪問(wèn)庫(kù)：否
svn revert PATH...
別名：無(wú)
描述：還原WC中所有的本地更改。
訪問(wèn)庫(kù)：否
eg：svn revert --depth=infinity . ##將整個(gè)目錄所有文件還原
svn status [PATH...]
別名：stat, st
描述：輸出WC中文件和目錄的狀態(tài)。如果WC提交，這些狀態(tài)就會(huì)同步到庫(kù)里。
一般狀態(tài)有 ' ' 沒(méi)有修改
'A' 新增
'D' 刪除
'M' 修改
'R' 替代
'C' 沖突
'I' 忽略
'?' 未受控
'!' 丟失，一般是將受控文件直接刪除導(dǎo)致
訪問(wèn)庫(kù)：加上--show-updates參數(shù)時(shí)會(huì)
eg：svn status wc
svn switch URL[@PEGREV] [PATH]
svn switch --relocate FROM TO [PATH...]
別名：sw
描述：將WC轉(zhuǎn)向一個(gè)其他的庫(kù)地址同步
訪問(wèn)庫(kù)：是
eg：svn sw http://svn.myProject.com/repos/trunk/vendors . ##將當(dāng)前WC切換到另一個(gè)URL
svn unlock TARGET...
別名：無(wú)
描述：解鎖
訪問(wèn)庫(kù)：是
eg：svn unlock somefile
svn update [PATH...]
別名：up
描述：更新WC，更新反饋有如下幾種分類。
A 新增
B 鎖破壞
D 刪除
U 更新
C 沖突
G 合并
E 存在的
訪問(wèn)庫(kù)：是
eg：svn up -r22 ##更新到一個(gè)指定版本
ps:如何去除SVN中保存的用戶授權(quán)密碼
在Subversion安裝目錄下找到auth/svn.simple目錄，將下面的文件刪除即可。
如果在烏龜中，可以setting->saved data->Authentication Data 點(diǎn) clear 即可。
參考資料：http://svnbook.red-bean.com/en/1.5/svn.ref.svn.c.checkout.html