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