SVN 指令參考(svn command reference)
用法: svn <subcommand> [options] [args]
Subversion 指令行用戶端,版本 1.6.17。
使用"svn help <subcommand>" 顯示子指令的幫助資訊。
使用"svn --version"檢視程式的版本号和版本庫通路子產品,或者
使用"svn --version --quiet"隻檢視程式的版本号。
大多數的子指令可接受檔案或目錄參數,對目錄進行遞歸處理。
如果沒有指定參數,預設對目前目錄(包含目前目錄)遞歸處理。
Subversion 是版本控制工具。
欲取得詳細資料,請參閱 http://subversion.tigris.org/
版本 1.6.17 (r1128011) 編譯于 Jun 2 2011,23:35:08
注:此文檔由 Y.Boy 整理。
可用的子指令:
- add
- blame (praise, annotate, ann)
- cat
- changelist (cl)
- checkout (co)
- cleanup
- commit (ci)
- copy (cp)
- delete (del, remove, rm)
- diff (di)
- export
- help (?, h)
- import
- info
- list (ls)
- lock
- log
- merge
- mergeinfo
- mkdir
- move (mv, rename, ren)
- propdel (pdel, pd)
- propedit (pedit, pe)
- propget (pget, pg)
- proplist (plist, pl)
- propset (pset, ps)
- resolve
- resolved
- revert
- status (stat, st)
- switch (sw)
- unlock
- update (up)
add: 把檔案和目錄納入版本控制,通過排程加到版本庫。它們會在下一次送出時加入。
用法: add 路徑...
有效選項:
--targets ARG : 傳遞檔案 ARG 内容為附件參數
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--force : 強制操作運作
--no-ignore : 忽略預設值和 svn:ignore 屬性
--auto-props : 啟用自動屬性
--no-auto-props : 關閉自動屬性
--parents : 增加中間父目錄
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
blame (praise, annotate, ann): 輸出指定檔案或URL的追溯内容,包含版本和作者資訊。
用法: blame 目标[@版本]...
如果指定了版本,将從指定的版本開始查找。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-v [--verbose] : 列印附加資訊
-g [--use-merge-history] : 從合并曆史使用/顯示額外資訊
--incremental : 給予适合串聯的輸出
--xml : 輸出為 XML
-x [--extensions] ARG : 預設: "-u"。當 Subversion 調用外部比較程式時,ARG 直接傳給它。但是當
Subversion 使用預設的内置比較實作,或者正
顯示追溯時, ARG 可以是:
-u (--unified):
輸出三行統一上下文。
-b (--ignore-space-change):
忽略空白數量的修改。
-w (--ignore-all-space):
忽略所有的空白。
--ignore-eol-style:
忽略行尾樣式的改變。 -p (--show-c-function):
在比較輸出中顯示 C 函數名稱。
--force : 強制操作運作
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
cat: 輸出指定檔案或URL的内容。
用法: cat 目标[@版本]...
如果指定了版本,将從指定的版本開始查找。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
changelist (cl): 耦合(或解耦)檔案與修改清單 CLNAME。
使用: 1. changelist CLNAME TARGET...
2. changelist --remove TARGET...
有效選項:
-q [--quiet] : 不列印資訊,或隻列印概要資訊
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--remove : 删除修改清單耦合
--targets ARG : 傳遞檔案 ARG 内容為附件參數
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
checkout (co): 從版本庫簽出工作副本。
使用: checkout URL[@REV]... [PATH]
如果指定 REV,那麼它确定了從 URL 首先查找的版本。
如果省略路徑參數,則 URL 最末尾的目錄名作為目标目錄名。如果指定多個 URL,
則依次将其簽出到 PATH 的子目錄中,子目錄名就是 URL 最末尾的目錄名。
如果使用了 "--force" 選項,在工作副本中未版本控制的障礙路徑,不會自動導
緻簽出失敗。 如果障礙路徑與版本庫中的對應路徑類型相同(檔案或目錄),它将成
為受版本控制的路徑,但是内容不改變。它意味着障礙路徑的孩子,如果也是障礙路
徑,那麼也會受版本控制。對于障礙路徑中的檔案,如果與版本庫内的不同,将視為工
作副本發生本地修改。版本庫中的所有屬性都應用于障礙路徑。
參見 "svn help update" 以擷取報告執行動作的字元清單。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-q [--quiet] : 不列印資訊,或隻列印概要資訊
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--force : 強制操作運作
--ignore-externals : 忽略外部項目
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
cleanup: 遞歸清理工作副本,删除鎖,繼續未完成操作,等等。
用法: cleanup [路徑...]
有效選項:
--diff3-cmd ARG : 使用 ARG 作為合并指令
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
commit (ci): 把工作副本的修改送出到版本庫。
用法: commit [路徑...]
必須提供日志消息,但它可以是空的。如果沒有指定 --message 或 --file
選項,編輯器會被啟動。如果有目标是鎖定的或者包含鎖定條目,則在成功
送出後會被解鎖。
有效選項:
-q [--quiet] : 不列印資訊,或隻列印概要資訊
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--targets ARG : 傳遞檔案 ARG 内容為附件參數
--no-unlock : 不要解鎖目标
-m [--message] ARG : 指定日志資訊ARG
-F [--file] ARG : 從檔案ARG讀取日志資訊
--force-log : 強制校驗日志資訊資源
--editor-cmd ARG : 使用 ARG 作為外部編輯器
--encoding ARG : 将ARG的值視為字元編碼
--with-revprop ARG : 在新版本設定版本屬性 ARG
使用格式 name[=value]
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
--keep-changelists : 不要在送出後删除修改清單
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
copy (cp): 在工作副本或版本庫中複制資料,保留曆史。
用法: copy SRC[@REV]... DST
當複制多個源時,它們作為 DST 的子節點增加, DST 必須是目錄。
SRC 和 DST 可以是工作副本路徑(WC)或版本庫位址(URL):
WC -> WC: 複制和排程增加(包含曆史)
WC -> URL: 立即送出工作副本到版本庫
URL -> WC: 檢出 URL 到工作副本,排程增加
URL -> URL: 完全伺服器端複制;一般用于分支和标簽
所有 SRC 必須是同一類型。
警告:為了與舊版本的 Subversion 相容,使用兩個工作副本複制(WC -> WC)的
操作不會與版本庫通信。同樣地,在預設情況下,不能從複制源到目的地傳播合
并跟蹤資訊。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--ignore-externals : 忽略外部項目
--parents : 建立中間目錄
-m [--message] ARG : 指定日志資訊ARG
-F [--file] ARG : 從檔案ARG讀取日志資訊
--force-log : 強制校驗日志資訊資源
--editor-cmd ARG : 使用 ARG 作為外部編輯器
--encoding ARG : 将ARG的值視為字元編碼
--with-revprop ARG : 在新版本設定版本屬性 ARG
使用格式 name[=value]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
delete (del, remove, rm): 從版本庫中删除檔案和目錄。
用法: 1、delete PATH...
2、delete URL...
1、每個 PATH 指定的項目會被排程到下次送出時從版本庫删除。除非給出
--keep-local 參數,工作副本中沒有送出的檔案和目錄會被立即删除。
如果 PATH 是未版本控制或者已修改的項目,或者包含這些項目,那麼僅當
給出 --force 參數時這些項目才會被删除。
2、每個 URL 指定的項目會通過立即送出從版本庫中删除。
有效選項:
--force : 強制操作運作
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--targets ARG : 傳遞檔案 ARG 内容為附件參數
-m [--message] ARG : 指定日志資訊ARG
-F [--file] ARG : 從檔案ARG讀取日志資訊
--force-log : 強制校驗日志資訊資源
--editor-cmd ARG : 使用 ARG 作為外部編輯器
--encoding ARG : 将ARG的值視為字元編碼
--with-revprop ARG : 在新版本設定版本屬性 ARG
使用格式 name[=value]
--keep-local : 在工作副本中保留路徑
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
diff (di): 顯示兩個版本或路徑的差異。
用法: 1. diff [-c M | -r N[:M]] [TARGET[@REV]...]
2. diff [-r N[:M]] --old=OLD-TGT[@OLDREV] [--new=NEW-TGT[@NEWREV]] \
[PATH...]
3. diff OLD-URL[@OLDREV] NEW-URL[@NEWREV]
1、顯示版本 REV 中 TARGET 在兩個不同的版本之間的差異。TARGET 要麼全是
工作副本路徑,要麼全是 URL。如果 TARGET 是工作副本路徑,N 預設為
BASE,M 預設為工作副本;如果 TARGET 是 URL,N 必須指定, M 預設為 HEAD。
"-c M" 等價于 "-r M-1:M","-c -M" 等價于 "-r M:M-1"。
2、顯示新舊版本中對應目标的差異。PATH 是相對于新舊目标的相對路徑,
它限制隻輸出這些路徑上的差異。新舊目标可以是工作副本路徑或位址 URL[@REV]。
新目标預設與舊目标相同,OLDREV 預設為 N,NEWREV 預設為 M。
3、"svn diff --old=OLD-URL[@OLDREV] --new=NEW-URL[@NEWREV]" 的簡寫。
使用不加參數的 "svn diff" 顯示工作副本中的本地修改。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-c [--change] ARG : 在ARG版本(如同 -r ARG-1:ARG)作的修改
如果ARG為負數則等價于 -r ARG:ARG-1
--old ARG : 使用 ARG 作為舊目标
--new ARG : 使用 ARG 作為新目标
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--diff-cmd ARG : 使用 ARG 作為比較指令
-x [--extensions] ARG : 預設: "-u"。當 Subversion 調用外部比較程式時,ARG 直接傳給它。但是當
Subversion 使用預設的内置比較實作,或者正
顯示追溯時, ARG 可以是:
-u (--unified):
輸出三行統一上下文。
-b (--ignore-space-change):
忽略空白數量的修改。
-w (--ignore-all-space):
忽略所有的空白。
--ignore-eol-style:
忽略行尾樣式的改變。 -p (--show-c-function):
在比較輸出中顯示 C 函數名稱。
--no-diff-deleted : 不要輸出删除檔案造成的差異
--notice-ancestry : 比較差異時提示原始資訊
--summarize : 顯示結果的概要
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
--force : 強制操作運作
--xml : 輸出為 XML
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
export: 産生一個無版本控制的目錄樹副本。
用法: 1、export [-r REV] URL[@PEGREV] [PATH]
2、export [-r REV] PATH1[@PEGREV] [PATH2]
1、從 URL 指定的版本庫,導出一個幹淨的目錄樹到 PATH。如果有指定
REV 的話,内容即為該版本的,否則就是 HEAD 版本。如果 PATH
被省略的話,URL的最後部份會被用來當成本地的目錄名稱。
2、在工作副本中,從指定的 PATH1 導出一個幹淨的目錄樹到 PATH2。如果
有指定 REV 的話,會從指定的版本導出,否則從工作副本導出。如果
PATH2 被省略的話,PATH1 的最後部份會被用來當成本地的目錄名稱。
如果沒有指定 REV 的話,所有的本地修改都保留,但是未納入版本控制
的檔案不會被複制。
如果指定了 PEGREV ,将從指定的版本本開始查找。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-q [--quiet] : 不列印資訊,或隻列印概要資訊
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--force : 強制操作運作
--native-eol ARG : 使用非标準的 EOL 标記
系統中立的檔案标記 svn:eol-style 屬性取值為 "native"。
ARG 可以是以下之一"LF","CR","CRLF"
--ignore-externals : 忽略外部項目
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
help (?, h): 描述本程式或其子指令的用法。
用法: help [子指令...]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
import: 将未納入版本控制的檔案或目錄樹送出到版本庫。
用法: import [PATH] URL
遞歸地送出 PATH 的副本至 URL。
如果省略 PATH,則預設為 "."。
父目錄會根據需要在版本庫内建立。
如果 PATH 是目錄,則其下的内容直接加入到 URL 指定的位置内。
如果使用了 "--force",那麼不能納入版本控制的項目,例如裝置檔案,管道等,會被忽略。
有效選項:
-q [--quiet] : 不列印資訊,或隻列印概要資訊
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--auto-props : 啟用自動屬性
--force : 強制操作運作
--no-auto-props : 關閉自動屬性
-m [--message] ARG : 指定日志資訊ARG
-F [--file] ARG : 從檔案ARG讀取日志資訊
--force-log : 強制校驗日志資訊資源
--editor-cmd ARG : 使用 ARG 作為外部編輯器
--encoding ARG : 将ARG的值視為字元編碼
--with-revprop ARG : 在新版本設定版本屬性 ARG
使用格式 name[=value]
--no-ignore : 忽略預設值和 svn:ignore 屬性
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
info: 顯示本地或遠端條目的資訊。
用法: info [TARGET[@REV]...]
顯示每個 TARGET 的資訊 (預設: ".")。
TARGET 可以是工作副本中的路徑或版本庫中的 URL。REV 指定從哪個
版本開始查找目标。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--targets ARG : 傳遞檔案 ARG 内容為附件參數
--incremental : 給予适合串聯的輸出
--xml : 輸出為 XML
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
list (ls): 列出版本庫中的目錄内容。
用法: list [TARGET[@REV]...]
顯示版本庫中檔案和子目錄清單。如果 TARGET 是工作副本路徑,那麼操作對應的
版本庫URL指定的TARGET。REV指定從在哪個版本查找TARGET。
TARGET預設是".",表示目前工作目錄對應的版本庫URL。
使用 --verbose 時,每個條目會顯示以下額外資訊:
最後一次送出的版本号碼
最後一次送出的作者
如果被鎖定,顯示字母"O"。(使用"svn info URL"檢視詳細資訊)
大小 (以位元組為機關)
最後一次送出的日期與時間
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-v [--verbose] : 列印附加資訊
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--incremental : 給予适合串聯的輸出
--xml : 輸出為 XML
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
lock: 鎖定版本庫中的路徑,使得其他使用者不能向其送出修改。
用法: lock TARGET...
使用 --force 選項可以從其他使用者或工作副本竊取到鎖。
有效選項:
--targets ARG : 傳遞檔案 ARG 内容為附件參數
-m [--message] ARG : 指定加鎖注釋ARG
-F [--file] ARG : 從檔案 ARG 讀取加鎖注釋
--force-log : 強制校驗鎖定注釋源
--encoding ARG : 将ARG的值視為字元編碼
--force : 強制操作運作
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
log: 顯示一組版本與/或檔案的送出日志資訊。
用法: 1、log [PATH]
2、log URL[@REV] [PATH...]
1、顯示本地 PATH (預設: ".") 的日志資訊。預設的版本範圍是 BASE:1。
2、顯示 URL 中 PATH (預設: ".") 的日志資訊。如果指定了 REV,就從 REV
開始查找 URL,版本範圍是 REV:1。否則就從 HEAD 開始查找 URL,版本範圍
是 HEAD:1。
可以指定多個 "-c" 或 "-r" 選項 (但是不允許同時使用 "-c" 和 "-r" 選項),
以及混合使用前向和後向範圍。
使用 -v 時,在日志資訊中顯示受影響的路徑名。
使用 -q 時,不顯示日志資訊主體 (請注意,它可與 -v 并存)。
每條日志資訊隻會顯示一次,即使指定了此版本涉及到的多個路徑。預設日志資訊
會追溯複制曆史;使用 --stop-on-copy 可以關閉這種行為,這可以用來找出分支點。
範例:
svn log
svn log foo.c
svn log http://www.example.com/repo/project/foo.c
svn log http://www.example.com/repo/project foo.c bar.c
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-q [--quiet] : 不列印資訊,或隻列印概要資訊
-v [--verbose] : 列印附加資訊
-g [--use-merge-history] : 從合并曆史使用/顯示額外資訊
-c [--change] ARG : 版本 ARG 引起的改變
--targets ARG : 傳遞檔案 ARG 内容為附件參數
--stop-on-copy : 檢視曆史不要跨越不同的副本
--incremental : 給予适合串聯的輸出
--xml : 輸出為 XML
-l [--limit] ARG : 日值項最大值
--with-all-revprops : 擷取所有版本屬性
--with-no-revprops : 沒有找回版本屬性
--with-revprop ARG : 擷取版本屬性 ARG
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
merge: 将兩個源差異應用至工作副本。
用法: 1. merge sourceURL1[@N] sourceURL2[@M] [WCPATH]
2. merge [email protected] [email protected] [WCPATH]
3. merge [-c M[,N...] | -r N:M ...] SOURCE[@REV] [WCPATH]
1、第一種形式中,源 URL 的版本 N 與 M 作為比較的來源。如果沒有指定版本,預設
為 HEAD。
2、在第二種形式中,兩個源工作副本路徑對應的版本庫中的 URL 作為比較的來源。這
裡必須指定版本。
3、第三種形式中,SOURCE 可為 URL 或工作副本中的路徑(後者會使用版本庫中對應
的 URL)。比較版本為 REV 的 SOURCE,就像它在版本 N 到 M 存在一樣。如果沒
有給出 REV,預設為 HEAD。選項 "-c M" 等價于 "-r :M","-c -M" 與之
相反,等價于 "-r M:"。如果沒有指定版本範圍,預設為 0:REV。可以指定
多個 "-c" 或 "-r",并且可以混合使用向前範圍或向後範圍。
WCPATH 是接收修改的工作副本路徑。如果省略了 WCPATH,預設為 ".",除非來源中
有與目前目錄内同名的檔案,這時修改會直接應用至該檔案。
注意: Subversion 隻有當兩個合并源有繼承關系的時候才會内部跟蹤合并操作的源數
據 -- 即如果第一個合并源是第二個的祖先,或者相反。在上述的第三種形式中,已經
保證了滿足條件。選項 --ignore-ancestry 忽略繼承關系,強制 Subversion 認為合并
源之間沒有關系,不跟蹤本次合并。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-c [--change] ARG : 在ARG版本(如同 -r ARG-1:ARG)作的修改
如果ARG為負數則等價于 -r ARG:ARG-1
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--force : 強制操作運作
--dry-run : 嘗試操作但沒有修改
--diff3-cmd ARG : 使用 ARG 作為合并指令
--record-only : 标記版本為已合并(使用 -r 參數)
-x [--extensions] ARG : 預設: "-u"。當 Subversion 調用外部比較程式時,ARG 直接傳給它。但是當
Subversion 使用預設的内置比較實作,或者正
顯示追溯時, ARG 可以是:
-u (--unified):
輸出三行統一上下文。
-b (--ignore-space-change):
忽略空白數量的修改。
-w (--ignore-all-space):
忽略所有的空白。
--ignore-eol-style:
忽略行尾樣式的改變。 -p (--show-c-function):
在比較輸出中顯示 C 函數名稱。
--ignore-ancestry : 合并時忽略原始資訊
--accept ARG : 指定自動解決沖突動作
('postpone', 'base', 'mine-conflict',
'theirs-conflict', 'mine-full', 'theirs-full',
'edit', 'launch')
--reintegrate : 批量合并所有源 URL 中未合并的修改
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
mergeinfo: 顯示合并的相關資訊。
用法: mergeinfo SOURCE[@REV] [TARGET[@REV]]
顯示 SOURCE 與 TARGET(預設為 ".") 之間的合并(或潛在合并)資訊。如果沒有
提供選項 --show-revs,那麼就顯示已經從 SOURCE 合并到 TARGET 的版本。否
則就顯示選項 --show-revs 指定的資訊。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
--show-revs ARG : 指定顯示哪個版本集合
('merged', 'eligible')
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
mkdir: 建立納入版本控制的新目錄。
用法: 1、mkdir PATH...
2、mkdir URL...
建立版本控制的目錄。
1、每個以工作副本 PATH 指定的目錄,都會在本地建立,并且加入增加
排程,直到下次送出。
2、每個以 URL 指定的目錄,都會通過立即送出在版本庫中建立。
在這兩個情況下,所有的中間目錄都必須事先存在,
除非使用選項 --parents。
有效選項:
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--parents : 建立中間目錄
-m [--message] ARG : 指定日志資訊ARG
-F [--file] ARG : 從檔案ARG讀取日志資訊
--force-log : 強制校驗日志資訊資源
--editor-cmd ARG : 使用 ARG 作為外部編輯器
--encoding ARG : 将ARG的值視為字元編碼
--with-revprop ARG : 在新版本設定版本屬性 ARG
使用格式 name[=value]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
move (mv, rename, ren): 在工作副本或版本庫中移動或改名檔案或目錄。
用法: move SRC... DST
當移動多個源時,它們作為 DST 的子節點增加,DST 必須是目錄。
注意: 本子指令等同于先 "copy",然後 "delete"。
注意: 此指令中 --revision 選項沒有作用,已經淘汰。
SRC 可同時為工作副本(WC) 路徑或 URL:
WC -> WC : 移動并加入新增排程 (連同曆史記錄)
URL -> URL : 完全是伺服器端更名。
所有 SRC 必須是同一類型。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--force : 強制操作運作
--parents : 建立中間目錄
-m [--message] ARG : 指定日志資訊ARG
-F [--file] ARG : 從檔案ARG讀取日志資訊
--force-log : 強制校驗日志資訊資源
--editor-cmd ARG : 使用 ARG 作為外部編輯器
--encoding ARG : 将ARG的值視為字元編碼
--with-revprop ARG : 在新版本設定版本屬性 ARG
使用格式 name[=value]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
propdel (pdel, pd): 删除目錄、檔案或版本的屬性。
用法: 1、propdel PROPNAME [PATH...]
2、propdel PROPNAME --revprop -r REV [URL]
1、删除工作副本中納入版本管理的檔案或目錄的屬性。
2、删除版本庫中版本的屬性。TARGET隻用來判斷通路哪個版本庫。
有效選項:
-q [--quiet] : 不列印資訊,或隻列印概要資訊
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
--revprop : 在版本屬性上操作(使用-r參數)
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
propedit (pedit, pe): 使用外部編輯器編輯屬性。
用法: 1、propedit PROPNAME TARGET...
2、propedit PROPNAME --revprop -r REV [TARGET]
1、編輯工作副本或者版本庫中受版本控制的屬性。
2、編輯版本庫中指定版本的未版本控制的遠端屬性。
TARGET 隻用來判斷通路哪一個版本庫。
參見 "svn help propset" 以獲得更多設定屬性的資訊。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
--revprop : 在版本屬性上操作(使用-r參數)
-m [--message] ARG : 指定日志資訊ARG
-F [--file] ARG : 從檔案ARG讀取日志資訊
--force-log : 強制校驗日志資訊資源
--editor-cmd ARG : 使用 ARG 作為外部編輯器
--encoding ARG : 将ARG的值視為字元編碼
--with-revprop ARG : 在新版本設定版本屬性 ARG
使用格式 name[=value]
--force : 強制操作運作
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
propget (pget, pg): 顯示目錄、檔案或版本的屬性取值。
用法: 1、propget PROPNAME [TARGET[@REV]...]
2、propget PROPNAME --revprop -r REV [URL]
1、顯示版本控制的屬性。REV 指定從哪個版本開始查找目标。
2、顯示版本庫中版本的未版本控制的遠端屬性。
隻用來判斷通路哪個版本庫。
本子指令預設會在屬性内容加上額外的換行符,得到美觀的輸出。另外,
當同時處理多個路徑時,每一個屬性内容會在開頭增加上它所對應的路徑。
使用 --strict 選項可以關閉這些美化行為 (它很有用,例如将二進制屬
性内容重定向到一個檔案,但是僅用于單一目标的非遞歸操作)。
有效選項:
-v [--verbose] : 列印附加資訊
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
--revprop : 在版本屬性上操作(使用-r參數)
--strict : 使用嚴格的文法
--xml : 輸出為 XML
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
proplist (plist, pl): 列出目錄、檔案或版本的所有屬性。
用法: 1、proplist [TARGET[@REV]...]
2、proplist --revprop -r REV [TARGET]
1、顯示目标的屬性。REV 指定從哪個版本開始查找目标。
2、列出版本庫中版本的屬性。TARGET 隻用來判斷通路哪個版本庫。
有效選項:
-v [--verbose] : 列印附加資訊
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--revprop : 在版本屬性上操作(使用-r參數)
--xml : 輸出為 XML
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
propset (pset, ps): 設定目錄、檔案或版本的屬性。
用法: 1. propset PROPNAME PROPVAL PATH...
2. propset PROPNAME --revprop -r REV PROPVAL [TARGET]
1、在工作副本中修改一個受版本控制的屬性。
2、在版本庫的版本中修改一個非版本控制的屬性。
(TARGET 隻用來判斷通路哪一個版本庫。)
可以使用選項 --file 來代替 PROPVAL 指派。
注意: svn 除了能存儲任意屬性外,還識别以下專用的版本控制屬性:
svn:ignore - 以換行符隔開的檔案忽略模式清單。
svn:keywords - 将被展開的關鍵字。有效的關鍵字為。
URL, HeadURL - 此對象最新版本的 URL。
Author, LastChangedBy - 最後修改檔案的人。
Date, LastChangedDate - 此對象最後修改的日期。
Rev, Revision, - 此對象最後修改的版本号。
LastChangedRevision
Id - 前四個關鍵字的壓縮摘要。
Header - 與 Id 類似,隻是包含完整的 URL。
svn:executable - 如果存在此屬性則設定檔案為可執行的。
使用 "svn propdel svn:executable PATH..." 清除。
svn:eol-style - "native","LF","CR","CRLF" 之一。
svn:mime-type - 檔案的媒體類型。用以決定是否該合并該檔案,
以及 Apache 如何處理它。媒體類型以"text/"開頭(或是沒有指
定媒體類型)的檔案會被視為純文字檔案,否則就是二進制資料。
svn:externals - 以換行符隔開的子產品說明清單,每項都由一個
相對路徑、可選的版本标志、一個 URL 組成。這三個元素的順序實作
不同的行為。Subversion 1.4 和早期的版本僅支援下列格式,并且 URL
中不能有 peg 版本:
foo http://example.com/repos/zig
foo/bar -r 1234 http://example.com/repos/zag
Subversion 1.5 和更高的版本支援以上格式,以及下列格式,URL 中可以有
peg 版本:
http://example.com/repos/zig foo
-r 1234 http://example.com/repos/zig foo/bar
Subversion 1.5 和更高的版本在上述格式中支援相對 URL,在用 URL 開始用
下述字元串之一來訓示:
../ 相對于外部引用的父目錄
^/ 相對于版本庫的根
// 相對于方案
/ 相對于伺服器根
相對路徑"relative_path relative_path"這種不明确的格式來自
"relative_url relative_path"和 peg 版本支援。
svn:needs-lock - 此屬性表明檔案在修改前應該加鎖。
如果沒有加鎖,則此檔案在工作副本中應被設為隻讀。使用
"svn propdel svn:needs-lock PATH..." 清除。
svn:keywords, svn:executable, svn:eol-style, svn:mime-type 以及
svn:needs-lock 屬性不能設定在目錄上。使用非遞歸選項(-N)在目錄上
設定這些屬性時會失敗,遞歸操作時隻會作用于指定目錄中的檔案子孫上。
有效選項:
-F [--file] ARG : 從檔案 ARG 讀取屬性值
--encoding ARG : 将ARG的值視為字元編碼
-q [--quiet] : 不列印資訊,或隻列印概要資訊
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
--targets ARG : 傳遞檔案 ARG 内容為附件參數
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--revprop : 在版本屬性上操作(使用-r參數)
--force : 強制操作運作
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
resolve: 解決工作副本中目錄或檔案的沖突。
用法: resolve --accept=ARG [PATH...]
注意: 目前需要選項 --accept 。
有效選項:
--targets ARG : 傳遞檔案 ARG 内容為附件參數
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--accept ARG : 指定自動解決沖突動作的源
('base', 'working', 'mine-conflict',
'theirs-conflict', 'mine-full', 'theirs-full')
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
resolved: 删除工作副本中目錄或檔案的"沖突"狀态。
用法: resolved PATH...
注意: 本子指令不會依文法來解決沖突或是删除沖突标記;它隻是删除沖突相關的
附加檔案,讓 PATH 可以被再次送出。它已經過時,被
"svn resolve --accept working"取代。
有效選項:
--targets ARG : 傳遞檔案 ARG 内容為附件參數
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-q [--quiet] : 不列印資訊,或隻列印概要資訊
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
revert: 将工作副本檔案恢複到原始版本(恢複大部份的本地修改)。
用法: revert PATH...
注意: 本子指令不會通路網絡,它解除任何沖突的狀态。
但是,它不恢複被删除的目錄。
有效選項:
--targets ARG : 傳遞檔案 ARG 内容為附件參數
-R [--recursive] : 向下遞歸,與 --depth=infinity 相同
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
status (stat, st): 顯示工作副本中目錄與檔案的狀态。
用法: status [PATH...]
未指定參數時,隻顯示本地修改的條目(沒有網絡通路)。
使用 -q 時,隻顯示本地修改條目的摘要資訊。
使用 -u 時,增加工作版本和伺服器上版本過期資訊。
使用 -v 時,顯示每個條目的完整版本資訊。
輸出的前七欄各占一個字元寬度:
第一欄: 表示一個項目是增加、删除,還是修改
" " 無修改
"A" 增加
"C" 沖突
"D" 删除
"I" 忽略
"M" 改變
"R" 替換
"X" 未納入版本控制的目錄,被外部引用的目錄所建立
"?" 未納入版本控制
"!" 該項目已遺失(被非 svn 指令删除)或不完整
"~" 版本控制下的項目與其它類型的項目重名
第二欄: 顯示目錄或檔案的屬性狀态
" " 無修改
"C" 沖突
"M" 改變
第三欄: 工作副本目錄是否被鎖定
" " 未鎖定
"L" 鎖定
第四欄: 已排程的送出是否包含副本曆史
" " 沒有曆史
"+" 包含曆史
第五欄: 該條目相對其父目錄是否已切換,或者是外部引用的檔案
" " 正常
"S" 已切換
"X" 被外部引用建立的檔案
第六欄: 版本庫鎖定标記
(沒有 -u)
" " 沒有鎖定标記
"K" 存在鎖定标記
(使用 -u)
" " 沒有在版本庫中鎖定,沒有鎖定标記
"K" 在版本庫中被鎖定,存在鎖定标記
"O" 在版本庫中被鎖定,鎖定标記在一些其他工作副本中
"T" 在版本庫中被鎖定,存在鎖定标記但已被竊取
"B" 沒有在版本庫中被鎖定,存在鎖定标記但已被破壞
第七欄: 項目沖突标記
" " 正常
"C" 樹沖突
如果項目包含于樹沖突之中,在項目狀态行後會附加行,說明沖突的種類。
是否過期的資訊出現的位置是第九欄(與 -u 并用時):
"*" 伺服器上有更新版本
" " 工作副本是最新版的
剩餘的欄位皆為變動寬度,并以空白隔開:
工作版本号(使用 -u 或 -v 時)
最後送出的版本與最後送出的作者(使用 -v 時)
工作副本路徑總是最後一欄,是以它可以包含空白字元。
範例輸出:
svn status wc
M wc/bar.c
A + wc/qax.c
svn status -u wc
M 965 wc/bar.c
* 965 wc/foo.c
A + 965 wc/qax.c
Status against revision: 981
svn status --show-updates --verbose wc
M 965 938 kfogel wc/bar.c
* 965 922 sussman wc/foo.c
A + 965 687 joe wc/qax.c
965 687 joe wc/zig.c
Status against revision: 981
svn status
M wc/bar.c
! C wc/qaz.c
> local missing, incoming edit upon update
D wc/qax.c
有效選項:
-u [--show-updates] : 顯示更新資訊
-v [--verbose] : 列印附加資訊
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--no-ignore : 忽略預設值和 svn:ignore 屬性
--incremental : 給予适合串聯的輸出
--xml : 輸出為 XML
--ignore-externals : 忽略外部項目
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
switch (sw): 更新工作副本至不同的 URL。
用法: 1、switch URL[@PEGREV] [PATH]
2、switch --relocate FROM TO [PATH...]
1、更新工作副本,切換到同一版本庫中的新 URL。其行為跟 "svn update" 很像,
也是将工作副本切換到同一版本庫中某個分支或者标簽的方法。PEGREV 決定從,
哪個版本查找目标。
如果使用了 "--force" 選項,在工作副本中未版本控制的障礙路徑,不會自動
導緻失敗。如果障礙路徑與版本庫中的對應路徑類型相同(檔案或目錄),它将成
為受版本控制的路徑,但是内容不改變。它意味着障礙路徑的子孫,如果也是障
礙路徑,那麼也會受版本控制。對于障礙路徑中的檔案,如果與版本庫内的不同,
将視為工作副本發生本地修改。版本庫中的所有屬性都應用于障礙路徑。
使用 "--set-depth" 選項設定此操作目标的工作副本之新深度。
2、重寫工作副本的 URL 中繼資料,以反映單純的 URL 改變。當版本庫的根 URL 改
變(比如方案或者主機名稱變動),但是工作副本仍舊對應同一版本庫的同一目錄
時,使用這個指令更新工作副本與檔案庫的對應關系。
參見 "svn help update" 以擷取報告執行動作的字元清單。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--set-depth ARG : 設定工作副本的新深度為 ARG("exclude","empty","files","immediates",
或"infinity")
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--diff3-cmd ARG : 使用 ARG 作為合并指令
--relocate : 通過URL改寫重新定位
--ignore-externals : 忽略外部項目
--force : 強制操作運作
--accept ARG : 指定自動解決沖突動作
('postpone', 'base', 'mine-conflict',
'theirs-conflict', 'mine-full', 'theirs-full',
'edit', 'launch')
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
unlock: 解除工作副本或URL的鎖定。
用法: unlock TARGET...
使用 --force 終止鎖定。
有效選項:
--targets ARG : 傳遞檔案 ARG 内容為附件參數
--force : 強制操作運作
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf
update (up): 将版本庫的修改合并到工作副本中。
用法: update [PATH...]
如果沒有指定版本,則将工作副本更新到 HEAD 版本。否則同步到 -r 選項所
指定的版本。
每更新一項就輸出一行資訊,使用首字元來報告執行的動作。這些字元的含義是:
A 已添加
D 已删除
U 已更新
C 合并沖突
G 合并成功
E 已存在
第一列字元表示檔案内容更新,第二清單示檔案屬性更新。第三列中的字元"B"
表示此檔案上的鎖被終止或竊取。
如果使用了 "--force" 選項,在工作副本中未版本控制的障礙路徑,不會自動
導緻簽出失敗。 如果障礙路徑與版本庫中的對應路徑類型相同(檔案或目錄),它
将成為受版本控制的路徑,但是内容不改變。它意味着障礙路徑的子孫,如果也
是障礙路徑,那麼也将受版本控制。對于障礙路徑中的檔案,如果與版本庫内的
不同,将視為工作副本發生本地修改。版本庫中的所有屬性都應用于障礙路徑。
用第一列字元 "E" 來報告障礙路徑。
使用"--set-depth"選項設定此操作目标的工作副本之新深度。
有效選項:
-r [--revision] ARG : ARG (一些指令也接受ARG1:ARG2範圍)
版本參數可以是如下之一:
NUMBER 版本号
'{' DATE '}' 在指定時間以後的版本
'HEAD' 版本庫中的最新版本
'BASE' 工作副本的基線版本
'COMMITTED' 最後送出或基線之前
'PREV' COMMITTED的前一版本
-N [--non-recursive] : 過時;嘗試 --depth=files 或 --depth=immediates
--depth ARG : 受深度參數 ARG("empty","files","immediates",或"infinity") 限制的操作
--set-depth ARG : 設定工作副本的新深度為 ARG("exclude","empty","files","immediates",
或"infinity")
-q [--quiet] : 不列印資訊,或隻列印概要資訊
--diff3-cmd ARG : 使用 ARG 作為合并指令
--force : 強制操作運作
--ignore-externals : 忽略外部項目
--changelist ARG : 隻能對修改清單 ARG 成員操作
[aliases: --cl]
--editor-cmd ARG : 使用 ARG 作為外部編輯器
--accept ARG : 指定自動解決沖突動作
('postpone', 'base', 'mine-conflict',
'theirs-conflict', 'mine-full', 'theirs-full',
'edit', 'launch')
全局選項:
--username ARG : 指定使用者名稱 ARG
--password ARG : 指定密碼 ARG
--no-auth-cache : 不要緩存使用者認證令牌
--non-interactive : 不要互動提示
--trust-server-cert : 不提示的接受未知的 SSL 伺服器證書(隻用于選項 "--non-interactive")
--config-dir ARG : 從目錄 ARG 讀取使用者配置檔案
--config-option ARG : 以下屬格式設定使用者配置選項:
FILE:SECTION:OPTION=[VALUE]
例如:
servers:global:http-library=serf