svn help

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 copy -m "1.7.2 - theme" svn://localhost/www/trunk svn://localhost/www/branches/branch1.7.2-theme

 

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   ##更新到一個指定版本