8068 lines
300 KiB
Plaintext
8068 lines
300 KiB
Plaintext
== CMD_DESCRIPTION_ACL ==
|
||
設定物件權限。
|
||
|
||
== CMD_USAGE_ACL ==
|
||
用法：
|
||
|
||
cm ^acl (--^user=<使用者_名稱> | --^group=<群組_名稱>)
|
||
(-^allowed|-^denied|-^overrideallowed|-^overridedenied=+|-<權限>[,...])[,...]
|
||
<物件規格>
|
||
|
||
--^user 使用者名稱。
|
||
--^group 群組名稱。
|
||
-^allowed 啟用指定的一或多項權限。使用
|
||
逗號以分隔權限。(使用 'cm ^showpermissions'
|
||
以顯示所有可用的權限。)
|
||
-^denied 拒絕指定的一或多項權限。使用
|
||
逗號以分隔權限。(使用 'cm ^showpermissions'
|
||
以顯示所有可用的權限。)
|
||
-^overrideallowed 覆寫允許的一或多項權限。使用
|
||
逗號以分隔權限。(使用 'cm ^showpermissions'
|
||
以顯示所有可用的權限。)
|
||
-^overridedenied 覆寫拒絕的一或多項權限。使用
|
||
逗號以分隔權限。(使用 'cm ^showpermissions'
|
||
以顯示所有可用的權限。)
|
||
物件規格 將設定權限的物件。
|
||
此命令的有效物件為：
|
||
儲存庫伺服器、儲存庫、分支、變更集、標籤、項目，
|
||
以及屬性。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
安全路徑的特殊用法：
|
||
cm ^acl [(--^user=<使用者_名稱> | --^group=<群組_名稱>)
|
||
(-^allowed|-^denied|-^overrideallowed|-^overridedenied=+|-<權限>[,...])[,...]]
|
||
[--^delete] [--^branches=[+ | -]<分支>[,...]]
|
||
<規格>
|
||
|
||
--^delete 移除安全路徑。
|
||
如需詳細資訊，請參閱備註。
|
||
--^branches 將安全路徑權限設為分支群組。
|
||
使用逗號以分隔分支。
|
||
或者，每個分支前面可加上 + 或 -
|
||
簽署以指定在編輯時是否必須在清單中新增或刪除
|
||
分支。
|
||
如需詳細資訊，請參閱備註。
|
||
規格 設定權限所在的安全路徑。
|
||
|
||
== CMD_HELP_ACL ==
|
||
設定權限需要瞭解 Unity VCS 安全性的運作方式。
|
||
查看《安全性指南》以瞭解權限的運作方式：
|
||
https://www.plasticscm.com/download/help/securityguide
|
||
|
||
備註：
|
||
|
||
此命令為使用者或群組設定特定物件、儲存庫、分支、標籤
|
||
及/或伺服器路徑的權限。
|
||
|
||
物件規格：
|
||
(使用 'cm ^help ^objectspec' 以瞭解如何指定物件。)
|
||
'^acl' 命令使用特殊類型的規格：安全路徑。
|
||
|
||
- 安全路徑規格：
|
||
^path:server_path[#tag]
|
||
範例：^path:/src/foo.c
|
||
^path:/doc/pdf
|
||
^path:/doc/pdf#documents
|
||
|
||
權限動作：
|
||
使用 -^allowed 和 -^denied 以指定要設定的權限。
|
||
使用 -^overrideallowed 和 -^overridedenied 引數以指定
|
||
要覆寫的權限。
|
||
|
||
每個動作皆需要以逗號分隔的權限清單。
|
||
|
||
權限名稱：
|
||
每個權限前面已加上 + 或 - 符號。
|
||
+ 符號可設定權限，- 符號可清除權限。
|
||
若要查看物件的權限，請使用 'cm ^showacl' 命令。
|
||
|
||
已覆寫的權限：
|
||
使用 -^overrideallowed 和 -^overridedenied
|
||
覆寫權限可讓您略過繼承。
|
||
略過在儲存庫或伺服器層級設定的權限會
|
||
很有幫助。
|
||
範例：
|
||
cm ^acl --^user=vio -^allowed=+^ci -^overrideallowed=+^ci ^br:qa@test
|
||
(即使使用者 'vio' 的權限在儲存庫層級遭受拒絕，該使用者也可以在儲存庫 'test'
|
||
的分支 'qa' 上簽入。)
|
||
|
||
伺服器路徑權限 (又稱為安全路徑)：
|
||
- 可針對特定伺服器路徑指定權限。
|
||
- 簽入作業期間會檢查這些權限。
|
||
- 更新作業期間也會檢查這些權限，
|
||
並且可用來防止某些目錄和檔案
|
||
下載至工作區。
|
||
- 對於要簽入的每個項目，伺服器會嘗試將項目路徑
|
||
與安全路徑進行比對。如果相符，簽入作業會檢查
|
||
該項目是否具有要簽入的權限。
|
||
|
||
可以針對安全路徑定義的權限
|
||
如下：
|
||
'^ci'、'^change'、'^add'、'^move'、'^rm'、'^read'
|
||
|
||
如果任何涉及項目的權限檢查不成功，
|
||
將會復原簽入作業。
|
||
|
||
若要將安全路徑權限設為分支群組，請使用
|
||
--^branches 選項。
|
||
範例：
|
||
cm ^acl --^user=jo -^denied=+^ci ^path:/src#rule0 --^branches=main,main/rel0
|
||
|
||
若要編輯與安全路徑相關的 ACL，標籤很有用。
|
||
範例：
|
||
cm ^acl --^user=jo -^denied=+^rm ^path:/src#rule0
|
||
(如果沒有此標籤，可能需要再次指定
|
||
分支清單。)
|
||
|
||
可編輯安全路徑的分支清單。
|
||
範例：
|
||
cm ^acl ^path:/src#rule0 --^branches=-main,+main/rel1
|
||
(將 'main' 從清單中移除，並新增 'main/rel1'。)
|
||
|
||
若要移除安全路徑，請使用 --^delete 引數。
|
||
範例：
|
||
cm ^acl --^user=jo --^delete ^path:/src#rule0
|
||
|
||
繼承：
|
||
繼承是來自 Unity VCS 3.0 的選項。
|
||
這是進階選項，但幾乎已棄用。
|
||
該選項可讓物件繼承來自任何其他物件的權限，
|
||
覆寫預設的繼承關係。
|
||
|
||
使用選項 -^cut 以切斷繼承鏈。
|
||
使用選項 -^cutncpy 以切斷和複製目前繼承的
|
||
權限。(這是受到 Windows 檔案系統權限的啟發
|
||
，在當中您可以切斷繼承，但保留實際權限。)
|
||
|
||
-^inherit 選項可讓使用者繼承物件規格。
|
||
範例：'-^inherit=物件_規格'
|
||
|
||
範例：
|
||
|
||
cm ^acl --^user=danipen -^denied=+^ci ^rep:core
|
||
(在儲存庫 'core' 上拒絕使用者 'danipen' 的簽入。)
|
||
|
||
cm ^acl --^group=developers -^allowed=+^view,-^read -^denied=+^chgperm ^br:main
|
||
(此命令可針對 'main' 分支中 'developers' 群組授予檢視權限、
|
||
清除讀取權限，並拒絕 chgperm 權限。)
|
||
|
||
安全路徑範例：
|
||
|
||
cm ^acl --^group=devs -^denied=+^ci ^path:/server#rel --^branches=main,main/2.0
|
||
(此命令會拒絕分支 'main' 和 'main/2.0' 中任何符合 '/server' 之路徑
|
||
的 '開發' 群組的簽入權限。建立標籤 '#rel'
|
||
是為了能在日後進行參照。)
|
||
|
||
cm ^acl ^path:/server#rel --^branches=-/main,+/main/Rel2.1
|
||
(更新安全路徑 '/server'，其標籤是 'rel'，移除
|
||
'main' 分支，並將分支 'main/Rel2.1' 新增至
|
||
安全路徑適用的分支群組。請考量先前範例，
|
||
現在分支清單將包含 'main/Rel2.1' 和 'main/2.0'。)
|
||
|
||
cm ^acl --^user=vsanchezm -^allowed=-^read -^overrideallowed=+^read ^path:/doc
|
||
(針對 '/doc' 路徑中覆寫的 'vsanchezm'，移除 '^read' 權限。)
|
||
|
||
== CMD_DESCRIPTION_ACTIVATEUSER ==
|
||
啟動授權使用者。
|
||
|
||
== CMD_USAGE_ACTIVATEUSER ==
|
||
用法：
|
||
|
||
cm ^activateuser | ^au <使用者名稱>[ ...][--^server=<儲存庫伺服器規格>]
|
||
|
||
使用者名稱 要啟動的一或多個使用者名稱。使用雙引號 (" ")
|
||
以指定使用者名稱 (包含空格)。使用空格
|
||
以分隔使用者名稱。
|
||
|
||
選項：
|
||
--^server=<儲存庫伺服器規格> 在指定的伺服器中啟動使用者。
|
||
如果未指定任何伺服器，請在 client.conf 檔案的
|
||
預設伺服器中執行命令。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
儲存庫伺服器規格。)
|
||
|
||
== CMD_HELP_ACTIVATEUSER ==
|
||
備註：
|
||
|
||
若要啟動使用者，該使用者先前必須已停用。
|
||
預設情況下，第一次在 Unity VCS 中執行寫入
|
||
作業時，會啟動使用者。只有在未超過使用者人數上限時，
|
||
才會自動啟動使用者。
|
||
|
||
如需停用 Unity VCS 使用者的詳細資訊，請參閱
|
||
'cm ^help ^deactivateuser' 命令。
|
||
|
||
範例：
|
||
|
||
cm ^activateuser john
|
||
cm ^activateuser david "mary collins"
|
||
cm ^au peter --^server=localhost:8087
|
||
|
||
== CMD_DESCRIPTION_ADD ==
|
||
將項目新增至版本控制。
|
||
|
||
== CMD_USAGE_ADD ==
|
||
用法：
|
||
|
||
cm ^add [-^R | -^r | --^recursive] [--^silent] [--^ignorefailed]
|
||
[--^skipcontentcheck] [--^coparent] [--^filetypes=<檔案>] [--^noinfo]
|
||
[--^format=<字串格式>] [--^errorformat=<字串格式>]
|
||
<項目路徑>[ ...]
|
||
|
||
項目路徑 要新增的一或多個項目。使用雙引號 (" ") 指定
|
||
含空格的路徑。使用空格以分隔項目。
|
||
使用 * 以新增目前目錄的所有內容。
|
||
|
||
選項：
|
||
|
||
-^R -^r --^recursive 遞迴新增項目。
|
||
--^silent 不顯示任何輸出。
|
||
--^ignorefailed 如果無法新增項目，新增作業將會在沒有項目的情況下，
|
||
繼續進行新增作業。請注意：如果無法新增目錄
|
||
，則不會新增其內容。
|
||
--^skipcontentcheck 當擴充功能不足以將檔案設為文字
|
||
或二進位時，將設為二進位，而不會
|
||
檢查內容以偵測類型。這麼做的目的是
|
||
提高大量簽入的效能。
|
||
--^coparent 針對要新增項目的上層執行簽出。
|
||
--^filetypes 要使用的檔案類型檔案。如需詳細資訊，
|
||
請查看以下連結：
|
||
http://blog.plasticscm.com/2008/03/custom-file-types.html
|
||
--^noinfo 不列印進度資訊。
|
||
--^format 以指定的格式擷取輸出訊息。如需詳細資訊，
|
||
請查看範例。
|
||
--^errorformat 以指定的格式擷取錯誤訊息
|
||
(如果有的話)。如需詳細資訊，請查看範例。
|
||
|
||
== CMD_HELP_ADD ==
|
||
備註：
|
||
|
||
新增項目的要求：
|
||
- 要新增之項目的上層目錄先前必須已新增。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
'^add' 命令可從 stdin 讀取路徑。若要執行此操作，可傳遞單一破折號
|
||
「-」來完成。
|
||
範例：cm ^add -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線以指定要新增的檔案。
|
||
範例：
|
||
dir /S /B *.c | cm ^add -
|
||
(在 Windows 中，新增工作區中所有 .c 檔案。)
|
||
|
||
|
||
|
||
範例：
|
||
|
||
cm ^add file1.txt file2.txt
|
||
(新增 'file1.txt' 和 'file2.txt' 項目。)
|
||
|
||
cm ^add c:\workspace\file.txt
|
||
(在路徑 'c:\workspace' 中新增 'file.txt' 項目。)
|
||
|
||
cm ^add -^R c:\workspace\src
|
||
(遞迴新增 'src'。)
|
||
|
||
cm ^add -^R *
|
||
(遞迴新增目前目錄的所有內容。)
|
||
|
||
cm ^add -^R * --^filetypes=filetypes.conf
|
||
(遞迴新增目前目錄的所有內容，使用
|
||
'filetypes.conf' 以根據其副檔名將類型指派給每個檔案，
|
||
而不是檢查其內容。)
|
||
|
||
cm ^add --^coparent c:\workspace\dir\file.txt
|
||
(將 'file.txt' 新增至原始檔控制，並執行 'dir' 的簽出。)
|
||
|
||
cm ^add -^R * --^format="ADD {0}" --^errorformat="ERR {0}"
|
||
(遞迴新增目前目錄的所有內容，對於成功新增的檔案，
|
||
列印 '^ADD <項目>'，對於無法新增的項目，列印
|
||
'^ERR <項目>'。)
|
||
|
||
== CMD_USAGE_ADDIGNOREPATTERN ==
|
||
用法：
|
||
|
||
cm ^addignorepattern <模式>[ ...]
|
||
[--^workspace=<工作區路徑> | --^allworkspaces] [--^remove]
|
||
|
||
== CMD_DESCRIPTION_ADMIN ==
|
||
在伺服器上執行系統管理命令。
|
||
|
||
== CMD_USAGE_ADMIN ==
|
||
用法：
|
||
|
||
cm ^admin <命令> [選項]
|
||
|
||
可用命令：
|
||
|
||
^readonly
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^admin <命令> --^usage
|
||
cm ^admin <命令> --^help
|
||
|
||
== CMD_HELP_ADMIN ==
|
||
備註：
|
||
只有伺服器管理員才可以執行系統管理命令。
|
||
|
||
範例：
|
||
|
||
cm ^admin ^readonly ^enter
|
||
cm ^admin ^readonly ^status
|
||
|
||
== CMD_DESCRIPTION_ADMIN_READONLY ==
|
||
啟用/停用伺服器唯讀模式。
|
||
|
||
== CMD_USAGE_ADMIN_READONLY ==
|
||
用法：
|
||
|
||
cm ^admin ^readonly (^enter | ^leave | ^status) [<伺服器>]
|
||
|
||
動作：
|
||
|
||
^enter 伺服器進入唯讀模式。寫入作業將遭受拒絕。
|
||
^leave 伺服器離開唯讀模式。
|
||
^status 顯示伺服器唯讀模式狀態。
|
||
|
||
選項：
|
||
伺服器 在指定的伺服器中執行命令 (server:port)。(使用
|
||
'cm ^help ^objectspec' 以深入瞭解伺服器規格。)
|
||
如果未指定任何伺服器，命令將使用目前
|
||
工作區中的伺服器。
|
||
如果目前路徑不在工作區中，命令會使用 client.conf
|
||
設定檔案中定義的預設伺服器。
|
||
|
||
== CMD_HELP_ADMIN_READONLY ==
|
||
備註：
|
||
只有伺服器管理員才可以進入伺服器唯讀模式。
|
||
|
||
範例：
|
||
|
||
cm ^admin ^readonly ^enter diana:8086
|
||
cm ^admin ^readonly ^leave
|
||
|
||
== CMD_DESCRIPTION_ANNOTATE ==
|
||
顯示檔案每一行上次修改的變更集及其作者。
|
||
|
||
== CMD_USAGE_ANNOTATE ==
|
||
用法：
|
||
|
||
cm ^annotate | ^blame <規格>[ ...]
|
||
[--^format=<字串_格式>]
|
||
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
|
||
[--^dateformat=<字串_日期_格式>]
|
||
[--^encoding=<名稱>]
|
||
[--^stats]
|
||
[--^repository=<儲存庫規格>]
|
||
|
||
規格 要標註的檔案規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
使用雙引號 (" ") 指定含空格的路徑。
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^ignore 設定指定的比較方法。
|
||
如需詳細資訊，請參閱備註。
|
||
--^dateformat 設定輸出格式以列印日期。
|
||
--^encoding 指定輸出編碼，例如：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^stats 顯示統計資料資訊。
|
||
--^repository 指定用於計算
|
||
標註的儲存庫規格。預設情況下，此命令會使用
|
||
儲存庫，其中，工作區中載入的修訂儲存庫
|
||
即存放在此。(使用 'cm ^help ^objectspec' 以深入
|
||
瞭解儲存庫規格。)
|
||
|
||
== CMD_HELP_ANNOTATE ==
|
||
備註：
|
||
|
||
二進位檔案無法標註。
|
||
|
||
--^ignore 選項：
|
||
^none 偵測行尾和空格差異。
|
||
^eol 忽略行尾差異。
|
||
^whitespaces 忽略空格差異。
|
||
^"eol&whitespaces" 忽略行尾和空格差異。
|
||
|
||
--^format 選項：
|
||
此命令的輸出參數如下所示：
|
||
{^owner} 上次變更行的使用者。
|
||
{^rev} 行的來源修訂規格。
|
||
{^content} 行內容。
|
||
{^date} 簽入行的日期。
|
||
{^comment} 行的來源修訂註解。
|
||
{^changeset} 行的來源修訂變更集。
|
||
{^line} 檔案的行號。
|
||
{^id} 項目 ID。
|
||
{^parentid} 項目的上層 ID。
|
||
{^rep} 項目的儲存庫。
|
||
{^branch} 行的來源修訂分支。
|
||
{^ismergerev} 此行的修訂是否在合併中建立。
|
||
|
||
--^dateformat:
|
||
若要指定列印日期的輸出格式。
|
||
請參閱指定的支援格式，網址為：
|
||
https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings
|
||
|
||
--^repository:
|
||
可從遠端儲存庫擷取資料。對於分散式
|
||
案例很有用。
|
||
|
||
範例：
|
||
|
||
cm ^blame c:\workspace\src --^ignore=^"eol&whitespaces" --^encoding=utf-8
|
||
cm ^annotate c:\workspace\file.txt --^ignore=^eol
|
||
|
||
cm ^annotate c:\workspace\file.txt --^format="{^owner} {^date, 10} {^content}"
|
||
(依序寫入擁有者欄位、空白、日期欄位 (靠右對齊)，
|
||
然後空白，再寫入內容。)
|
||
|
||
cm ^blame c:\workspace\file.txt --^format="{^owner, -7} {^comment} {^date}" \
|
||
--^dateformat=yyyyMMdd
|
||
(以 7 個空格寫入擁有者欄位 (靠左對齊)，接著是
|
||
空白、註解，然後是另一個空白，最後是
|
||
已格式化的日期 (例如，20170329)。)
|
||
|
||
cm ^annotate c:\workspace\file.txt --^repository=centralRep@myserver:8084
|
||
|
||
cm ^blame ^serverpath:/src/client/checkin/Checkin.cs#^cs:73666
|
||
(使用伺服器路徑針對以變更集 73666 開始的檔案進行標註。)
|
||
|
||
== CMD_DESCRIPTION_APPLYLOCAL ==
|
||
檢查本地變更 (本地移動、本地刪除，以及本地變更)
|
||
並加以套用，這樣 Unity VCS 就會開始追蹤這些變更。
|
||
|
||
== CMD_USAGE_APPLYLOCAL ==
|
||
用法：
|
||
|
||
cm ^applylocal | ^al [--^dependencies] [<項目_路徑>[ ...]]
|
||
[--^machinereadable [--^startlineseparator=<分隔符號>]
|
||
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
|
||
|
||
選項：
|
||
|
||
--^dependencies 將本地變更相依性新增至
|
||
要套用的項目。
|
||
項目_路徑 要套用的項目。使用空格分隔
|
||
路徑。使用雙引號 (" ") 指定
|
||
含空格的路徑。
|
||
--^machinereadable 以容易解析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何起始。
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何結束。
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，指定應如何
|
||
分隔欄位。
|
||
|
||
== CMD_HELP_APPLYLOCAL ==
|
||
備註：
|
||
|
||
如果未指定 --^dependencies 和 <項目_路徑>，該作業會涉及
|
||
工作區中所有本地變更。
|
||
一律會從指定路徑進行遞迴套用。
|
||
|
||
範例：
|
||
|
||
cm ^applylocal foo.c bar.c
|
||
|
||
cm ^applylocal .
|
||
(在目前目錄中套用所有本地變更。)
|
||
|
||
cm ^applylocal
|
||
(在工作區中套用所有本地變更。)
|
||
|
||
cm ^applylocal --^machinereadable
|
||
(在工作區中套用所有本地變更，並以
|
||
簡化的易於剖析的格式列印結果。)
|
||
|
||
cm ^applylocal --^machinereadable --^startlineseparator=">" \
|
||
--^endlineseparator="<" --^fieldseparator=","
|
||
(在工作區中套用所有本地變更，並以簡化、
|
||
易於剖析的格式列印結果，使用指定的字串來
|
||
起始和結束行，以及分隔欄位。)
|
||
|
||
== CMD_DESCRIPTION_ARCHIVE ==
|
||
外部儲存區中的封存資料。
|
||
|
||
== CMD_USAGE_ARCHIVE ==
|
||
用法：
|
||
|
||
cm ^archive | ^arch <修訂規格>[ ...][-^c | --^comment=<字串_註解>]
|
||
[--^file=<基底_檔案>]
|
||
(從儲存庫擷取資料，並將其存放在外部儲存區。)
|
||
|
||
cm ^archive | ^arch <修訂規格>[ ...]--^restore
|
||
(將先前封存的修訂還原至儲存庫。)
|
||
|
||
修訂規格 一或多個修訂規格。可以使用「-」修飾詞
|
||
從 STDIN 讀取。(使用 'cm ^help ^objectspec' 以
|
||
深入瞭解修訂規格。)
|
||
--^restore 從產生的封存檔案還原先前封存
|
||
的資料。
|
||
|
||
選項：
|
||
|
||
-^c | --^comment 在要建立的封存儲存檔案中設定註解。
|
||
--^file 新封存資料檔案的名稱首碼和 (選用)
|
||
路徑。
|
||
|
||
== CMD_HELP_ARCHIVE ==
|
||
備註：
|
||
|
||
此命令會從儲存庫資料庫擷取資料，並將其存放在
|
||
外部儲存區，節省資料庫空間。
|
||
此命令也會將先前封存的修訂還原至
|
||
儲存庫資料庫 (--^restore)。
|
||
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定修訂規格。
|
||
|
||
執行此命令的使用者必須是 Unity VCS 伺服器管理員
|
||
(儲存庫伺服器擁有者)，才能完成此作業。
|
||
|
||
來自指定修訂的每個資料區段將存放在
|
||
不同檔案中，其名稱以 --^file
|
||
引數定義的值為開頭。該引數可以包含完整的路徑值，包括未來封存檔案
|
||
的首碼，也可以僅包括此首碼值。
|
||
|
||
封存後，指定修訂的資料可以透過兩種方式
|
||
存取：
|
||
|
||
- 從用戶端：用戶端將偵測資料是否已封存，而且
|
||
將提示使用者輸入檔案位置。
|
||
使用者可以藉由建立名為 externaldata.conf 的檔案
|
||
來設定外部資料位置 (在標準設定檔案位置，使用
|
||
適用於 client.conf 檔案的相同規則)，包含
|
||
封存資料所在的路徑。
|
||
|
||
- 從伺服器：使用此方法的使用者不必知道資料是否
|
||
封存，因為伺服器將會明確地解析
|
||
要求。若要執行此作業，管理員將會在伺服器目錄中
|
||
建立名為 externaldata.conf 的檔案，並填入
|
||
封存磁碟機所在的路徑。
|
||
|
||
若要取消封存 (還原) 修訂 (或修訂集合)，用戶端必須要能夠
|
||
存取封存的檔案。因此，無法取消封存
|
||
伺服器 (方法 2) 所解析的資料，因為用戶端
|
||
將無法將該資料識別為已封存。如果使用方法 2，若要
|
||
成功取消封存，管理員必須先編輯 externaldata.conf
|
||
伺服器檔案，才能移除必須取消封存之
|
||
封存檔案的存取權。
|
||
|
||
設定 PLASTICEDITOR 環境變數，以指定要輸入註解
|
||
的編輯器。
|
||
|
||
範例：
|
||
|
||
cm ^archive bigfile.zip#^br:/main
|
||
(在分支 'main' 中封存 'bigfile.zip' 的最後一個修訂。)
|
||
|
||
cm ^archive ^rev:myfile.pdf#^cs:2 -^c="大型 pdf 檔案" --^file=c:\arch_files\arch
|
||
(封存 'c:\archived_files' 資料夾中對 myfile.pdf 的變更集 2
|
||
的修訂。封存檔案名稱將以 'arch' 為開頭 (例如，arch_11_56)。)
|
||
|
||
cm ^find "^revs ^where ^size > 26214400" --^format="{^item}#{^branch}" \
|
||
--^nototal | cm ^archive --^comment="volume00" --^file="volume00" -
|
||
(將所有大於 25Mb 的所有檔案封存在名稱以 'volume00' 為開頭
|
||
的檔案中。)
|
||
|
||
cm ^find "^revs ^where ^size > 26214400 ^and ^archived='true'" \
|
||
--^format="{^item}#{^branch}" --^nototal | cm ^archive --^restore
|
||
(還原大於 25Mb 的所有封存檔案。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE ==
|
||
可讓使用者管理屬性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE ==
|
||
用法：
|
||
|
||
cm ^attribute | ^att <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^set
|
||
^unset
|
||
^rename
|
||
^edit
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^attribute <命令> --^usage
|
||
cm ^attribute <命令> --^help
|
||
|
||
== CMD_HELP_ATTRIBUTE ==
|
||
範例：
|
||
|
||
cm ^attribute ^create 狀態
|
||
cm ^attribute ^set ^att:status ^br:/main/SCM105 未解決
|
||
cm ^attribute ^unset ^att:status ^br:/main/SCM105
|
||
cm ^attribute ^delete ^att:status
|
||
cm ^attribute ^rename ^att:status "組建狀態"
|
||
cm ^attribute ^edit ^att:status "CI 管線中的任務狀態"
|
||
|
||
== CMD_DESCRIPTION_CHANGELIST ==
|
||
分組變更清單中暫止的變更。
|
||
|
||
== CMD_USAGE_CHANGELIST ==
|
||
用法：
|
||
|
||
a) 變更清單物件的管理：
|
||
|
||
cm ^changelist | ^clist [--^symlink]
|
||
(顯示所有變更清單。)
|
||
|
||
cm ^changelist | ^clist ^add <變更清單_名稱>
|
||
[<變更清單_描述>] [--^persistent | --^notpersistent] [--^symlink]
|
||
(建立變更清單。)
|
||
|
||
cm ^changelist | ^clist ^rm <變更清單_名稱> [--^symlink]
|
||
(移除選取的變更清單。如果此變更清單包含暫止的變更，
|
||
則這些將移動至 ^default 變更清單。)
|
||
|
||
cm ^changelist | ^clist ^edit <變更清單_名稱> [<動作_名稱> <動作_值>]
|
||
[--^persistent | --^notpersistent] [--^symlink]
|
||
(編輯選取的變更清單。)
|
||
|
||
b) 管理指定變更清單的內容：
|
||
|
||
cm ^changelist | ^clist <變更清單_名稱> (^add | ^rm) <路徑_名稱>[ ...]
|
||
[--^symlink]
|
||
(藉由新增 ('^add') 或移除 ('^rm')
|
||
符合指定路徑名稱的變更，新增選取的變更清單。使用空格
|
||
分隔路徑_名稱。使用雙引號 (" ") 指定含空格的
|
||
路徑。路徑狀態必須是 '^Added' 或 '^Checked-out'。)
|
||
|
||
選項：
|
||
|
||
變更清單_名稱 變更清單的名稱。
|
||
變更清單_描述 變更清單的描述。
|
||
動作_名稱 選擇 '^rename' 或 '^description' 以編輯
|
||
變更清單。
|
||
動作_值 編輯變更清單時，套用新名稱或
|
||
新描述。
|
||
--^persistent 即使簽入或復原變更清單的內容，變更清單
|
||
仍將保留工作區中。
|
||
--^notpersistent (預設) 即使簽入或復原變更清單的內容，
|
||
變更清單也不會保留在
|
||
工作區中。
|
||
--^symlink 將作業套用至符號連結，而不是套用至
|
||
目標。
|
||
|
||
== CMD_HELP_CHANGELIST ==
|
||
備註：
|
||
|
||
'^changelist' 命令會處理工作區暫止的變更清單以及
|
||
變更清單中包含的變更。
|
||
|
||
範例：
|
||
|
||
cm ^changelist
|
||
(顯示目前工作區變更清單。)
|
||
|
||
cm ^changelist ^add 組態_變更 "dotConf 檔案" --^persistent
|
||
(建立名稱為 '組態_變更' 且描述為 'dotConf 檔案'
|
||
的新變更清單，一旦暫止的變更清單已簽入或已復原，
|
||
該變更清單都將持續保留在目前工作區中。)
|
||
|
||
cm ^changelist ^edit 組態_變更 ^rename 組態_檔案 --^notpersistent
|
||
(編輯名稱為 '組態_變更' 的變更清單，並將其重新命名為
|
||
'組態_檔案'。此外，它會將變更清單轉變成「非持續」。)
|
||
|
||
cm ^changelist ^edit 組態_變更 --^notpersistent
|
||
(編輯名稱為 '組態_變更' 的變更清單，並將它轉變成「非持續」。)
|
||
|
||
cm ^changelist ^rm 組態_檔案
|
||
(將暫止的變更清單 '組態_檔案' 從目前工作區中移除。)
|
||
|
||
cm ^changelist 組態_檔案 ^add foo.conf
|
||
(將檔案 'foo.conf' 新增至 '組態_檔案' 變更清單。)
|
||
|
||
cm ^changelist 組態_檔案 ^rm foo.conf readme.txt
|
||
(將檔案 'foo.conf' 和 'readme.txt' 從 '組態_檔案' 變更清單中移除，
|
||
並將檔案移動至系統預設變更清單。)
|
||
|
||
== CMD_DESCRIPTION_CHANGESET ==
|
||
在變更集執行進階操作。
|
||
|
||
== CMD_USAGE_CHANGESET ==
|
||
用法：
|
||
|
||
cm ^changeset <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^move | ^mv
|
||
^delete | ^rm
|
||
^editcomment | ^edit
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^changeset <命令> --^usage
|
||
cm ^changeset <命令> --^help
|
||
|
||
== CMD_HELP_CHANGESET ==
|
||
範例：
|
||
|
||
cm ^changeset ^move ^cs:15@myrepo ^br:/main/scm005@myrepo
|
||
cm ^changeset ^delete ^cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_EDITCOMMENT ==
|
||
修改變更集的註解。
|
||
|
||
== CMD_USAGE_CHANGESET_EDITCOMMENT ==
|
||
用法：
|
||
|
||
cm ^changeset ^editcomment | ^edit <變更集規格> <新_註解>
|
||
|
||
選項：
|
||
|
||
變更集規格 將編輯註解的目標變更集。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
|
||
規格。)
|
||
新_註解 將新增至鎖定目標之變更集的
|
||
新註解。
|
||
|
||
== CMD_HELP_CHANGESET_EDITCOMMENT ==
|
||
備註：
|
||
|
||
- 鎖定目標的變更集規格必須有效。
|
||
|
||
範例：
|
||
|
||
cm ^changeset ^editcomment ^cs:15@myrepo "我忘記新增簽入詳細資料"
|
||
cm ^changeset ^edit ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
|
||
"此註解文字將取代先前的註解文字。"
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_MOVE ==
|
||
將變更集及其所有下層移動至不同的分支。
|
||
|
||
== CMD_USAGE_CHANGESET_MOVE ==
|
||
用法：
|
||
|
||
cm ^changeset ^move | ^mv <變更集規格> <分支規格>
|
||
|
||
選項：
|
||
|
||
變更集規格 要移動至不同分支的第一個變更集。相同
|
||
分支中的所有下層變更集也會
|
||
由命令鎖定目標。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
|
||
規格。)
|
||
分支規格 存放鎖定目標之變更集的目標
|
||
分支。須為空白或不存在；如果
|
||
目的地分支不存在，將由命令
|
||
建立一個。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支
|
||
規格。)
|
||
|
||
== CMD_HELP_CHANGESET_MOVE ==
|
||
備註：
|
||
|
||
- 鎖定目標的變更集規格必須有效。
|
||
- 目的地分支須為空白或不存在。
|
||
- 如果目的地分支不存在，將會建立一個。
|
||
- 合併連結將保持不變，因為分支不會影響這些連結。
|
||
|
||
範例：
|
||
|
||
cm ^changeset ^move ^cs:15@myrepo ^br:/main/scm005@myrepo
|
||
cm ^changeset ^move ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a ^br:/hotfix/TL-352
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_DELETE ==
|
||
從儲存庫中刪除變更集。
|
||
|
||
== CMD_USAGE_CHANGESET_DELETE ==
|
||
用法：
|
||
|
||
cm ^changeset ^delete | ^rm <變更集規格>
|
||
|
||
選項：
|
||
|
||
變更集規格 要移除的目標變更集。必須滿足
|
||
某些特定條件。如需詳細資訊，請參閱備註。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
|
||
規格。)
|
||
|
||
== CMD_HELP_CHANGESET_DELETE ==
|
||
備註：
|
||
|
||
- 目標變更集必須是其分支的最後一個。
|
||
- 目標變更集不可為任何其他變更集的上層。
|
||
- 目標變更集不能是合併連結的來源，也不能是
|
||
作為來源之間隔合併的一部分。
|
||
- 沒有標籤必須套用至目標變更集。
|
||
- 目標變更集不得為根變更集 ('^cs:0')
|
||
|
||
範例：
|
||
|
||
cm ^changeset ^rm ^cs:4525@myrepo@myserver
|
||
cm ^changeset ^delete ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a
|
||
|
||
== CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
|
||
變更使用者密碼 (UP)。
|
||
|
||
== CMD_USAGE_CHANGEUSERPASSWORD ==
|
||
用法：
|
||
|
||
cm ^changepassword | ^passwd
|
||
|
||
== CMD_HELP_CHANGEUSERPASSWORD ==
|
||
備註：
|
||
|
||
此命令只有在安全性設定為 UP (使用者/密碼) 時
|
||
才可使用。如需詳細資訊，請參閱《管理指南》。
|
||
需要舊密碼與新密碼。
|
||
|
||
範例：
|
||
|
||
cm ^passwd
|
||
|
||
== CMD_DESCRIPTION_CHECKCONNECTION ==
|
||
檢查與伺服器的連線。
|
||
|
||
== CMD_USAGE_CHECKCONNECTION ==
|
||
用法：
|
||
|
||
cm ^checkconnection | ^cc
|
||
|
||
== CMD_HELP_CHECKCONNECTION ==
|
||
備註：
|
||
|
||
- 此命令會傳回訊息，指出設定的 Unity VCS
|
||
伺服器是否具備有效連線。
|
||
- 此命令會檢查設定的使用者是否有效。它也會
|
||
檢查與伺服器的版本相容性。
|
||
|
||
== CMD_DESCRIPTION_CHECKDB ==
|
||
檢查儲存庫完整性。
|
||
|
||
== CMD_USAGE_CHECKDB ==
|
||
用法：
|
||
|
||
cm ^checkdatabase | ^chkdb [<儲存庫伺服器規格> | <儲存庫規格>]
|
||
|
||
使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺服器與儲存庫規格。
|
||
|
||
== CMD_HELP_CHECKDB ==
|
||
備註：
|
||
|
||
- 如果未指定儲存庫伺服器規格，也未指定儲存庫規格，
|
||
將會在 client.conf 檔案中指定的伺服器中執行檢查。
|
||
|
||
範例：
|
||
|
||
cm ^checkdatabase ^repserver:localhost:8084
|
||
cm ^chkdb ^rep:default@localhost:8084
|
||
|
||
== CMD_DESCRIPTION_CHECKIN ==
|
||
在此儲存庫中儲存變更。
|
||
|
||
== CMD_USAGE_CHECKIN ==
|
||
用法：
|
||
|
||
cm ^checkin | ^ci [<項目_路徑>[ ...]]
|
||
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
|
||
[--^all|-^a] [--^applychanged] [--^private] [--^update] [--^symlink]
|
||
[--^noshowchangeset]
|
||
[--^machinereadable [--^startlineseparator=<分隔符號>]
|
||
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
|
||
|
||
選項：
|
||
|
||
項目_路徑 要簽入的項目。使用雙引號 (" ")
|
||
指定含空格的路徑。使用空格
|
||
分隔項目路徑。
|
||
使用 . 將簽入套用至目前目錄。
|
||
-^c 將指定的註解套用至
|
||
簽入作業中建立的變更集。
|
||
-^commentsfile 將指定檔案中的註解套用至
|
||
簽入作業中建立的變更集。
|
||
--^all | -^a 指定路徑上在本地變更、移動和刪除的項目
|
||
也包括在內。
|
||
--^applychanged 將簽入作業套用至
|
||
工作區中偵測到的變更項目，以及簽出
|
||
項目。
|
||
--^private 工作區中偵測到的私人項目也
|
||
包括在內。
|
||
--^update 如果最終發生此情況，
|
||
會自動處理更新合併。
|
||
--^symlink 將簽入作業套用至符號連結，而不是
|
||
套用至目標。
|
||
--^noshowchangeset 不列印結果變更集。
|
||
--^machinereadable 以容易解析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何起始。
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何結束。
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，指定應
|
||
如何分隔欄位。
|
||
|
||
== CMD_HELP_CHECKIN ==
|
||
備註：
|
||
|
||
- 如果未指定 <項目_路徑>，簽入會涉及工作區中
|
||
所有暫止的變更。
|
||
- 簽入作業一律會從指定路徑進行遞迴套用。
|
||
- 若要簽入項目：
|
||
- 項目必須受原始程式碼控制。
|
||
- 如果項目是私人的 (未受到原始程式碼控制)，則需要有 --^private
|
||
標誌，才能簽入該項目。
|
||
- 必須簽出項目。
|
||
- 如果項目已變更，但未簽出，則不一定要有 --^applychanged 標誌，
|
||
除非 <項目_路徑> 是目錄，或包含
|
||
萬用字元 ('*')。
|
||
|
||
修訂內容應該與先前修訂不同，才能
|
||
簽入。
|
||
|
||
設定 PLASTICEDITOR 環境變數，以指定要輸入
|
||
註解的編輯器。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
'^checkin' 命令可從 stdin 讀取路徑。若要執行此操作，可傳遞單一
|
||
破折號「-」來完成。
|
||
範例：cm ^checkin -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線以指定要簽入的檔案。
|
||
範例：
|
||
dir /S /B *.c | cm ^checkin --^all -
|
||
(在 Windows 中，簽入工作區中所有 .c 檔案。)
|
||
|
||
範例：
|
||
|
||
cm ^checkin file1.txt file2.txt
|
||
(簽入 'file1.txt' 和 'file2.txt' 簽出檔案。)
|
||
|
||
cm ^checkin .-^commentsfile=mycomment.txt
|
||
(簽入目前目錄，並在 'mycomment.txt' 檔案中
|
||
設定註解。)
|
||
|
||
cm ^checkin 連結 --^symlink
|
||
(簽入 '連結' 檔案，而非目標；適用於 UNIX
|
||
環境。)
|
||
|
||
cm ^ci file1.txt -^c="我的註解"
|
||
(簽入 'file1.txt' 並包含註解。)
|
||
|
||
cm ^status --^short --^compact --^changelist=暫止_待_檢閱 | cm ^checkin -
|
||
(列出變更清單中名稱為 '暫止_待_檢閱' 的路徑，並將此清單
|
||
重新導向簽入命令的輸入。)
|
||
|
||
cm ^ci .--^machinereadable
|
||
(簽入目前目錄，並以簡化、易於剖析
|
||
的格式來列印結果。)
|
||
|
||
cm ^ci .--^machinereadable --^startlineseparator=">" --^endlineseparator="<" --^fieldseparator=","
|
||
(簽入目前目錄，並以簡化、易於剖析的格式
|
||
來列印結果，使用指定的字串起始行
|
||
和結尾行，以及分隔欄位。)
|
||
|
||
== CMD_DESCRIPTION_CHECKOUT ==
|
||
將檔案標示為準備好修改。
|
||
|
||
== CMD_USAGE_CHECKOUT ==
|
||
用法：
|
||
|
||
cm ^checkout | ^co [<項目_路徑>[ ...]] [-^R | -^r | --^recursive]
|
||
[--^format=<字串_格式>]
|
||
[--^errorformat=<字串_格式>] [--^resultformat=<字串_格式>]
|
||
[--^silent] [--^symlink] [--^ignorefailed]
|
||
[--^machinereadable [--^startlineseparator=<分隔符號>]
|
||
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
|
||
|
||
選項：
|
||
|
||
項目_路徑 要簽出的項目。使用雙引號 (" ")
|
||
指定含空格的路徑。使用空格
|
||
分隔項目路徑。
|
||
使用 . 將簽出套用至目前目錄。
|
||
-^R 遞迴簽出檔案。
|
||
--^format 以指定的
|
||
格式擷取輸出進度訊息。如需詳細資訊，請查看範例。
|
||
--^errorformat 以指定的
|
||
格式擷取錯誤訊息 (如果有的話)。如需詳細資訊，請查看範例。
|
||
--^resultformat 以指定的格式擷取輸出
|
||
結果訊息。如需詳細資訊，請查看範例。
|
||
--^silent 完全不顯示任何輸出。
|
||
--^symlink 將簽出作業套用至符號連結，而非
|
||
套用至目標。
|
||
--^ignorefailed 如果無法鎖定項目 (無法執行獨佔簽出
|
||
)，則會在沒有項目的情況下，
|
||
繼續進行簽出作業。
|
||
--^machinereadable 以容易解析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何起始。
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何結束。
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，指定應
|
||
如何分隔欄位。
|
||
|
||
== CMD_HELP_CHECKOUT ==
|
||
備註：
|
||
|
||
若要簽出項目：
|
||
- 項目必須受原始程式碼控制。
|
||
- 必須簽入項目。
|
||
|
||
如果在伺服器上已設定鎖定 (lock.conf 存在)，那麼每次在路徑上
|
||
發生簽出時，Unity VCS 會檢查其是否符合任何規則，如果符合，
|
||
該路徑會處於獨佔簽出 (已鎖定)，如此一來，就沒有人
|
||
可以同時簽出。
|
||
您可以使用 'cm ^lock ^list' 以取得伺服器中的所有鎖定。
|
||
如需詳細資訊，請參閱《管理指南》：
|
||
https://www.plasticscm.com/download/help/adminguide
|
||
|
||
格式字串會將預留位置 '{0}' 取代為待簽出項目
|
||
的路徑。請查看範例，瞭解使用方法。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
'^checkout' 命令可從 stdin 讀取路徑。若要執行此操作，可傳遞單一
|
||
破折號「-」來完成。
|
||
範例：cm ^checkout -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線以指定要簽出的檔案。
|
||
範例：
|
||
dir /S /B *.c | cm ^checkout -
|
||
(在 Windows 中，簽出工作區中所有 .c 檔案。)
|
||
|
||
範例：
|
||
|
||
cm ^checkout file1.txt file2.txt
|
||
(簽出 'file1.txt' 和 'file2.txt' 檔案。)
|
||
|
||
cm ^co *.txt
|
||
(簽出所有 txt 檔案。)
|
||
|
||
cm ^checkout .
|
||
(簽出目前目錄。)
|
||
|
||
cm ^checkout -^R c:\workspace\src
|
||
(遞迴簽出 'src' 資料夾。)
|
||
|
||
cm ^co file.txt --^format="正在簽出項目 {0}"
|
||
--^errorformat="簽出項目 {0} 時發生錯誤" /
|
||
--^resultformat="項目 {0} 已簽出"
|
||
(使用指定的格式字串簽出 'file.txt'，
|
||
以顯示作業的進度、結果和錯誤。)
|
||
|
||
cm ^checkout 連結 --^symlink
|
||
(簽出 '連結' 檔案，而非目標；適用於 UNIX
|
||
環境。)
|
||
|
||
cm ^checkout .-^R --^ignorefailed
|
||
(遞迴簽出目前資料夾，忽略無法簽出
|
||
的檔案。)
|
||
|
||
cm ^co .--^machinereadable --^startlineseparator=">"
|
||
(簽出目前目錄，以簡化、易於剖析的格式來列印結果，
|
||
並使用指定的字串起始行。)
|
||
|
||
== CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
|
||
檢查選擇器的語法。
|
||
|
||
== CMD_USAGE_CHECKSELECTORSYNTAX ==
|
||
用法：
|
||
|
||
cm ^checkselectorsyntax | ^css --^file=<選擇器_檔案>
|
||
(檢查選擇器檔案語法。)
|
||
|
||
^cat <選擇器_檔案> | cm ^checkselectorsyntax | ^css -
|
||
(Unix。從標準輸入檢查選擇器檔案。)
|
||
|
||
^type <選擇器_檔案> | cm ^checkselectorsyntax | ^css -
|
||
(Windows。從標準輸入檢查選擇器檔案。)
|
||
|
||
|
||
--^file 要從中讀取選擇器的檔案。
|
||
|
||
== CMD_HELP_CHECKSELECTORSYNTAX ==
|
||
備註：
|
||
|
||
此命令會讀取檔案或標準輸入上的選擇器，並檢查其
|
||
是否為有效語法。如果語法檢查失敗，原因會
|
||
列印在標準輸出上。
|
||
|
||
範例：
|
||
|
||
cm ^checkselectorsyntax --^file=myselector.txt
|
||
(檢查 'myselector.txt' 檔案的語法。)
|
||
|
||
^cat myselector.txt | cm ^checkselectorsyntax
|
||
(從標準輸入檢查 'myselector.txt' 的語法。)
|
||
|
||
== CMD_DESCRIPTION_CHANGEREVISIONTYPE ==
|
||
變更項目修訂類型 (二進位或文字)。
|
||
|
||
== CMD_USAGE_CHANGEREVISIONTYPE ==
|
||
用法：
|
||
|
||
cm ^changerevisiontype | ^chgrevtype | ^crt <項目_路徑>[ ...]--^type=(^bin | ^txt)
|
||
|
||
項目_路徑 要變更修訂類型的項目。使用雙引號 (" ")
|
||
指定含空格的路徑。使用空格
|
||
分隔項目路徑。
|
||
--^type 目標修訂類型。選擇 '^bin' 或 '^txt'。
|
||
|
||
== CMD_HELP_CHANGEREVISIONTYPE ==
|
||
備註：
|
||
|
||
此命令只能套用至檔案，而無法套用至目錄。
|
||
指定的類型必須是系統支援的類型：'^bin' 或 '^txt' (二進位
|
||
或文字)。
|
||
|
||
範例：
|
||
|
||
cm ^changerevisiontype c:\workspace\file.txt --^type=^txt
|
||
(將 'file.txt' 修訂類型變更為文字。)
|
||
|
||
cm ^chgrevtype comp.zip "image file.jpg" --^type=^bin
|
||
(將 'comp.zip' 和 "image file.jpg" 修訂類型變更為二進位。)
|
||
|
||
cm ^crt *.* --^type=^txt
|
||
(將所有檔案的修訂類型變更為文字。)
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_EDIT ==
|
||
編輯觸發器。
|
||
|
||
== CMD_USAGE_TRIGGER_EDIT ==
|
||
用法：
|
||
|
||
cm ^trigger | ^tr ^edit <子類型_類型> <位置_號碼>
|
||
[--^position=<新_位置>]
|
||
[--^name=<新_名稱>] [--^script=<指令碼_路徑>]
|
||
[--^filter=<字串_篩選>] [--^server=<儲存庫伺服器規格>]
|
||
|
||
子類型_類型 觸發器執行與觸發器作業。
|
||
輸入 'cm ^showtriggertypes' 以查看觸發器
|
||
類型的清單。
|
||
位置_號碼 待修改之觸發器所佔的位置。
|
||
|
||
選項：
|
||
|
||
--^position 指定觸發器的新位置。
|
||
此位置不得由其他相同類型的
|
||
觸發器使用。
|
||
--^name 指定觸發器的新名稱。
|
||
--^script 指定觸發器指令碼的新執行路徑。
|
||
如果指令碼開頭為 "^webtrigger"，該指令碼將
|
||
視為 Web 觸發器。如需進一步的詳細資料，
|
||
請參閱備註。
|
||
--^filter 僅檢查符合已指定篩選條件的項目。
|
||
--^server 在指定的伺服器上修改觸發器。
|
||
如果未指定任何伺服器，請在用戶端上設定的
|
||
伺服器上執行命令。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解伺服器
|
||
規格。)
|
||
|
||
== CMD_HELP_TRIGGER_EDIT ==
|
||
備註：
|
||
|
||
Web 觸發器：藉由輸入 "^webtrigger <目標-uri>"
|
||
做為觸發器命令，以建立 Web 觸發器。在此情況下，觸發器將對應指定的 URI 來執行 POST 查詢，
|
||
其中要求本文包含具有觸發器環境變數的 JSON
|
||
字典，以及
|
||
指向字串陣列的 INPUT 金鑰。
|
||
|
||
範例：
|
||
|
||
cm ^trigger ^edit ^after-setselector 6 --^name="Backup2 管理員" --^script="/new/path/al/script"
|
||
cm ^tr ^edit ^before-mklabel 7 --^position=4 --^server=myserver:8084
|
||
cm ^trigger ^edit ^after-add 2 --^script="^webtrigger http://myserver.org/api"
|
||
|
||
== CMD_DESCRIPTION_CODEREVIEW ==
|
||
建立、編輯或刪除程式碼檢閱。
|
||
|
||
== CMD_USAGE_CODEREVIEW ==
|
||
用法：
|
||
|
||
cm ^codereview <規格> <標題> [--^status=<狀態_名稱>]
|
||
[--^assignee=<使用者_名稱>] [--^format=<字串_格式>]
|
||
[--^repository=<儲存庫_規格>]
|
||
(建立程式碼檢閱。)
|
||
|
||
cm ^codereview -^e <ID> [--^status=<狀態_名稱>] [--^assignee=<使用者_名稱>]
|
||
[--^repository=<儲存庫_規格>]
|
||
(編輯程式碼檢閱。)
|
||
|
||
cm ^codereview -^d <ID> [ ...][--^repository=<儲存庫_規格>]
|
||
(刪除一或多個程式碼檢閱。)
|
||
|
||
|
||
規格 規格可能是變更集規格或分支規格。
|
||
該規格將會是新程式碼檢閱的目標。(使用
|
||
'cm ^help ^objectspec' 以深入瞭解變更集或
|
||
分支規格。)
|
||
標題 做為新
|
||
程式碼檢閱標題的文字字串。
|
||
ID 程式碼檢閱識別碼。也可以使用
|
||
GUID。
|
||
|
||
選項：
|
||
|
||
-^e 編輯現有程式碼檢閱的參數。
|
||
-^d 刪除一或多個現有的程式碼檢閱。使用
|
||
空格來分隔程式碼檢閱 ID。
|
||
--^status 設定程式碼檢閱的新狀態。如需其他資訊，
|
||
請參閱備註。
|
||
--^assignee 設定程式碼檢閱新的受指派者。
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
其他資訊，請參閱備註。
|
||
--^repository 設定要做為預設使用的儲存庫。(使用
|
||
'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
規格。)
|
||
|
||
== CMD_HELP_CODEREVIEW ==
|
||
備註：
|
||
|
||
此命令可讓使用者管理程式碼檢閱：建立、編輯和刪除
|
||
變更集或分支的程式碼檢閱。
|
||
|
||
若要建立新的程式碼檢閱，需要變更集/分支規格
|
||
和標題。也可以設定初始狀態和受指派者。結果會傳回 ID
|
||
(或 GUID，如果有的話)。
|
||
|
||
若要編輯或刪除現有的程式碼檢閱，需要有目標程式碼檢閱 ID
|
||
(或 GUID)。如果沒有錯誤，則不會顯示任何訊息。
|
||
|
||
狀態參數只能是以下其中之一：^"Under review"
|
||
(預設)、^"Reviewed" 或 ^"Rework required"。
|
||
|
||
儲存庫參數可用於設定預設的工作中
|
||
儲存庫。當使用者想要在與目前工作區相關的伺服器
|
||
不同的伺服器上管理檢閱時，或完全沒有
|
||
目前工作區時，這相當有用。
|
||
|
||
輸出格式自訂化：
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{0} ID
|
||
{1} GUID
|
||
|
||
請注意，'--^format' 參數只有在建立
|
||
新的程式碼檢閱時才會生效。
|
||
|
||
範例：
|
||
|
||
cm ^codereview ^cs:1856@myrepo@myserver:8084 "我的程式碼檢閱" --^assignee=虛設
|
||
cm ^codereview ^br:/main/task001@myrepo@myserver:8084 "我的程式碼檢閱" \
|
||
--^status=^"Rework required" --^assignee=新人 --^format="{^id} -> {^guid}"
|
||
|
||
cm ^codereview 1367 -^e --^assignee=新_受指派者
|
||
cm ^codereview -^e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --^status=已檢閱
|
||
|
||
cm ^codereview -^d 1367 --^repository=myremoterepo@myremoteserver:18084
|
||
cm ^codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -^d
|
||
|
||
== CMD_DESCRIPTION_CRYPT ==
|
||
加密密碼。
|
||
|
||
== CMD_USAGE_CRYPT ==
|
||
用法：
|
||
|
||
cm ^crypt <我的密碼>
|
||
|
||
我的密碼 要加密的密碼。
|
||
|
||
== CMD_HELP_CRYPT ==
|
||
備註：
|
||
|
||
此命令會對傳遞做為引數的指定密碼進行加密。
|
||
其設計目的是加密設定檔案中的密碼，並提高
|
||
安全性。
|
||
|
||
範例：
|
||
|
||
cm ^crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
|
||
(加密資料庫設定檔案中的密碼：'db.conf'。)
|
||
|
||
== CMD_DESCRIPTION_DEACTIVATEUSER ==
|
||
停用授權使用者。
|
||
|
||
== CMD_USAGE_DEACTIVATEUSER ==
|
||
用法：
|
||
|
||
cm ^deactivateuser | ^du <使用者_名稱>[ ...][--^server=<名稱:連接埠>]
|
||
[--^nosolveuser]
|
||
|
||
使用者_名稱 要停用的使用者名稱。使用空格以分隔
|
||
使用者名稱。
|
||
如果是 SID，則需要 '--^nosolveuser'。
|
||
|
||
選項：
|
||
|
||
--^server 在指定的伺服器中停用使用者。
|
||
如果未指定任何伺服器，請在用戶端上設定的
|
||
伺服器上執行命令。
|
||
--^nosolveuser 使用此選項，命令將不會檢查使用者名稱
|
||
是否存在於驗證系統中。此
|
||
<使用者_名稱> 必須是使用者 SID。
|
||
|
||
== CMD_HELP_DEACTIVATEUSER ==
|
||
備註：
|
||
|
||
此命令會將使用者設為非作用中，禁止該使用者使用
|
||
Unity VCS。
|
||
|
||
如需啟動 Unity VCS 使用者的詳細資訊，請參閱 'cm ^activateuser'
|
||
命令。
|
||
|
||
此命令會檢查使用者是否存在於基礎驗證系統 (例如，
|
||
ActiveDirectory、LDAP、使用者/密碼...)。
|
||
若要強制停用驗證系統中不再存在的使用者，
|
||
您可以使用 '--^nosolveuser' 選項。
|
||
|
||
範例：
|
||
|
||
cm ^deactivateuser john
|
||
cm ^du peter "mary collins"
|
||
cm ^deactivateuser john --^server=myserver:8084
|
||
cm ^deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --^nosolveuser
|
||
|
||
== CMD_DESCRIPTION_DIFF ==
|
||
顯示檔案、變更集和標籤之間的差異。
|
||
|
||
== CMD_USAGE_DIFF ==
|
||
用法：
|
||
|
||
cm ^diff <變更集規格> | <標籤規格> | <擱置規格> [<變更集規格> | <標籤規格> | <擱置規格>]
|
||
[<路徑>]
|
||
[--^added] [--^changed] [--^moved] [--^deleted]
|
||
[--^repositorypaths] [--^download=<下載_路徑>]
|
||
[--^encoding=<名稱>]
|
||
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
|
||
[--^clean]
|
||
[--^format=<字串_格式>] [--^dateformat=<字串_格式>]
|
||
|
||
顯示「來源」變更集或擱置集與
|
||
「目的地」變更集或擱置集之間的差異。可使用變更集或標籤規格
|
||
來指定變更集。
|
||
在提供兩種規格的情況下，第一個是差異的「來源」；
|
||
第二個是「目的地」。
|
||
在僅提供一種規格的情況下，「來源」將會是指定
|
||
「目的地」的上層變更集。
|
||
如果已指定選用的路徑，[差異比對] 視窗將會啟動，以顯示
|
||
該檔案兩種修訂之間的差異。
|
||
|
||
cm ^diff <修訂規格1> <修訂規格2>
|
||
|
||
顯示一對修訂之間的差異。差異顯示在
|
||
[差異比對] 視窗中。指定的第一個修訂將出現
|
||
在左側。
|
||
|
||
cm ^diff <分支規格> [--^added] [--^changed] [--^moved] [--^deleted]
|
||
[--^repositorypaths] [--^download=<下載_路徑>]
|
||
[--^encoding=<名稱>]
|
||
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
|
||
[--^clean]
|
||
[--^format=<字串_格式>] [--^dateformat=<字串_格式>]
|
||
[--^fullpaths | --^fp]
|
||
|
||
顯示分支差異。
|
||
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
選項：
|
||
|
||
--^added 僅列印包含新增至儲存庫之
|
||
項目的差異。
|
||
--^changed 僅列印包含變更項目
|
||
的差異。
|
||
--^moved 僅列印包含已移動或已重新命名
|
||
項目的差異。
|
||
--^deleted 僅列印包含已刪除項目
|
||
的差異。
|
||
|
||
如果未指定 '--^added'、'--^changed'、'--^moved' 或 '--^deleted'，
|
||
則此命令會列印所有差異。
|
||
'^A' 表示已新增項目。
|
||
'^C' 表示已變更項目。
|
||
'^D' 表示已刪除項目。
|
||
'^M' 表示已移動項目。左側項目是原始的，
|
||
右側項目是目的地。
|
||
|
||
--^repositorypaths 列印儲存庫路徑，而非工作區路徑。
|
||
(此選項會覆寫 '--^fullpaths' 選項。)
|
||
--^download 儲存指定的輸出路徑中的
|
||
差異內容。
|
||
--^encoding 指定輸出編碼，例如：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^ignore 設定指定的比較方法。
|
||
如需詳細資訊，請參閱備註。
|
||
--^clean 不考慮因合併而產生的差異，
|
||
僅考慮簡單簽入所建立
|
||
的差異。
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^dateformat 用於輸出日期的格式。
|
||
--^fullpaths, --^fp 如果可能，會強制列印檔案和目錄的
|
||
完整工作區路徑。
|
||
|
||
== CMD_HELP_DIFF ==
|
||
備註：
|
||
|
||
比較方法:
|
||
^eol 忽略行尾差異。
|
||
^whitespaces 忽略空格差異。
|
||
^"eol&whitespaces" 忽略行尾和空格差異。
|
||
^none 偵測行尾和空格差異。
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的參數如下所示：
|
||
{^path} 項目路徑。
|
||
{^date} 變更日期/時間。
|
||
{^owner} 變更作者。
|
||
{^revid} 差異中視為目的地之修訂的
|
||
修訂 ID。
|
||
{^parentrevid} 差異中視為目的地之修訂上層的
|
||
修訂 ID。
|
||
{^baserevid} 差異中視為來源之修訂的
|
||
修訂 ID。
|
||
{^srccmpath} 移動項目 (移動作業) 之前的伺服器路徑。
|
||
{^dstcmpath} 移動項目 (移動作業) 之後的伺服器路徑。
|
||
{^type} 項目類型：
|
||
^D 目錄、
|
||
^B 二進位檔案、
|
||
^F 文字檔、
|
||
^S 符號連結、
|
||
^X Xlink。
|
||
{^repository} 項目的儲存庫。
|
||
{^status} 項目狀態：
|
||
^A 已新增、
|
||
^D 已刪除、
|
||
^M 已移動、
|
||
^C 已變更。
|
||
{^fsprotection} 顯示項目權限 (Linux/Mac chmod)。
|
||
{^srcfsprotection} 顯示上層修訂項目權限。
|
||
{^newline} 插入新行。
|
||
|
||
'^revid' 的說明：
|
||
對於已新增的項目，'^baserevid' 和 '^parentrevid' 將會是 -1，因為
|
||
在此情況下，不存在任何先前修訂。
|
||
對於已刪除的項目，'^revid' 是來源修訂的 ID，而且
|
||
'^baserevid' 將會是 -1，因為沒有任何目的地修訂。
|
||
對於 Xlinks，'^baserevid' 和 '^parentrevid' 一律為 -1。
|
||
|
||
範例：
|
||
|
||
比較分支：
|
||
|
||
cm ^diff ^br:/main/task001
|
||
cm ^diff ^br:/main/task001 \doc\readme.txt
|
||
|
||
比較變更集樹狀目錄：
|
||
|
||
cm ^diff 19
|
||
cm ^diff 19 25
|
||
cm ^diff ^cs:19 ^cs:25 --^format="{^path} {^parentrevid}"
|
||
cm ^diff ^cs:19 ^cs:23 --^format="{^date} {^path}" --^dateformat="yy/dd/MM HH:mm:ss"
|
||
cm ^diff ^cs:19 ^cs:23 --^changed
|
||
cm ^diff ^cs:19 ^cs:23 --^repositorypaths
|
||
cm ^diff ^cs:19 ^cs:23 --^download="D:\temp"
|
||
cm ^diff ^cs:19 ^cs:23 --^clean
|
||
cm ^diff ^cs:19 ^cs:23 \doc\readme.txt
|
||
|
||
比較標籤樹狀目錄：
|
||
|
||
cm ^diff ^lb:FirstReleaseLabel ^lb:SecondReleaseLabel
|
||
cm ^diff ^lb:tag_193.2 ^cs:34214
|
||
cm ^diff ^cs:31492 ^lb:tag_193.2
|
||
|
||
比較擱置樹狀目錄：
|
||
|
||
cm ^diff ^sh:2
|
||
cm ^diff ^sh:2 ^sh:4
|
||
|
||
比較修訂規格：
|
||
cm ^diff ^rev:readme.txt#^cs:19 ^rev:readme.txt#^cs:20
|
||
cm ^diff ^serverpath:/doc/readme.txt#^cs:19@myrepo \
|
||
^serverpath:/doc/readme.txt#^br:/main@myrepo@localhost:8084
|
||
|
||
== CMD_DESCRIPTION_DIFFMETRICS ==
|
||
顯示兩個修訂之間的不同指標。
|
||
|
||
== CMD_USAGE_DIFFMETRICS ==
|
||
用法：
|
||
|
||
cm ^diffmetrics | ^dm <修訂規格1> <修訂規格2> [--^format=<字串_格式>]
|
||
[--^encoding=<名稱>]
|
||
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
|
||
|
||
修訂規格 用於比較的修訂。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解修訂規格。)
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^encoding 指定輸出編碼，例如：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^ignore 設定指定的比較方法。
|
||
如需詳細資訊，請參閱備註。
|
||
|
||
== CMD_HELP_DIFFMETRICS ==
|
||
備註：
|
||
|
||
指標為：已變更、已新增和已刪除的行數。
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{0} 已變更的行數。
|
||
{1} 已新增的行數。
|
||
{2} 已刪除的行數。
|
||
|
||
範例：
|
||
|
||
cm ^diffmetrics file.txt#^cs:2 file.txt#^br:/main/scm0211 \
|
||
--^format="有 {0} 個已變更、{1} 個已新增和 {2} 已刪除的行。"
|
||
(擷取格式化的 diffmetrics 結果。)
|
||
|
||
cm ^dm file.txt#^cs:2 file.txt#^cs:3 --^encoding=utf-8 --^ignore=^whitespaces
|
||
|
||
== CMD_DESCRIPTION_FASTEXPORT ==
|
||
以快速匯出格式匯出儲存庫。
|
||
|
||
== CMD_USAGE_FASTEXPORT ==
|
||
用法：
|
||
|
||
cm ^fast-export | ^fe <儲存庫規格> <快速匯出檔案>
|
||
[--^import-marks=<標記_檔案>]
|
||
[--^export-marks=<標記_檔案>]
|
||
[--^branchseparator=<字元_分隔符號>]
|
||
[--^nodata] [--^from=<變更集 ID>] [--^to=<變更集 ID>]
|
||
|
||
選項:
|
||
|
||
儲存庫規格 將從中匯出資料的儲存庫。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫規格。)
|
||
快速匯出檔案 內含儲存庫資料的檔案，格式為 Git
|
||
快速匯出。
|
||
--^import-marks 用於增量匯入的標記檔案。此檔案
|
||
先前已由 '--^export-marks' 匯出。將不會匯入此檔案中
|
||
描述的變更集，
|
||
因為這些變更集先前已匯入。
|
||
--^export-marks 將儲存已匯入變更集的檔案。
|
||
此檔案用於之後進行的快速匯入，向已匯入的變更集
|
||
發出訊號。
|
||
--^branchseparator Unity VCS 使用「/」做為分支階層中的預設
|
||
分隔符號。此選項允許使用字元做為階層分隔符號，
|
||
因此 main-task-sub 在 Unity VCS 中會描繪成
|
||
/main/task/sub。
|
||
--^nodata 匯出儲存庫但不包含資料。此命令
|
||
對於檢查匯出是否將正常執行非常有用。
|
||
--^from 從特定變更集匯出。
|
||
--^to 匯出至特定變更集。
|
||
|
||
== CMD_HELP_FASTEXPORT ==
|
||
備註：
|
||
|
||
- 若要將 Unity VCS 儲存庫匯入至 Git，請使用命令，例如：
|
||
^cat repo.fe.00 | ^git ^fast-import --^export-marks=marks.git --^import-marks=marks.git
|
||
|
||
- 支援使用包含先前匯入之變更集的標記檔案
|
||
('--^import-marks' 和 '--^export-marks'
|
||
檔案) 進行增量匯出。
|
||
這表示只有在先前快速匯出中未匯出的
|
||
新變更集才會匯出。
|
||
|
||
範例：
|
||
|
||
cm ^fast-export repo@localhost:8087 repo.fe.00 --^import-marks=marks.cm \
|
||
--^export-marks=marks.cm
|
||
(將本地伺服器中的儲存庫 'repo' 匯出至 Git 快速匯出格式的
|
||
'repo.fe.00' 檔案，並建立標記檔案，以便之後執行
|
||
增量匯出。)
|
||
|
||
cm ^fast-export repo@localhost:8087 repo.fe.00 --^from=20
|
||
(從變更集 '20' 將本地伺服器中的儲存庫 'repo' 以 Git 快速匯出格式
|
||
匯出至 'repo.fe.00'檔案。)
|
||
|
||
== CMD_DESCRIPTION_FASTIMPORT ==
|
||
將 Git 快速匯出資料匯入儲存庫。
|
||
|
||
== CMD_USAGE_FASTIMPORT ==
|
||
用法：
|
||
|
||
cm ^fast-import | ^fi <儲存庫規格> <快速匯出檔案>
|
||
[--^import-marks=<標記_檔案>]
|
||
[--^export-marks=<標記_檔案>]
|
||
[--^stats] [--^branchseparator=<字元_分隔符號>]
|
||
[--^nodata] [--^ignoremissingchangesets] [--^mastertomain]
|
||
|
||
選項：
|
||
|
||
儲存庫規格 將匯入資料的
|
||
儲存庫。如果儲存庫先前
|
||
不存在，則會建立一個儲存庫。(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
儲存庫規格。)
|
||
快速匯出檔案 內含儲存庫資料的檔案，格式為 Git
|
||
快速匯出。
|
||
--^import-marks 用於增量匯入的標記檔案。
|
||
此檔案
|
||
先前已由 '--^export-marks' 匯出。將不會匯入此檔案中
|
||
描述的變更集，
|
||
因為這些變更集先前已匯入。
|
||
--^export-marks 將儲存已匯入變更集的
|
||
檔案。此檔案用於之後進行的
|
||
快速匯入，向已匯入的
|
||
變更集發出訊號。
|
||
--^stats 列印關於匯入過程的一些統計資料。
|
||
--^branchseparator Unity VCS 使用「/」做為分支階層中的預設
|
||
分隔符號。此選項允許使用
|
||
字元做為階層分隔符號，因此 main-task-sub
|
||
在 Unity VCS 中會描繪成 /main/task/sub。
|
||
--^nodata 匯入 Git 快速匯出但不包含
|
||
資料。此命令
|
||
對於檢查匯入是否將正常執行非常有用。
|
||
--^ignoremissingchangesets 會捨棄無法匯入的
|
||
任何變更集，且快速匯入作業
|
||
會在無變更集的情況下繼續進行。
|
||
--^mastertomain 使用 "^main" 匯入，而非使用 "^master"。
|
||
|
||
== CMD_HELP_FASTIMPORT ==
|
||
備註：
|
||
|
||
- 若要匯出 git 儲存庫，請使用命令，例如：
|
||
^git ^fast-export --^all -^M --^signed-tags=^strip --^tag-of-filtered-object=^drop> ..\git-fast-export.dat
|
||
-^M 選項對於偵測移動的項目很重要。
|
||
|
||
- 如果指定的儲存庫不存在，則會建立該儲存庫。
|
||
|
||
- 支援使用包含
|
||
先前匯入之變更集的標記檔案 ('--^import-marks' 和 '--^export-marks'
|
||
檔案) 進行增量匯入。
|
||
這表示只有在
|
||
先前快速匯入中未匯入的新變更集才會匯入。
|
||
|
||
範例：
|
||
|
||
cm ^fast-import mynewrepo@atenea:8084 repo.fast-export
|
||
(將 'repo.fast-export' 檔案中匯出的內容匯入伺服器
|
||
'atenea:8084' 上的 'mynewrepo' 儲存庫。)
|
||
|
||
cm ^fast-import repo@atenea:8084 repo.fast-export --^export-marks=rep.marks
|
||
(將 'repo.fast-export' 檔案中匯出的內容匯入伺服器
|
||
'atenea:8084' 上的 'repo' 儲存庫，並建立標記檔案，
|
||
以便之後執行增量匯入。)
|
||
|
||
cm ^fast-import repo@server:8084 repo.fast-export --^import-marks=repo.marks \
|
||
--^export-marks=repo.marks
|
||
(匯入 'repo.fast-export' 檔案的內容。只有不在標記
|
||
檔案中的新變更集才會匯入。相同的標記
|
||
檔案用於再次儲存變更集的清單，以便下次進行
|
||
增量匯入。)
|
||
|
||
== CMD_DESCRIPTION_FILEINFO ==
|
||
擷取工作區中項目的詳細資訊。
|
||
|
||
== CMD_USAGE_FILEINFO ==
|
||
用法：
|
||
|
||
cm ^fileinfo <項目_路徑>[ ...][--^fields=<欄位_值>[,...]]
|
||
[[--^xml | -^x [=<輸出_檔案>]] | [--^format=<字串_格式>]]
|
||
[--^symlink] [--^encoding=<名稱>]
|
||
|
||
項目_路徑 要顯示的項目。使用空格以分隔
|
||
項目。
|
||
使用雙引號 (" ") 指定含空格的
|
||
路徑。
|
||
|
||
選項：
|
||
|
||
--^fields 以逗號分隔值的字串。此選項會選取要
|
||
針對每個項目列印的欄位。如需詳細資訊，
|
||
請參閱備註。
|
||
--^xml | -^x 將 XML 格式的輸出列印至標準輸出。
|
||
可以指定輸出檔案。此選項
|
||
無法與 '--^format' 合併。
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。此選項無法
|
||
與 '--^xml' 合併。
|
||
如果同時指定兩個選項，則此 '--^format' 選項
|
||
優先於 '--^fields'。
|
||
--^symlink 將檔案資訊作業套用至符號連結，而不是
|
||
套用至目標。
|
||
--^encoding 指定輸出編碼，例如：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
|
||
|
||
== CMD_HELP_FILEINFO ==
|
||
備註：
|
||
|
||
此命令會列印每個選取項目之屬性的詳細清單。
|
||
預設情況下，每個屬性會列印在新行上。
|
||
|
||
屬性清單可修改為僅顯示使用者需要的
|
||
屬性。這可以使用 '--^fields=<欄位_清單>' 來達成，其中接受
|
||
一連串以逗號分隔的屬性名稱。如此一來，只會顯示已指定
|
||
名稱的引數。
|
||
|
||
修訂前端變更集：
|
||
|
||
預設情況下，已停用此選項。請注意，擷取這個屬性
|
||
的速度明顯比其他屬性慢，因此，我們建議使用者
|
||
將盡可能多的項目分組在一起。這可避免執行許多
|
||
個別的 'cm ^fileinfo'，以改善執行時間。
|
||
此外，此功能目前無法用於受控目錄。
|
||
|
||
您可以在下方尋找可用屬性名稱的完整清單。
|
||
預設情況下，不會顯示標記星號 ('*') 的名稱：
|
||
^ClientPath 該項目在磁碟上的本地路徑。
|
||
^RelativePath 工作區相對路徑。
|
||
^ServerPath 該項目的儲存庫路徑。
|
||
(請注意：此選項目前不支援
|
||
轉換的工作區)。
|
||
^Size 項目大小。
|
||
^Hash 項目雜湊加總。
|
||
^Owner 項目所屬的使用者。
|
||
^RevisionHeadChangeset (*) 在分支的前端變更集中
|
||
載入的修訂變更集。
|
||
(請參閱下方備註。)
|
||
^RevisionChangeset 工作區中目前載入之修訂
|
||
的變更集。
|
||
^RepSpec 該項目的儲存庫規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
儲存庫規格。)
|
||
^Status 工作區項目狀態：已新增、已簽出、
|
||
已刪除等。
|
||
^Type 修訂類型 (文字、二進位、目錄、符號連結
|
||
或未知)。
|
||
^Changelist 項目所屬的變更集 (如果有的話)。
|
||
^IsLocked (*) 項目是否受到獨佔簽出的
|
||
鎖定。
|
||
^LockedBy (*) 獨佔簽出項目的使用者。
|
||
^LockedWhere (*) 獨佔簽出項目
|
||
的位置。
|
||
^IsUnderXlink 項目是否位於 Xlink
|
||
下方。
|
||
^UnderXlinkTarget 項目所在的 Xlink 目標
|
||
(如果有的話)。
|
||
^UnderXlinkPath Xlink 連結之儲存庫中的項目伺服器路徑
|
||
(如果有的話)。
|
||
^UnderXlinkWritable 項目所屬的 Xlink 是否
|
||
可寫入。
|
||
^UnderXlinkRelative 項目所屬的 Xlink 是否
|
||
相關。
|
||
^IsXlink 項目本身是否為 Xlink。
|
||
^XlinkTarget 如果項目是 Xlink，該項目指向的目標
|
||
儲存庫。
|
||
^XlinkName 項目的 Xlink 名稱，如果實際
|
||
存在的話。
|
||
^XlinkWritable Xlink 項目是否為可寫入的
|
||
Xlink。
|
||
^XlinkRelative Xlink 項目是否為相關的
|
||
Xlink。
|
||
|
||
輸出格式自訂化：
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{^ClientPath}
|
||
{^RelativePath}
|
||
{^ServerPath}
|
||
{^Size}
|
||
{^Hash}
|
||
{^Owner}
|
||
{^RevisionHeadChangeset}
|
||
{^RevisionChangeset}
|
||
{^Status}
|
||
{^Type}
|
||
{^Changelist}
|
||
{^IsLocked}
|
||
{^LockedBy}
|
||
{^LockedWhere}
|
||
{^IsUnderXlink}
|
||
{^UnderXlinkTarget}
|
||
{^UnderXlinkPath}
|
||
{^UnderXlinkWritable}
|
||
{^UnderXlinkRelative}
|
||
{^IsXlink}
|
||
{^XlinkTarget}
|
||
{^XlinkName}
|
||
{^XlinkWritable}
|
||
{^XlinkRelative}
|
||
{^RepSpec}
|
||
|
||
請注意，'--^format' 和 '--^xml' 選項是互斥的，因此，
|
||
無法同時使用這兩個選項。
|
||
|
||
範例：
|
||
|
||
cm ^fileinfo file1.txt file2.txt dir/
|
||
cm ^fileinfo "New Project.csproj" --^xml
|
||
cm ^fileinfo assets.art --^fields=^ServerPath,^Size,^IsLocked,^LockedBy
|
||
cm ^fileinfo proj_specs.docx --^fields=^ServerPath,^RevisionChangeset --^xml
|
||
cm ^fileinfo samples.ogg --^format="{^ServerPath}[{^Owner}] -> {^Size}"
|
||
|
||
== CMD_DESCRIPTION_FIND ==
|
||
執行類似 SQL 的查詢，以尋找 Unity VCS 物件。
|
||
|
||
== CMD_USAGE_FIND ==
|
||
用法：
|
||
|
||
cm ^find <物件_類型>
|
||
[^where <字串_條件>]
|
||
[^on ^repository '<儲存庫規格>' | ^on ^repositories '<儲存庫規格1>','<儲存庫規格2>'[,...]]
|
||
[--^format=<字串_格式>] [--^dateformat=<日期_格式>]
|
||
[--^nototal] [--^file=<傾印_檔案>] [--^xml]
|
||
[--^encoding=<名稱>]
|
||
|
||
物件_類型 要尋找的物件類型。
|
||
使用 'cm ^help ^showfindobjects' 以瞭解如何指定
|
||
這些物件。
|
||
您也可以參閱 'cm ^find' 指南：
|
||
https://www.plasticscm.com/download/help/cmfind
|
||
|
||
選項：
|
||
|
||
字串_條件 物件屬性上的搜尋條件。
|
||
儲存庫規格 搜尋儲存庫別名或規格。
|
||
在 '^on ^repositories' 的情況下，使用逗號以
|
||
分隔儲存庫規格欄位。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
規格。)
|
||
--^format 以指定的格式擷取輸出訊息。
|
||
請參閱 'cm ^find' 指南，以瞭解可做為
|
||
輸出格式字串的所有物件屬性：
|
||
https://www.plasticscm.com/download/help/cmfind
|
||
--^dateformat 用於輸出日期的格式。
|
||
--^nototal 結尾不輸出記錄計數。
|
||
--^file 要傾印結果的檔案。
|
||
--^xml 將 XML 格式的輸出列印至標準輸出。
|
||
--^encoding 指定輸出編碼，例如：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
|
||
== CMD_HELP_FIND ==
|
||
備註：
|
||
|
||
如果未指定任何儲存庫，將會在工作區中設定的
|
||
儲存庫上進行搜尋。
|
||
|
||
當您從命令列使用比較運算子 (>、<、>=、<=) 執行查詢時，
|
||
請記住，此命令介面會將這些運算子視為 IO
|
||
重新導向。因此，您需要使用雙引號括住
|
||
查詢。
|
||
|
||
'cm ^find' 命令接受格式字串以顯示輸出。
|
||
每個輸出參數是根據字串加以識別，而且使用者可以藉由在
|
||
'{' 和 '}' 括號之間輸入參數號碼來引用參數。
|
||
輸出參數通常對應至物件的屬性。
|
||
|
||
這些是一些有效的輸出格式字串：
|
||
--^format={^id}{^date}{^name}
|
||
--^format="{^item}#{^branch} ^with ^date {^date}"
|
||
|
||
XML 與編碼考量：
|
||
|
||
指定 '--^xml' 選項時，命令會將命令結果以 XML 文字的形式
|
||
顯示在標準輸出中。會使用作業系統預設編碼來顯示文字，
|
||
因此，在主控台中可能會不正確地顯示
|
||
非 ANSI 字元。如果您將命令輸出重新導向至檔案，
|
||
將會正確顯示。當同時指定 '--^xml' 和 '--^file'
|
||
選項時，預設編碼將會是 utf-8。
|
||
|
||
範例：
|
||
|
||
cm ^find ^revision
|
||
cm ^find ^revision "^where ^changeset=23 ^and ^owner='maria'"
|
||
cm ^find ^branch "^on ^repository 'rep1'"
|
||
cm ^find ^label "^on ^repositories 'rep1', '^rep:default@localhost:8084'"
|
||
cm ^find ^branch "^where ^parent='^br:/main' ^on ^repository 'rep1'"
|
||
cm ^find ^revision "^where ^item='^item:.'" --^format="{^item}#{^branch}"
|
||
cm ^find ^revision "^where ^item='^item:.'" --^xml --^file=c:\queryresults\revs.xml
|
||
|
||
== CMD_DESCRIPTION_FINDCHANGED ==
|
||
取得已變更檔案的清單。此命令已棄用，並且單純為了
|
||
回溯相容性而保留。請改用 'cm ^status'。
|
||
|
||
== CMD_USAGE_FINDCHANGED ==
|
||
用法：
|
||
|
||
cm ^findchanged | ^fc [-^R | -^r | --^recursive] [--^checkcontent]
|
||
[--^onlychanged] [<路徑>]
|
||
|
||
選項：
|
||
|
||
-^R 在目錄中遞迴尋找。
|
||
--^checkcontent 依內容比較檔案。
|
||
--^onlychanged 僅尋找已變更的檔案；不會獲得
|
||
簽出。
|
||
路徑 (預設：目前目錄。)
|
||
尋找已變更檔案的初始路徑。
|
||
|
||
== CMD_HELP_FINDCHANGED ==
|
||
備註：
|
||
|
||
如果未提供任何 '--^checkcontent' 選項，Unity VCS 會根據檔案時間戳記
|
||
尋找變更。指定 '--^checkcontent' 選項時，會比較檔案或
|
||
資料夾內容，而不是使用時間戳記。
|
||
|
||
此命令對於在與 Unity VCS 伺服器中斷連線時偵測已變更的檔案，
|
||
相當有用。此輸出可透過管道傳送至簽出命令，
|
||
在稍後檢查變更 (請參閱範例)。
|
||
|
||
範例：
|
||
|
||
cm ^findchanged .
|
||
(在目前目錄中尋找已變更的檔案。)
|
||
|
||
cm ^findchanged -^R .| cm ^checkout -
|
||
(簽出已變更的元素。)
|
||
|
||
== CMD_DESCRIPTION_FINDCHECKEDOUT ==
|
||
取得已簽出項目的清單。此命令已棄用，並且單純為了
|
||
回溯相容性而保留。請改用 'cm ^status'。
|
||
|
||
== CMD_USAGE_FINDCHECKEDOUT ==
|
||
用法：
|
||
|
||
cm ^findcheckouts | ^fco [--^format=<字串_格式>] [--^basepath]
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^basepath 開始搜尋簽出的路徑。如果
|
||
未指定，會使用目前路徑。
|
||
|
||
== CMD_HELP_FINDCHECKEDOUT ==
|
||
備註：
|
||
|
||
此命令對於在單一步驟中簽入或取消簽出所有已簽出項目相當有用，
|
||
可將標準輸出重新導向其他命令。
|
||
請參閱範例。
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{0} 日期。
|
||
{1} 擁有者。
|
||
{2} 工作空間資訊。
|
||
{3} 用戶端機器名稱。
|
||
{4} 項目路徑。
|
||
{5} 分支和儲存庫資訊。
|
||
|
||
範例：
|
||
|
||
cm ^findcheckouts --^format="在分支 {5} 上已變更檔案 {4} "
|
||
(尋找已簽出項目，並使用檔案路徑和分支
|
||
與儲存庫資訊來設定輸出的格式。)
|
||
|
||
cm ^findcheckouts --^format={4} | cm ^checkin -
|
||
(簽入所有已簽出項目。)
|
||
|
||
cm ^findcheckouts --^format={4} | cm ^undocheckout -
|
||
(取消簽出所有已簽出項目。)
|
||
|
||
== CMD_DESCRIPTION_FINDPRIVATE ==
|
||
取得私人項目的清單。此命令已棄用，並且單純為了
|
||
回溯相容性而保留。請改用 'cm ^status'。
|
||
|
||
== CMD_USAGE_FINDPRIVATE ==
|
||
用法：
|
||
cm ^findprivate | ^fp [-^R | -^r | --^recursive] [--^exclusions] [<路徑>]
|
||
|
||
選項：
|
||
|
||
-^R 在目錄中遞迴尋找。
|
||
--^exclusions 此選項允許在忽略路徑內剪下搜尋，
|
||
由檔案 ignore.conf 定義。
|
||
路徑 (預設：目前目錄。)
|
||
尋找私人檔案的初始路徑。
|
||
|
||
== CMD_HELP_FINDPRIVATE ==
|
||
備註：
|
||
|
||
如果有指定任何路徑，Unity VCS 將開始從
|
||
目前目錄搜尋。
|
||
|
||
此命令對於在資料夾上新增私人項目相當有用，透過管道將輸出
|
||
傳送至新增命令。請參閱範例。
|
||
|
||
範例：
|
||
|
||
cm ^findprivate .
|
||
|
||
cm ^findprivate -^R | cm ^add -
|
||
(遞迴搜尋私人項目並新增這些項目。)
|
||
|
||
== CMD_DESCRIPTION_GETCONFIG ==
|
||
獲得設定資訊。
|
||
|
||
== CMD_USAGE_GETCONFIG ==
|
||
用法：
|
||
|
||
cm ^getconfig [^setfileasreadonly] [^location] [^extensionworkingmode]
|
||
[^extensionprefix] [^defaultrepserver]
|
||
|
||
^setfileasreadonly 傳回受保護的檔案是否保持
|
||
唯讀。
|
||
^location 傳回用戶端設定路徑。
|
||
^extensionworkingmode 傳回副檔名工作模式。
|
||
^extensionprefix 傳回設定的副檔名前置詞。
|
||
^defaultrepserver 傳回預設儲存庫伺服器的
|
||
位置。
|
||
|
||
== CMD_HELP_GETCONFIG ==
|
||
範例：
|
||
|
||
cm ^getconfig ^setfileasreadonly
|
||
|
||
== CMD_DESCRIPTION_GETFILE ==
|
||
下載指定修訂的內容。
|
||
|
||
== CMD_USAGE_GETFILE ==
|
||
用法：
|
||
|
||
cm ^getfile | ^cat <修訂規格> [--^file=<輸出_檔案>] [--^debug]
|
||
[--^symlink] [--^raw]
|
||
|
||
修訂規格 物件規格。(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
規格。)
|
||
|
||
選項：
|
||
|
||
--^file 儲存輸出的檔案。預設情況下，該檔案會列印在
|
||
標準輸出上。
|
||
--^debug 使用目錄規格時，此命令會顯示目錄中的
|
||
所有項目、項目的修訂 ID，
|
||
以及檔案系統保護。
|
||
--^symlink 將作業套用至符號連結，而不是套用至
|
||
目標。
|
||
--^raw 顯示檔案的未經處理資料。
|
||
|
||
== CMD_HELP_GETFILE ==
|
||
範例：
|
||
|
||
cm ^cat myfile.txt#^br:/main
|
||
(在 'myfile.txt' 的分支 '^br:/main' 中，獲取最後一個修訂。)
|
||
|
||
cm ^getfile myfile.txt#^cs:3 --^file=tmp.txt
|
||
(獲取 'myfile.txt' 的變更集 3，並將其寫入檔案 'tmp.txt'。)
|
||
|
||
cm ^cat ^serverpath:/src/foo.c#^br:/main/task003@myrepo
|
||
(獲取儲存庫 'myrepo' 中分支 '/main/task003' 的最後
|
||
一個變更集 '/src/foo.c' 的內容)
|
||
|
||
cm ^cat ^revid:1230@^rep:myrep@^repserver:myserver:8084
|
||
(獲取 ID 1230 的修訂。)
|
||
|
||
cm ^getfile ^rev:info\ --^debug
|
||
(獲取 'info' 儲存庫中的所有修訂。)
|
||
|
||
== CMD_DESCRIPTION_GETREVISION ==
|
||
在工作區中載入修訂。
|
||
|
||
== CMD_USAGE_GETREVISION ==
|
||
此命令會修改工作區中載入的修訂，因此，會影響
|
||
未來合併。
|
||
這是繼承自舊版本的進階命令，所以請謹慎使用。
|
||
|
||
用法：
|
||
cm ^getrevision <修訂規格>
|
||
|
||
修訂規格 物件規格。(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
修訂規格。)
|
||
|
||
== CMD_HELP_GETREVISION ==
|
||
範例：
|
||
|
||
cm ^getrevision file.txt#^cs:3
|
||
(取得 'file.txt' 的變更集 3 修訂。)
|
||
|
||
== CMD_DESCRIPTION_GETSTATUS ==
|
||
取得項目的狀態。
|
||
|
||
== CMD_USAGE_GETSTATUS ==
|
||
這是自動化命令，目的僅限用於自動化 'cm'。
|
||
方便使用的程度並不高。
|
||
|
||
用法：
|
||
|
||
cm ^getstatus | ^gs <項目_路徑>[ ...][--^format=<字串_格式>] [--^stats]
|
||
[-^R | -^r | --^recursive]
|
||
|
||
項目_路徑 要取得狀態的一或多個項目。使用雙引號
|
||
(" ") 指定含空格的路徑。使用
|
||
空格分隔路徑。
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^stats 列印關於取得狀態過程的一些統計資料。
|
||
-^R 在目錄中遞迴顯示狀態。
|
||
|
||
== CMD_HELP_GETSTATUS ==
|
||
備註：
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{0} 項目路徑。
|
||
{1} 項目狀態：
|
||
0 私人，
|
||
1 已簽入，
|
||
2 已簽出。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
'^getstatus' 命令可從 stdin 讀取路徑。若要執行此操作，可
|
||
傳遞單一破折號「-」來完成。
|
||
範例：cm ^getstatus -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線以指定要取得狀態的路徑。
|
||
範例：
|
||
dir /S /B *.c | cm ^getstatus --^format="路徑 {0} 狀態 {1}" -
|
||
(在 Windows 中，取得工作區中所有 .c 檔案的狀態。)
|
||
|
||
範例：
|
||
|
||
cm ^getstatus file1.txt file2.txt
|
||
(取得檔案的狀態。)
|
||
|
||
cm ^gs info\ -^R --^format="項目 {0} 具有狀態 {1}"
|
||
(取得目錄及其項目的狀態，並顯示
|
||
已格式化的輸出。)
|
||
|
||
== CMD_DESCRIPTION_GETTASKBRANCHES ==
|
||
取得與任務連結的分支。
|
||
|
||
== CMD_USAGE_GETTASKBRANCHES ==
|
||
這是自動化命令，目的僅限用於自動化 'cm'。
|
||
方便使用的程度並不高。
|
||
|
||
用法：
|
||
|
||
cm ^gettaskbranches | ^gtb <任務_名稱> [--^format=<字串_格式>]
|
||
[--^dateformat=<日期_格式>]
|
||
|
||
任務_名稱 任務識別碼。
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^dateformat 用於輸出日期的格式。
|
||
|
||
== CMD_HELP_GETTASKBRANCHES ==
|
||
備註：
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{^tab} 插入定位字元空格。
|
||
{^newline} 插入新行。
|
||
{^name} 分支名稱。
|
||
{^owner} 分支的擁有者。
|
||
{^date} 建立分支的日期。
|
||
{^type} 分支類型 (如果是智慧型，則為 'T'，如果不是，則為 'F')。
|
||
{^parent} 上層分支。
|
||
{^comment} 分支的註解。
|
||
{^repname} 存在此分支的儲存庫。
|
||
{^repserver} 伺服器名稱。
|
||
|
||
範例：
|
||
|
||
cm ^gettaskbranches 4311
|
||
cm ^gtb 4311 --^format="^br:{^name}"
|
||
cm ^gtb 4311 --^format="^br:{^name} {^date}" --^dateformat="yyyy/MM/dd HH:mm:ss"
|
||
|
||
== CMD_DESCRIPTION_GETWORKSPACEINFO ==
|
||
顯示關於工作區選擇器的資訊。
|
||
|
||
== CMD_USAGE_GETWORKSPACEINFO ==
|
||
用法：
|
||
|
||
cm ^wi [<工作區_路徑>]
|
||
|
||
選項：
|
||
|
||
工作區_路徑 機器上的工作區路徑。
|
||
|
||
== CMD_HELP_GETWORKSPACEINFO ==
|
||
備註：
|
||
'^wi' 命令會顯示工作區 (儲存庫、分支，及/或標籤)
|
||
的作用中設定。
|
||
|
||
範例：
|
||
cm ^wi c:\mywk
|
||
|
||
== CMD_DESCRIPTION_GETWORKSPACEFROMPATH ==
|
||
從路徑取得工作區資訊。
|
||
|
||
== CMD_USAGE_GETWORKSPACEFROMPATH ==
|
||
這是自動化命令，目的僅限用於自動化 'cm'。
|
||
方便使用的程度並不高。
|
||
|
||
用法：
|
||
|
||
cm ^getworkspacefrompath | ^gwp <項目_路徑> [--^format=<字串_格式>]
|
||
|
||
項目_路徑 磁碟上的檔案或資料夾。
|
||
|
||
選項：
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
|
||
== CMD_HELP_GETWORKSPACEFROMPATH ==
|
||
備註：
|
||
|
||
此命令會顯示位於路徑中的工作區相關資訊。
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{0} | {^wkname} 工作區名稱。
|
||
{1} | {^wkpath} 工作區路徑。
|
||
{2} | {^machine} 用戶端機器名稱。
|
||
{3} | {^owner} 工作區擁有者。
|
||
{4} | {^guid} 工作區 GUID。
|
||
|
||
{^tab} 插入定位字元空格。
|
||
{^newline} 插入新行。
|
||
|
||
範例：
|
||
|
||
cm ^gwp c:\myworkspace\code\file1.cpp --^format="工作區名稱: {^wkname}"
|
||
|
||
== CMD_DESCRIPTION_HELP ==
|
||
取得 Unity VCS 命令的說明。
|
||
|
||
== CMD_USAGE_HELP ==
|
||
用法：
|
||
|
||
cm ^help <命令>
|
||
|
||
== CMD_HELP_HELP ==
|
||
|
||
== CMD_DESCRIPTION_IOSTATS ==
|
||
顯示關於硬體的統計資料。
|
||
|
||
== CMD_USAGE_IOSTATS ==
|
||
用法：
|
||
|
||
cm ^iostats [<儲存庫伺服器規格>] [<測試_清單>[ ...]]
|
||
[--^nettotalmb=<值_mb>] [--^networkiterations=<值_反覆項目>]
|
||
[--^diskdatasize=<值_大小>] [--^disktestpath=<值_路徑>]
|
||
[--^systemdisplaytime=<值_時間>]
|
||
[--^systemdisplaytimeinterval=<值_間隔>]
|
||
|
||
選項：
|
||
|
||
儲存庫伺服器規格 執行網路測試的可用 Unity VCS
|
||
伺服器，例如 "serverUploadTest"
|
||
及/或 "serverDownloadTest"。
|
||
如果未提供任何伺服器，預設情況下，
|
||
此命令會嘗試與設定的伺服器
|
||
進行通訊。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
伺服器規格。)
|
||
測試_清單 可用測試。使用空格分隔
|
||
測試欄位。
|
||
如需詳細資訊，請參閱備註。
|
||
--^nettotalmb 表示網路測試傳輸的使用者
|
||
資料量 (以MB 為單位)，
|
||
例如 "^serverDownloadTest" 或
|
||
"^serverUploadTest"。
|
||
它必須是介於 "4" 和 "512" 之間的值。
|
||
(預設值：16)
|
||
--^networkiterations 表示將執行的
|
||
"^serverDownloadTest" 及/或 "^serverUploadTest"
|
||
的反覆項目數目。
|
||
它必須是介於 "1" 和 "100" 之間的值。
|
||
(預設值：1)
|
||
--^diskdatasize 表示將在
|
||
"^diskTest" 上寫入然後讀取的資料量。
|
||
它必須是介於 "100" 和 "4096" 之間的值。
|
||
(預設值：512)
|
||
--^disktestpath "^diskTest" 寫入測試檔案的
|
||
路徑。如果未提供此參數，
|
||
此命令將嘗試使用系統的暫存
|
||
路徑。
|
||
--^systemdisplaytime 顯示系統資源使用狀況的時間間隔
|
||
(以秒為單位)。此選項可供以下
|
||
測試使用: "^systemNetworkUsage"
|
||
和 "^systemDiskUsage".
|
||
它必須是介於 "1" 和 "3600" 之間的值。
|
||
(預設: 5 秒)。
|
||
--^systemdisplaytimeinterval 系統效能取樣之間的時間間隔
|
||
(以秒為單位)。此選項可供
|
||
以下測試使用:
|
||
"^systemNetworkUsage" 和 "^systemDiskUsage".
|
||
它必須是介於 "1" 和 "60" 之間的值。
|
||
(預設: 1 秒)。
|
||
|
||
== CMD_HELP_IOSTATS ==
|
||
備註:
|
||
|
||
此命令要求在網路速度測試 ("^serverUploadTest"
|
||
及/或 "^serverDownloadTest") 中，使用可用的伺服器。
|
||
|
||
'--^diskTestPath' 必須指向屬於將要測試的實體
|
||
磁碟機。如果未指定任何路徑，此命令會嘗試
|
||
使用系統預設的暫存路徑。
|
||
指定路徑的磁碟機必須有足夠的空間，才能執行
|
||
測試。
|
||
|
||
命令執行期間，系統會因為執行的測試
|
||
而導致效能下降。
|
||
|
||
可用的測試:
|
||
--^serveruploadtest (預設) 測量從
|
||
Unity VCS 用戶端到伺服器的資料上傳速度。
|
||
--^serverdownloadtest (預設) 測量從
|
||
Unity VCS 伺服器到用戶端的資料下載速度。
|
||
--^disktest (預設) 測量磁碟讀取速度與磁碟
|
||
寫入速度。
|
||
--^systemnetworkusage 顯示系統網路資源的目前
|
||
使用量。
|
||
(其顯示 Microsoft Windows 提供的網路介面效能計數器
|
||
)。
|
||
僅在 Microsoft Windows 中可用。
|
||
--^systemdiskusage 顯示系統實體磁碟的目前
|
||
使用量。
|
||
(其顯示 Microsoft Windows 提供的網路介面
|
||
效能計數器)。
|
||
僅在 Microsoft Windows 中可用。
|
||
|
||
範例：
|
||
|
||
cm ^iostats MYSERVER:8087 --^serveruploadtest --^serverdownloadtest --^nettotalmb=32
|
||
|
||
== CMD_DESCRIPTION_ISSUETRACKER ==
|
||
在指定的議題追蹤器中取得、更新或尋找問題狀態。
|
||
|
||
== CMD_USAGE_ISSUETRACKER ==
|
||
用法：
|
||
|
||
cm ^issuetracker <名稱> ^status ^get <任務_id> <參數>[ ...]
|
||
cm ^issuetracker <名稱> ^status ^update <任務_id> <狀態> <參數>[ ...]
|
||
cm ^issuetracker <名稱> ^status ^find <狀態> <參數>[ ...]
|
||
cm ^issuetracker <名稱> ^connection ^check <參數>[ ...]
|
||
|
||
名稱 要連線的議題追蹤器名稱。
|
||
目前僅支援 Jira。
|
||
任務_id 要查詢或更新的議題編號。
|
||
^status 議題追蹤器中的問題有效狀態。
|
||
|
||
Jira 參數 (皆為強制):
|
||
|
||
--^user=<使用者> 要驗證的使用者。
|
||
--^password=<密碼> 要驗證的密碼。
|
||
--^host=<url> 議題追蹤器的目標 URL。
|
||
--^projectkey=<金鑰> Jira 專案的專案金鑰。
|
||
|
||
== CMD_HELP_ISSUETRACKER ==
|
||
範例：
|
||
|
||
cm ^issuetracker jira ^status ^get 11 --^user=user@mail.es --^password=pwd \
|
||
--^host=https://user.atlassian.net --^projectkey=PRJ
|
||
(取得 'PRJ' 專案的議題 11 狀態。)
|
||
|
||
cm ^issuetracker jira ^status ^update 11 "完成" --^user=user@mail.es \
|
||
--^password=pwd --^host=https://user.atlassian.net --^projectkey=PRJ
|
||
(將 'PRJ' 專案的議題 11 狀態更新為 '完成'。)
|
||
|
||
cm ^issuetracker jira ^status ^find "完成" --^user=user@mail.es --^password=pwd \
|
||
--^host=https://user.atlassian.net --^projectkey=PRJ
|
||
(取得 'PRJ' 專案狀態已設為 '完成' 的任務 ID -)
|
||
|
||
cm ^issuetracker jira ^connection ^check --^user=user@mail.es --^password=pwd \
|
||
--^host=https://user.atlassian.net --^projectkey=PRJ
|
||
(檢查設定參數是否有效。)
|
||
|
||
== CMD_DESCRIPTION_LICENSEINFO ==
|
||
顯示授權資訊與授權使用狀況。
|
||
|
||
== CMD_USAGE_LICENSEINFO ==
|
||
用法：
|
||
|
||
cm ^licenseinfo | ^li [--^server=<儲存庫伺服器規格>] [--^inactive] [--^active]
|
||
[--^sort=(^name|^status)]
|
||
|
||
選項:
|
||
|
||
--^server 從指定的伺服器取得授權資訊。
|
||
如果未指定任何伺服器，請在用戶端上設定的
|
||
伺服器上執行命令。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺服器
|
||
規格。)
|
||
--^inactive 僅顯示 [授權使用狀況] 區段中的非作用中使用者。
|
||
--^active 僅顯示 [授權使用狀況] 區段中的作用中使用者。
|
||
--^sort 依其中一個指定的排序選項來排序使用者:
|
||
'^name' 或 '^status'。
|
||
|
||
== CMD_HELP_LICENSEINFO ==
|
||
備註:
|
||
|
||
顯示的資源包含截止日期、已啟用和已停用
|
||
使用者等。
|
||
|
||
範例：
|
||
|
||
cm ^licenseinfo
|
||
cm ^licenseinfo --^server=myserver:8084
|
||
cm ^licenseinfo --^sort=^name
|
||
|
||
== CMD_DESCRIPTION_LINKTASK ==
|
||
將變更集連結至任務。
|
||
|
||
== CMD_USAGE_LINKTASK ==
|
||
這是自動化命令，目的僅限用於自動化 'cm'。
|
||
方便使用的程度並不高。
|
||
|
||
用法：
|
||
|
||
cm ^linktask | ^lt <變更集規格> <副檔名_前置詞> <任務_名稱>
|
||
|
||
變更集規格 連結至任務的完整變更集規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
|
||
規格。)
|
||
副檔名_前置詞 要搭配使用之已設定議題追蹤系統
|
||
的副檔名前置詞。
|
||
任務_名稱 議題追蹤系統的任務識別碼。
|
||
|
||
== CMD_HELP_LINKTASK ==
|
||
範例：
|
||
|
||
cm ^lt ^cs:8@^rep:default@^repserver:localhost:8084 jira PRJ-1
|
||
|
||
== CMD_DESCRIPTION_LOCK_LIST ==
|
||
顯示伺服器上的鎖定。
|
||
|
||
== CMD_USAGE_LOCK_LIST ==
|
||
用法：
|
||
|
||
cm ^lock ^list | ^ls [<修訂規格> [ ...]] [--^server=<伺服器>]
|
||
[--^onlycurrentuser] [--^onlycurrentworkspace]
|
||
[--^ignorecase]
|
||
|
||
修訂規格 如果存在一或多個，當其相關項目在伺服器中
|
||
鎖定時，此命令將針對每個指定的修訂顯示
|
||
一個鎖定行。否則，
|
||
此命令將列出預設伺服器 (或使用
|
||
'--^server' 選項設定的伺服器) 中所有鎖定的項目
|
||
使用
|
||
多個規格時，請使用空格來分隔修訂規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解修訂規格。)
|
||
|
||
選項:
|
||
|
||
--^server 儲存庫伺服器規格。
|
||
此選項將覆寫從目前工作區或
|
||
client.conf 檔案擷取的預設
|
||
伺服器。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
伺服器規格。)
|
||
--^onlycurrentuser 篩選結果，並只顯示由目前使用者
|
||
執行的鎖定。
|
||
--^onlycurrentworkspace 篩選結果，並只顯示在目前工作區上
|
||
執行的鎖定 (依名稱比對)。
|
||
--^ignorecase 當使用伺服器路徑規格時，忽略路徑的
|
||
大小寫區分。搭配這個標誌時，此命令將適用於
|
||
"/src/foo.c"，即使該使用者寫入的是 "/sRc/fOO.c"。
|
||
|
||
== CMD_HELP_LOCK_LIST ==
|
||
備註：
|
||
|
||
此命令將顯示目前在預設伺服器中遭鎖定的項目
|
||
清單。此命令也可接受修訂規格的清單；在這種情況下，
|
||
將只會顯示屬於所選項目的鎖定。
|
||
'--^server=<伺服器>' 可以用來設定將要查詢的預設伺服器。
|
||
|
||
此命令會顯示一行包含指定伺服器中的各個鎖定：
|
||
- 已鎖定項目的 GUID。
|
||
- 執行此鎖定的使用者名稱。
|
||
- 其中執行鎖定的工作區名稱。
|
||
- 已鎖定項目的路徑 (伺服器路徑格式)。
|
||
|
||
範例：
|
||
|
||
cm ^lock ^list
|
||
cm ^lock ^list --^server=myserver:8084
|
||
cm ^lock ^ls ^serverpath:/src/foo.c#^cs:99@default@localhost:8084
|
||
cm ^lock ^list ^revid:3521@default ^itemid:2381@secondary --^onlycurrentuser
|
||
cm ^lock ^ls --^onlycurrentuser
|
||
cm ^lock ^ls --^onlycurrentuser --^onlycurrentworkspace
|
||
|
||
== CMD_DESCRIPTION_LISTUSERS ==
|
||
列出使用者和群組。
|
||
|
||
== CMD_USAGE_LISTUSERS ==
|
||
用法：
|
||
|
||
cm ^listusers | ^lu <儲存庫伺服器規格> [--^onlyusers] [--^onlygroups]
|
||
[--^filter= <字串_篩選>]
|
||
|
||
儲存庫伺服器規格 儲存庫伺服器規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
選項：
|
||
|
||
--^onlyusers 只列出使用者。
|
||
--^onlygroups 只列出群組。
|
||
--^filter 只列出符合所指定篩選的使用者及/或
|
||
群組。
|
||
|
||
== CMD_HELP_LISTUSERS ==
|
||
範例：
|
||
|
||
cm ^lu localhost:8084
|
||
(列出伺服器中的所有使用者。)
|
||
|
||
cm ^listusers localhost:8084 --^onlyusers --^filter=m
|
||
(只列出名稱含 "m" 伺服器中的使用者。)
|
||
|
||
== CMD_DESCRIPTION_LOCATION ==
|
||
傳回名稱含 'cm' 的路徑。
|
||
|
||
== CMD_USAGE_LOCATION ==
|
||
用法：
|
||
|
||
cm ^location
|
||
|
||
== CMD_HELP_LOCATION ==
|
||
|
||
== CMD_DESCRIPTION_LOCK ==
|
||
這個命令可讓使用者管理鎖定。
|
||
|
||
== CMD_USAGE_LOCK ==
|
||
用法：
|
||
|
||
cm ^lock <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^list | ^ls
|
||
^unlock
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^lock <命令> --^usage
|
||
cm ^lock <命令> --^help
|
||
|
||
== CMD_HELP_LOCK ==
|
||
範例：
|
||
|
||
cm ^lock ^list
|
||
cm ^lock
|
||
(如果沒有引數，則可選用 '^list'。)
|
||
cm ^lock ^ls ^serverpath:/src/foo.c#^cs:99@default@localhost:8084
|
||
cm ^lock ^unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
|
||
|
||
== CMD_DESCRIPTION_LOG ==
|
||
取得變更集中修訂的相關資訊。
|
||
|
||
== CMD_USAGE_LOG ==
|
||
用法：
|
||
|
||
cm ^log [<變更集規格> | <儲存庫規格>] [--^from=<變更集規格_來源>] [--^allbranches]
|
||
[--^ancestors] [--^csformat=<字串_格式>] [--^itemformat=<字串_格式>]
|
||
[--^xml[=<輸出_檔案>]] [--^encoding=<名稱>]
|
||
[--^repositorypaths | --^fullpaths | --^fp]
|
||
|
||
選項：
|
||
|
||
變更集規格 此命令將傳回提供規格之變更集內所做的
|
||
每項變更。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
|
||
規格。)
|
||
儲存庫規格 此命令將列出所指定儲存庫中所做的
|
||
所有變更。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
規格。)
|
||
--^from 列出從變更集規格 [變更集規格_來源] 到變更集規格
|
||
[變更集規格] 中每個變更集內所做的
|
||
所有變更。
|
||
此 [變更集規格_來源] 變更集不包含在
|
||
輸出內。
|
||
當已提供儲存庫規格時即忽略。
|
||
--^allbranches 顯示變更集建立時所在之全部分支
|
||
依據指定間隔所建立變更集
|
||
的相關資訊。
|
||
--^ancestors 顯示可透過所指定變更集 ([變更集規格]) 的
|
||
上層連結與合併連結連接之變更集
|
||
相關資訊。如果也提供起始變更集
|
||
([變更集規格_來源])，此變更集將會做為
|
||
所有路徑的下限。備註：當使用
|
||
此選項時，將不會顯示變更集的變更。
|
||
--^csformat 以指定的格式擷取變更集資訊。如需
|
||
詳細資訊，請參閱備註。
|
||
--^itemformat 以指定的格式擷取項目資訊。如需
|
||
詳細資訊，請參閱備註。
|
||
--^xml 將 XML 格式的輸出列印至標準輸出。
|
||
可以指定輸出檔案。
|
||
--^encoding 與 '--^xml' 選項搭配使用，指定要在
|
||
XML 輸出中使用的編碼，亦即：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^fullpaths, --^fp 如果可能，會強制列印檔案和目錄的
|
||
完整工作區路徑。
|
||
--^repositorypaths 列印儲存庫路徑 (伺服器路徑)，而非
|
||
工作區路徑。(此選項會覆寫
|
||
'--^fullpaths' 選項)。
|
||
|
||
== CMD_HELP_LOG ==
|
||
備註：
|
||
|
||
- 如果未指定 '變更集規格' 也未指定任何選項，該命令會顯示
|
||
每個分支於最近一個月內所建立個別變更集的
|
||
相關資訊。
|
||
- 如果只包含選項 '--^from'，該命令會顯示在變更集建立
|
||
所在的分支中，從所指定變更集變更至最近變更集之
|
||
每個變更集的相關資訊。
|
||
- 如果選項 '--^allbranches' 不含間隔，該命令會擷取
|
||
如同僅指定 '變更集規格' 時的
|
||
相同資訊。
|
||
- 如果使用 '--^from'，其輸出會包含'變更集規格_來源'+1
|
||
及依此類推的資訊。
|
||
- 用於顯示變更集資訊的儲存庫，即在執行此命令的路徑中
|
||
所載入的儲存庫。
|
||
|
||
這個命令會接受項目的格式字串 ('--^itemformat') 及
|
||
變更集的格式字串 ('--^csformat')。
|
||
|
||
'--^csformat' 的輸出參數如下所示：
|
||
{^tab} 插入定位字元空格。
|
||
{^newline} 插入新行。
|
||
{^changesetid} 變更集號碼。
|
||
{^branch} 變更集建立時的所在分支。
|
||
{^date} 變更集的日期。
|
||
{^owner} 變更集的擁有者。
|
||
{^comment} 變更集的註解。
|
||
{^items} 涉及此變更集的項目。
|
||
{^repository} 其中存在此變更集的儲存庫。
|
||
{^repserver} 伺服器名稱。
|
||
|
||
'--^itemformat' 的輸出參數如下所示：
|
||
{^tab} 插入定位字元空格。
|
||
{^newline} 插入新行。
|
||
{^path} 項目路徑。
|
||
{^branch} 變更集建立時的所在分支。
|
||
{^date} 變更集的日期。
|
||
{^owner} 變更集的擁有者。
|
||
{^shortstatus} 列印短格式。請參閱如下。
|
||
{^fullstatus} 列印長格式。請參閱如下。
|
||
|
||
短格式及對應的長格式：
|
||
'^A' ^Added
|
||
'^D' ^Deleted
|
||
'^M' ^Moved
|
||
'^C' ^Changed
|
||
|
||
這些是有效的輸出字串：
|
||
--^csformat="{^newline}在 {^date}建立的變更集 {^changesetid}；{^tab} 已變更項目: {^items}。"
|
||
--^itemformat="{^newline}項目 {^path} 已在分支 {^branch} 中變更。"
|
||
|
||
範例：
|
||
|
||
cm ^log
|
||
(顯示每個分支在最近一個月內所建立每個變更集的
|
||
相關資訊。)
|
||
|
||
cm ^log ^cs:16
|
||
(顯示變更集建立所在分支中之變更集 16 的
|
||
相關資訊。)
|
||
|
||
cm ^log ^cs:16 --^csformat="{^newline}變更集 {^changesetid}已建立於 \
|
||
{^date}；{^tab} 已變更項目: {^items}。"
|
||
(以所指定格式，顯示資訊。)
|
||
|
||
cm ^log --^from=^cs:20 ^cs:50
|
||
(顯示從變更集 21 到變更集 50 中，每個變更集內含
|
||
個別修訂的相關資訊。)
|
||
|
||
cm ^log --^from=^cs:20 ^cs:50 --^allbranches
|
||
(顯示儲存庫之個別分支的變更集 21 到變更集 50 中，
|
||
每個變更集內含個別修訂的
|
||
相關資訊。)
|
||
|
||
cm ^log ^rep:myrep@localhost:8084
|
||
(顯示指定儲存庫中所做變更的相關資訊。
|
||
執行此命令時不需要任何工作區。)
|
||
|
||
cm ^log --^from=^cs:20@^rep:mainRep@localhost:8084
|
||
(顯示變更集 21 中每個變更集所內含之個別修訂的
|
||
相關資訊。執行此命令時不需要任何工作區，因為
|
||
已指定了完整的變更集規格。)
|
||
|
||
== CMD_DESCRIPTION_LIST ==
|
||
列出樹狀目錄的內容。
|
||
|
||
== CMD_USAGE_LIST ==
|
||
用法：
|
||
|
||
cm ^ls | ^dir [<路徑>[ ...]] [--^format=<字串_格式>] [--^symlink]
|
||
[--^selector[=<選擇器_格式>]] [--^tree=<物件_規格>]
|
||
[-^R | -^r | --^recursive]
|
||
[--^xml[=<輸出_檔案>]] [--^encoding=<名稱>]
|
||
|
||
選項：
|
||
|
||
路徑 列出要顯示的路徑。使用空格分隔
|
||
路徑。
|
||
使用雙引號 (" ") 指定含空格的
|
||
路徑。
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^symlink 將作業套用至符號連結，而不是套用至
|
||
目標。
|
||
--^selector 取得此作用中工作區選擇器中的內容。
|
||
如已指定 [選擇器_格式]，則會列出
|
||
指定的選擇器。
|
||
這個選擇器幾乎已棄用，因為這些選擇器
|
||
自 4.x 版起已不再是 Unity VCS 的中心部分。
|
||
--^tree 在指定的變更集或分支中，列出樹狀目錄。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
-^R 遞迴列出。
|
||
--^xml 將 XML 格式的輸出列印至標準輸出。
|
||
可以指定輸出檔案。
|
||
--^encoding 與 '--^xml' 選項搭配使用，指定要在
|
||
XML 輸出中使用的編碼，亦即：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
|
||
== CMD_HELP_LIST ==
|
||
備註：
|
||
|
||
- 路徑輸入可使用中繼字元。
|
||
- 實際清單依工作區選擇器而定。
|
||
- 此命令的輸出可依指定的格式字串格式化處理。
|
||
- 如果指定了--^tree' 或 --^selector' 選項，則指定的
|
||
路徑必須是伺服器路徑 (又稱為 'cm path'): /dir/file.txt，
|
||
而非工作區路徑: C:\Users\myuser\mywk\dir\file.txt
|
||
- 如未提供任何路徑，則工作區路徑應該是目前的
|
||
目錄。如果使用了 '--^tree' 或 '--^selector' 選項，則
|
||
應該是使用根目錄路徑 ("/")。
|
||
|
||
預設格式字串：
|
||
"{^size,10} {^date:dd/MM/yyyy} {^date:HH:mm}\
|
||
{^type,-6} {^location,-12} {^checkout,-5} {^name}\
|
||
{^symlinktarget}"
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{^size}
|
||
{^formattedsize}
|
||
{^date}
|
||
{^type}
|
||
^dir 目錄；
|
||
^txt 文字檔；
|
||
^File 檔案。
|
||
{^location} 範例：^br:branch#cset
|
||
{^checkout}
|
||
{^name}
|
||
{^changeset}
|
||
{^path}
|
||
{^repspec}
|
||
{^owner}
|
||
{^revid}
|
||
{^parentrevid}
|
||
{^itemid}
|
||
{^brid}
|
||
{^repid}
|
||
{^server}
|
||
{^symlinktarget}
|
||
{^hash}
|
||
{^chmod}
|
||
{^wkpath} 工作區根目錄的相對路徑
|
||
{^branch}
|
||
{^newlocation} cset@branch
|
||
{^guid} (解析所花時間較長)
|
||
{^itemguid}
|
||
{^transformed} 顯示所轉換項目上的套用規則
|
||
|
||
您可以自訂 PLASTIC_LS_FORMAT 環境變數
|
||
'^ls' 格式設定。
|
||
|
||
範例：
|
||
|
||
cm ^ls
|
||
cm ^ls c:\workspace\src
|
||
|
||
cm ^ls --^format={^name}
|
||
(僅檔名。)
|
||
|
||
cm ^ls --^symlink
|
||
(顯示符號連結的相關資訊，而不顯示「已加上符號」的檔案或目錄的
|
||
相關資訊。可用於 UNIX 環境。)
|
||
|
||
cm ^ls code --^selector
|
||
(顯示目前工作區選擇器中 'code' 子目錄的
|
||
內容。)
|
||
|
||
cm ^ls /code --^selector="^rep 'myrep' ^path '/' ^branch '/^main'"
|
||
(顯示所指定選擇器上子目錄 '/code' 的內容。
|
||
請注意，此路徑是以伺服器格式指定。)
|
||
|
||
cm ^ls /code --^tree=44@myrep@denver:7070
|
||
(列出位於伺服器 'denver:7070' 儲存庫 'myrep' 變更集 44 的
|
||
子目錄 '/code'。)
|
||
|
||
cm ^ls /code --^tree=^br:/main/scm13596@myrep@denver:7070
|
||
(列出位在伺服器 'denver:7070' 儲存庫 'myrep' 分支
|
||
'/main/scm13596' 中最新變更集的子目錄 '/code'。)
|
||
|
||
cm ^ls /code --^tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@myrep@denver:7070
|
||
(列出位於伺服器 'denver:7070' 儲存庫 'myrep'
|
||
變更集 ae1390ed-7ce9-4ec3-a155-e5a61de0dc77 的
|
||
子目錄 '/code'。)
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_LIST ==
|
||
在伺服器上，列出指定類型的觸發器。
|
||
|
||
== CMD_USAGE_TRIGGER_LIST ==
|
||
用法：
|
||
|
||
cm ^trigger | ^tr ^list | ^ls [<子類型-類型>] [--^server=<儲存庫伺服器規格>]
|
||
[--^format=<字串_格式>]
|
||
|
||
選項：
|
||
|
||
子類型-類型 觸發器執行與觸發器作業。
|
||
輸入 'cm ^showtriggertypes' 以查看觸發器
|
||
類型的清單。
|
||
--^server 在指定的伺服器上列出觸發器。
|
||
如果未指定任何伺服器，請在用戶端上設定的
|
||
伺服器上執行命令。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解伺服器
|
||
規格。)
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
|
||
== CMD_HELP_TRIGGER_LIST ==
|
||
備註：
|
||
|
||
如果未指定此類型，將列出伺服器上的所有觸發器。
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{0} 觸發器位置。
|
||
{1} 觸發器名稱。
|
||
{2} 觸發器名稱。
|
||
{3} 觸發器名稱。
|
||
{4} 觸發器類型。
|
||
{5} 觸發器篩選。
|
||
|
||
範例：
|
||
cm ^trigger list after-mklabel
|
||
cm ^tr ^ls ^before-mkbranch --^server=myserver:8084
|
||
|
||
== CMD_DESCRIPTION_MANIPULATESELECTOR ==
|
||
將選擇器變更為時間。
|
||
|
||
== CMD_USAGE_MANIPULATESELECTOR ==
|
||
這是自動化命令，目的僅限用於自動化 'cm'。
|
||
方便使用的程度並不高。
|
||
|
||
用法：
|
||
|
||
cm ^manipulateselector | ^ms [<工作區_路徑> | <工作區_規格>] --^atdate=<選擇器_日期>
|
||
|
||
工作區_路徑 工作區的路徑。
|
||
工作區_規格 工作區規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解規格。)
|
||
選項：
|
||
|
||
--^atdate 傳回將重建工作區的選擇器，
|
||
因其已搜尋到指定的日期。
|
||
|
||
== CMD_HELP_MANIPULATESELECTOR ==
|
||
備註：
|
||
|
||
如果未指定路徑或工作區規格，命令將以
|
||
目前目錄做為工作區路徑。
|
||
|
||
範例：
|
||
|
||
cm ^manipulateselector c:\workspace --^atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm ^manipulateselector --^atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm ^manipulateselector > mySelector.txt --^atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm ^manipulateselector ^wk:build_wk@BUILDER --^atdate=yyyy-MM-ddTHH:mm:ss
|
||
|
||
== CMD_DESCRIPTION_MERGE ==
|
||
合併分支與另一個分支。
|
||
|
||
== CMD_USAGE_MERGE ==
|
||
用法：
|
||
|
||
cm ^merge <來源_規格> [--^merge] [--^cherrypicking] [--^forced]
|
||
[--^mergetype=(^onlyone|^onlysrc|^onlydst|^try|^forced)]
|
||
[--^interval-origin=<變更集規格> | --^ancestor=<變更集規格>]
|
||
[--^keepsource | --^ks] [--^keepdestination | --^kd]
|
||
[--^automaticresolution=<衝突-類型>[;...]]
|
||
[--^subtractive] [--^mount] [--^printcontributors]
|
||
[--^noprintoperations] [--^silent]
|
||
[(--^to=<分支規格> | --^destination=<分支規格>)[--^shelve]]
|
||
[--^no-dst-changes]
|
||
[-^c=<字串_註解> | --^commentsfile=<註解_檔案>]
|
||
[--^resolveconflict --^conflict=<索引>
|
||
--^resolutionoption=(^src|^dst|(^rename --^resolutioninfo=<字串名稱>))
|
||
--^mergeresultfile=<路徑> --^solvedconflictsfile=<路徑>]
|
||
[--^nointeractiveresolution]
|
||
[--^machinereadable [--^startlineseparator=<分隔符號>]
|
||
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
|
||
|
||
來源_規格 要從中合併之來源物件的規格：
|
||
- 分支規格：'[^br:/]br_name'
|
||
- 標籤規格：'^lb:lb_name'
|
||
- 變更集規格：'^cs:cs_number'
|
||
- 擱置規格：'^sh:shelve_number'
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
選項：
|
||
|
||
--^merge 執行合併。否則，列印找到的
|
||
衝突。
|
||
--^cherrypicking 合併包含在來源變更集內的
|
||
變更。如果合併來源規格是個標籤，
|
||
則不使用這個選項。
|
||
--^forced 如果來源與目的地變更集已經連接，
|
||
則不用檢查。
|
||
這個選項只能用於間隔合併
|
||
和揀選。
|
||
--^mergetype 如需詳細資訊，請參閱備註。
|
||
--^interval-origin 指定該選擇哪個變更集來做為
|
||
間隔起點，使合併僅處理
|
||
在來源變更集與所指定
|
||
間隔起點之間的不同內容。
|
||
--^ancestor 這是 --^interval-origin. 的別名。
|
||
--^keepsource 接受來源貢獻者中，項目有衝突的
|
||
所有變更。
|
||
--^keepdestination 保留目的地貢獻者中，項目有衝突的
|
||
變更。
|
||
--^automaticresolution 用於解決目錄衝突。這個選項
|
||
可讓您選擇應自動選取
|
||
來源貢獻者或目的地貢獻者
|
||
來解決衝突。
|
||
使用分號來分隔衝突類型。
|
||
如需詳細資訊，請參閱備註。
|
||
--^subtractive 刪除因合併所引入的變更。傳遞至
|
||
命令的參數 (來源_規格)
|
||
會用於指定要刪除變更的
|
||
來源位置。此來源必定是變更集。如果是
|
||
變更集間隔，則必須使用 '--^interval-origin'
|
||
來定義間隔起點。為了移除
|
||
變更，系統會建立全新的已簽出修訂，
|
||
其中將包含上一個項目的內容，
|
||
只是不包含已刪除的變更。
|
||
--^mount 指定儲存庫的裝載點。
|
||
--^printcontributors 列印出貢獻者 (基底、來源與
|
||
目的地)。
|
||
--^noprintoperations 以無訊息方式解決合併，完全
|
||
不顯示關於解決方法的資訊。
|
||
--^silent 不顯示任何輸出。
|
||
--^to | --^destination 運用完整衝突解決方法，
|
||
將合併目標作業執行至所指定的分支
|
||
(透過輸入分支規格或 brspec)。
|
||
「合併目標」(或無工作區合併) 是在伺服器端
|
||
完成的合併。而一般合併
|
||
是「來源」分支、標籤或變更集進行的工作區合併，
|
||
整個合併目標作業會完全
|
||
在伺服器上完成。在一般合併中，
|
||
「目的地」是指工作區，而在「合併目標」中，
|
||
一定要指定目的地 (這樣才合乎其名稱中的
|
||
「目標」)。
|
||
如需詳細資訊，請查看以下關於
|
||
「合併目標」功能的連結：
|
||
https://www.plasticscm.com/download/help/mergeto
|
||
--^shelve 建立包含合併結果 (加上合併追蹤資訊)
|
||
的擱置，而不是建立
|
||
新的變更集。當合併來源為擱置時，
|
||
這個選項將不可使用。這個
|
||
選項僅能用於 server-side-merge
|
||
(又名為「合併目標」)。因此，必須指定 '--^to' 和
|
||
'--^merge' 選項。
|
||
--^no-dst-changes 確定目的地貢獻者沒有任何變更
|
||
(目的地變更集也是共同
|
||
上層)。當目的地發生變更時，
|
||
將不允許進行合併。
|
||
-^c 將指定的註解套用至合併作業中
|
||
建立的變更集。
|
||
--^commentsfile 將指定檔案中的註解套用至合併作業中
|
||
建立的變更集。
|
||
--^resolveconflict (主要由外掛程式所使用。如需詳細資訊，請參閱備註。)
|
||
用於解決目錄衝突。
|
||
--^conflict 搭配 '--^resolveconflict' 標誌使用，指定
|
||
要解決衝突的索引，從 1 開始。
|
||
--^resolutionoption 搭配 '--^resolveconflict' 標誌使用，指示
|
||
解決衝突的類型。使用下列
|
||
其中一個選項：'^src'、'^dst'、'^rename'。
|
||
如需詳細資訊，請參閱備註。
|
||
--^resolutioninfo 搭配 '--^resolveconflict' 標誌使用，提供
|
||
當 '--^resolutionoption' 選項為 'rename' 時
|
||
將要使用的名稱。
|
||
--^mergeresultfile 搭配 '--^resolveconflict' 標誌使用，會將
|
||
不同呼叫之間所造成的衝突資訊
|
||
輸出至檔案。指定的路徑
|
||
將於第一個呼叫期間建立，並在後續的個別呼叫中
|
||
逐一更新。
|
||
--^solvedconflictsfile 搭配 '--^resolveconflict' 標誌使用，將
|
||
不同呼叫之間所解決衝突的資訊
|
||
輸出至檔案。指定的
|
||
路徑將在第一個呼叫期間建立，並在後續的個別呼叫中
|
||
逐一更新。
|
||
--^nointeractiveresolution (主要由外掛程式所使用。如需詳細資訊，請參閱備註。)
|
||
會避免提示使用者進行手動衝突解決。
|
||
如此將不解決目錄衝突。
|
||
--^machinereadable (主要由外掛程式所使用。如需詳細資訊，請參閱備註。)
|
||
以易於剖析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何起始。(預設：空的字串。)
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何結束。(預設：空的字串。)
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
應如何分隔欄位。(預設：
|
||
空格。)
|
||
|
||
== CMD_HELP_MERGE ==
|
||
備註：
|
||
|
||
這個命令可用來合併兩個分支之間的變更，或是標籤與分支
|
||
之間的變更。合併的目的地一定是個分支。
|
||
合併來源會以引數方式指定。
|
||
目的地是工作區的目前內容。
|
||
例如，若要顯示將從分支 task001 合併至主要分支
|
||
的元素，選擇器必須指向主要分支，工作區
|
||
一定會更新，並接著：
|
||
cm ^merge ^br:/task001
|
||
|
||
若要確實實際此合併，則要加上 '--^merge' 選項：
|
||
cm ^merge ^br:/task001 --^merge
|
||
|
||
若要定義合併來源，可以使用下列規格：
|
||
|
||
- 分支規格 (brspec)：
|
||
[^br:/]br_name
|
||
範例：^br:/main/task001
|
||
(上面範例是執行從此分支中的最新變更集所進行的合併作業。)
|
||
|
||
- 標籤規格 (lbspec)：
|
||
^lb:lb_name
|
||
範例：^lb:BL001
|
||
(從標記的變更集進行合併。)
|
||
|
||
- 變更集規格：
|
||
^cs:cs_number
|
||
範例：^cs:25
|
||
(從指定的變更集內容進行合併。)
|
||
|
||
- 擱置規格 (shspec)：
|
||
^sh:shelve_number
|
||
範例：^sh:2
|
||
(從指定的擱置內容進行合併。)
|
||
|
||
若要自動解決目錄衝突，請使用 '--^automaticresolution' 選項，
|
||
並在指定衝突類型後指定必須在合併作業期間
|
||
選取的貢獻者 (來源或目的地)。
|
||
(使用分號 (;) 來分隔個別的「衝突類型-貢獻者」配對。)
|
||
例如:
|
||
cm ^merge ^cs:2634 --^merge --^automaticresolution=^eviltwin-src;^changedelete-src
|
||
(從變更集 2634 進行的合併作業，可以解決 "^eviltwin" 與
|
||
"^changedelete" 衝突，因這個作業會在兩邊都保留來源 ("-^src")
|
||
貢獻者。)
|
||
- 接在衝突類型之後的 "-^src" 後綴，將會指示合併命令保留
|
||
來源貢獻者變更。
|
||
- 如果是 "-^dst" 後綴，則將保留目的地貢獻者變更。
|
||
下面是合併命令可支援的衝突類型清單：
|
||
"^movedeviltwin"、"^eviltwin"、"^changedelete"、"^deletechange"、"^movedelete"、
|
||
"^deletemove"、"^loadedtwice"、"^addmove"、"^moveadd"、"^divergentmove",
|
||
"^cyclemove"、"^all".
|
||
"^all" 值會覆寫其他的選項。在下面範例中，
|
||
將忽略 "^eviltwin-dst"。
|
||
cm ^merge ^br:/main/task062 --^merge --^automaticresolution=^all-src;^eviltwin-dst
|
||
請查看下面連結，以深入瞭解合併衝突：
|
||
https://www.plasticscm.com/download/help/directorymerges
|
||
|
||
下面是 '--^mergetype' 的可用選項：
|
||
^onlyone 在只有一個貢獻者修改過項目時
|
||
自動合併。
|
||
^onlysrc 在只有來源貢獻者修改過項目時
|
||
自動合併。
|
||
^onlydst 在只有目的地貢獻者修改過項目時
|
||
自動合併。
|
||
^try 在只有一個貢獻者修改過程式碼的衝突片段
|
||
(個別衝突) 時自動合併。
|
||
^forced 一律嘗試解決所有非自動衝突。
|
||
|
||
下面列出主要由外掛程式與整合作業所使用的選項：
|
||
- '--^resolveconflict' 可解決目錄衝突。這時也必須使用
|
||
下列選項：
|
||
- '--^conflict' 是所要解決衝突的索引，
|
||
從 1 開始。
|
||
- '--^resolutionoption' 指示要使用的衝突解決
|
||
方法。可選取的解決方法如下：
|
||
- '^src' 可保留來源變更，並捨棄
|
||
目的地變更
|
||
- '^dst' 可保留目的地變更，並捨棄
|
||
來源變更
|
||
- '^rename' (僅在衝突類型支援這個解決方法時
|
||
適用) 可將目的地重新命名成搭配
|
||
'--^resolutioninfo' 選項所提供的指定名稱。
|
||
- '--^resolutioninfo' 可提供將用於 '^rename' 解決方法
|
||
的名稱
|
||
- '--^mergeresultfile' 與 '--^solvedconflictsfile'，都可用於
|
||
儲存不同呼叫之間的合併資訊。
|
||
- '--^nointeractiveresolution' 可指示合併不要求使用者進行
|
||
手動衝突解決方法。
|
||
- '--^machinereadable' 和 '--^startlineseparator'、'--^endlineseparator'、
|
||
'--^fieldseparator' 等選項，可將輸出列印成電腦可讀取的
|
||
格式 (易於剖析的)。
|
||
範例：
|
||
cm ^merge --^machinereadable --^startlineseparator=start@_@line \
|
||
--^endlineseparator=new@_@line --^fieldseparator=def#_#sep \
|
||
--^mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp \
|
||
--^solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp \
|
||
--^resolveconflict --^conflict=1 --^resolutionoption=rename \
|
||
--^resolutioninfo=目錄_目的地 ^br:/main/task --^merge
|
||
|
||
範例：
|
||
|
||
cm ^merge ^br:/task001
|
||
(不合併，只列印出要合併的項目。)
|
||
|
||
cm ^merge ^br:/task001 --^merge
|
||
(執行從分支 'task001' 進行的合併。)
|
||
|
||
cm ^merge ^cs:5 --^merge --^cherrypicking --^interval-origin=^cs:2
|
||
(從變更集間隔 [2,5] 揀選。)
|
||
|
||
cm ^merge ^cs:8 --^merge --^subtractive --^keepdestination
|
||
(從變更集 8 削減合併，保留目的地中有衝突的
|
||
元素變更。)
|
||
|
||
cm ^merge ^br:/main/task001 --^to=^br:/main --^merge -^c="整合式新 UI"
|
||
(執行伺服器端合併，又名「合併目標」，將從分支 'task001' 合併至
|
||
分支 'main'，並設定註解。)
|
||
|
||
cm ^merge ^br:/main/task001 --^to=^br:/main --^merge --^shelve
|
||
(執行從分支 'task001' 進行伺服器端合併至分支 'main'，並在擱置上
|
||
保留結果。)
|
||
|
||
cm ^merge ^sh:2 --^to=^br:/main --^merge --^no-dst-changes
|
||
(只有在結果是從目前 'main' 前端所建立時，才將擱置 2 套用
|
||
至 'main'。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
|
||
建立新屬性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_CREATE ==
|
||
用法：
|
||
|
||
cm ^attribute | ^att ^create | ^mk <屬性_名稱>
|
||
|
||
屬性_名稱 屬性名稱
|
||
|
||
== CMD_HELP_ATTRIBUTE_CREATE ==
|
||
範例：
|
||
|
||
cm ^attribute ^create 狀態
|
||
(建立屬性 '狀態'。)
|
||
|
||
cm ^att ^mk 整合
|
||
(建立屬性 '整合'。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH ==
|
||
可讓使用者管理分支。
|
||
|
||
== CMD_USAGE_BRANCH ==
|
||
用法：
|
||
|
||
cm ^branch | ^br <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^rename
|
||
^history
|
||
^showmain
|
||
^showmerges
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^branch <命令> --^usage
|
||
cm ^branch <命令> --^help
|
||
|
||
== CMD_HELP_BRANCH ==
|
||
範例：
|
||
|
||
cm ^branch /main/scm21345
|
||
cm ^branch ^create /main/scm21345
|
||
cm ^branch ^delete /main/scm21345
|
||
cm ^branch ^rename /main/scm21345 scm21346
|
||
cm ^branch ^history /main/scm21345
|
||
cm ^branch ^showmain
|
||
cm ^branch ^showmerges file.txt
|
||
|
||
== CMD_DESCRIPTION_BRANCH_CREATE ==
|
||
建立新分支。
|
||
|
||
== CMD_USAGE_BRANCH_CREATE ==
|
||
用法：
|
||
|
||
cm ^branch | ^br [^create | ^mk] <分支規格>
|
||
[--^changeset=<變更集規格> | --^label=<標籤規格>]
|
||
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
|
||
|
||
分支規格 新分支的名稱或規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支規格。)
|
||
|
||
選項：
|
||
|
||
--^changeset 用作新分支起點的變更集。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集規格。)
|
||
--^label 用作新分支起點的標籤。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解標籤規格。)
|
||
-^c 將指定的文字填入新分支的
|
||
註解欄位。
|
||
|
||
-^commentsfile 將所指定檔案的內容填入
|
||
新分支的註解欄位。
|
||
|
||
== CMD_HELP_BRANCH_CREATE ==
|
||
備註：
|
||
|
||
若要建立最上層分支，請指定不含任何階層的名稱。
|
||
例如:
|
||
|
||
cm ^br /dev
|
||
|
||
如果未指定選擇性參數 '--^changeset'，新分支的基底將是
|
||
上層分支的最後一個變更集。如果新分支
|
||
是最上層分支，則使用的基底變更集將會是 cset 0。
|
||
|
||
您可以使用 '-^c' 或 '-^m' 切換來指定註解：
|
||
|
||
cm ^branch /main/task001 -^c="這是註解"
|
||
cm ^branch /main/task001 -^m "這是註解"
|
||
|
||
設定 PLASTICEDITOR 環境變數，以指定要用來輸入註解
|
||
的編輯器。如果已經設定 PLASTICEDITOR 環境變數，
|
||
且註解是空的，編輯器將自動啟動，並允許您
|
||
指定註解。
|
||
|
||
範例：
|
||
|
||
cm ^branch task001
|
||
cm ^branch ^create task001
|
||
cm ^branch ^mk task001
|
||
cm ^br ^mk task001
|
||
(在目前工作區的儲存庫中，建立最上層的分支
|
||
'task001'。)
|
||
|
||
cm ^branch ^br:/task001/task002@
|
||
(建立 'task002' 來做為 'task001' 的下層分支。)
|
||
|
||
cm ^br /main/task001@myrep@myserver:8084 -^c="我的註解"
|
||
(建立 'task001' 分支做為儲存庫 'myrep@myserver:8084'
|
||
中 'main' 的下層分支，加上 '我的註解'。)
|
||
|
||
cm ^branch ^br:/main/task001 --^changeset=2837 -^commentsfile=commenttask001.txt
|
||
(建立 'task001' 分支做為 'main' 的下層分支，基底為 'changeset=2837'，
|
||
並將註解套用至 'commenttask001.txt' 檔案。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_DELETE ==
|
||
刪除一或多個分支。
|
||
|
||
== CMD_USAGE_BRANCH_DELETE ==
|
||
用法：
|
||
|
||
cm ^branch | ^br ^delete | ^rm <分支規格>[ ...]
|
||
|
||
分支規格 要刪除的分支。使用空格分隔分支。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支
|
||
規格。)
|
||
|
||
== CMD_HELP_BRANCH_DELETE ==
|
||
備註：
|
||
|
||
此命令刪除一或多個分支。
|
||
|
||
範例：
|
||
|
||
cm ^branch ^delete /main/task001
|
||
(刪除屬於目前工作區中儲存庫內 'main' 的下層分支，
|
||
名稱為 'task001' 的分支。)
|
||
|
||
cm ^br ^rm main/task002 /main/task012@reptest@myserver:8084
|
||
(刪除目前工作區之儲存庫內的分支 '/main/task002'，
|
||
以及儲存庫 'reptest@myserver:8084' 內的分支 '/main/task012'。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_RENAME ==
|
||
重新命名分支。
|
||
|
||
== CMD_USAGE_BRANCH_RENAME ==
|
||
用法：
|
||
|
||
cm ^branch | ^br ^rename <分支規格> <新_名稱>
|
||
|
||
分支規格 要重新命名的分支。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支規格。)
|
||
新_名稱 分支的新名稱。
|
||
|
||
== CMD_HELP_BRANCH_RENAME ==
|
||
備註：
|
||
|
||
此命令會重新命名分支。
|
||
|
||
範例：
|
||
|
||
cm ^branch ^rename /main/task0 task1
|
||
(將分支 '/main/task0' 重新命名成 '/main/task1'。)
|
||
|
||
cm ^br ^rename ^br:/main@reptest@server2:8084 secondary
|
||
(將儲存庫 'reptest' 的分支 'main' 重新命名成 'secondary'。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_HISTORY ==
|
||
顯示分支的歷史記錄。
|
||
|
||
== CMD_USAGE_BRANCH_HISTORY ==
|
||
用法：
|
||
|
||
cm ^branch | ^br ^history <分支規格> [--^dateformat=<日期_格式>]
|
||
[--^machinereadable]
|
||
|
||
分支規格 要保存其歷史記錄的分支規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支規格。)
|
||
|
||
選項：
|
||
|
||
--^dateformat 用於輸出日期的格式。
|
||
--^machinereadable 以易於剖析的格式輸出結果。
|
||
|
||
== CMD_HELP_BRANCH_HISTORY ==
|
||
範例：
|
||
|
||
cm ^branch ^history ^br:/main/scm001@myrepository@myserver:8084
|
||
(顯示 'myserver' 伺服器上，'myrepository' 儲存庫之分支 '/main/scm001'
|
||
的歷史記錄。)
|
||
|
||
cm ^br ^history main --^dateformat="yyyy, dd MMMM" --^machinereadable
|
||
(以指定日期格式與易於剖析的格式，顯示目前儲存庫
|
||
之 'main' 分支的歷史記錄。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
|
||
顯示儲存庫的主要分支。
|
||
這是自動化命令，目的僅限用於自動化 'cm'。
|
||
儲存庫的主要分支很有可能是 '/main'。
|
||
|
||
== CMD_USAGE_BRANCH_SHOWMAIN ==
|
||
用法：
|
||
|
||
cm ^branch | ^br ^showmain [<儲存庫規格>] [--^encoding=<名稱>]
|
||
[--^format=<格式_字串>] [--^dateformat=<日期_格式>]
|
||
|
||
儲存庫規格 其中將顯示主要分支的
|
||
儲存規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫規格。)
|
||
|
||
選項：
|
||
|
||
--^encoding 指定要用於輸出的編碼，
|
||
例如：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^dateformat 用於輸出日期的格式。
|
||
|
||
== CMD_HELP_BRANCH_SHOWMAIN ==
|
||
備註：
|
||
|
||
這個命令會顯示儲存庫的主要分支。
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{^id} 分支 ID。
|
||
{^comment} 註解。
|
||
{^date} 日期。
|
||
{^name} 名稱。
|
||
{^owner} 擁有者。
|
||
{^parent} 上層分支名稱。
|
||
{^repository} 儲存庫。
|
||
{^repname} 儲存庫名稱。
|
||
{^repserver} 伺服器。
|
||
{^changeset} 分支的前端變更集。
|
||
|
||
範例：
|
||
|
||
cm ^branch ^showmain
|
||
(顯示目前工作區之儲存庫的主要分支。)
|
||
|
||
cm ^branch ^showmain repo@server:8084
|
||
(顯示伺服器 'server:8084' 內，儲存庫 'repo' 的
|
||
主要分支。)
|
||
|
||
cm ^br ^showmain --^dateformat="yyyy, dd MMMM" --^encoding=utf8
|
||
(以指定的日期格式顯示儲存庫的主要分支，
|
||
且輸出的編碼為 utf8。)
|
||
|
||
cm ^br ^showmain --^format="{^id} - {^name}"
|
||
(顯示儲存庫的主要分支，且只列印其 ID 與名稱。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
|
||
顯示待合併的分支。
|
||
|
||
== CMD_USAGE_BRANCH_SHOWMERGES ==
|
||
這是自動化命令，目的僅限用於自動化 'cm'。
|
||
方便使用的程度並不高。
|
||
|
||
用法：
|
||
|
||
cm ^branch | ^br ^showmerges <項目_路徑>[ ...]
|
||
[--^format=<格式_字串>]
|
||
[--^dateformat=<日期_格式>]
|
||
|
||
選項：
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^dateformat 用於輸出日期的格式。
|
||
|
||
== CMD_HELP_BRANCH_SHOWMERGES ==
|
||
備註：
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{^id} 分支 ID。
|
||
{^comment} 註解。
|
||
{^date} 日期。
|
||
{^name} 名稱。
|
||
{^owner} 擁有者。
|
||
{^parent} 上層分支名稱。
|
||
{^parentid} 上層分支 ID。
|
||
{^repid} 儲存庫 ID。
|
||
{^repository} 儲存庫。
|
||
{^repname} 儲存庫名稱。
|
||
{^repserver} 儲存庫伺服器。
|
||
|
||
範例：
|
||
|
||
cm ^branch ^showmerges file.txt
|
||
(顯示涉及 'file.txt' 待合併作業的分支。)
|
||
|
||
cm ^branch ^showmerges file.txt --^format="{^date} {^name}" --^dateformat="yyMMdd"
|
||
(顯示涉及合併作業的分支，並以指定的日期格式，
|
||
只列印日期與名稱。)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY ==
|
||
可讓使用者管理儲存庫。
|
||
|
||
== CMD_USAGE_REPOSITORY ==
|
||
用法：
|
||
|
||
cm ^repository | ^repo <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^list | ^ls
|
||
^rename
|
||
^add
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^repository <命令> --^usage
|
||
cm ^repository <命令> --^help
|
||
|
||
== CMD_HELP_REPOSITORY ==
|
||
範例：
|
||
|
||
cm ^repository
|
||
cm ^repository ^list
|
||
cm ^repository 新儲存庫
|
||
cm ^repository ^create 新儲存庫
|
||
cm ^repository ^rename 舊名稱 新名稱
|
||
cm ^repository ^add C:\repo\
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_CREATE ==
|
||
在伺服器上建立儲存庫。
|
||
|
||
== CMD_USAGE_REPOSITORY_CREATE ==
|
||
用法：
|
||
|
||
cm ^repository | ^repo <儲存庫_名稱>
|
||
cm ^repository | ^repo <儲存庫伺服器規格> <儲存庫_名稱>[ ...]
|
||
cm ^repository | ^repo [^create | ^mk] <儲存庫_名稱>
|
||
|
||
儲存庫伺服器規格 儲存庫伺服器規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺服器
|
||
規格。)
|
||
儲存庫_名稱 新儲存庫或多個儲存的名稱或多個名稱。
|
||
使用空格分隔儲存庫名稱。
|
||
|
||
== CMD_HELP_REPOSITORY_CREATE ==
|
||
範例：
|
||
|
||
cm ^repository MyRep
|
||
cm ^repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
|
||
cm ^repo ^create Rep01
|
||
cm ^repo ^mk 清單
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_DELETE ==
|
||
從伺服器中刪除儲存庫。
|
||
|
||
== CMD_USAGE_REPOSITORY_DELETE ==
|
||
用法：
|
||
|
||
cm ^repository | ^repo ^delete | ^rm <儲存庫規格>
|
||
|
||
選項：
|
||
|
||
儲存庫規格 儲存庫規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫規格。)
|
||
|
||
== CMD_HELP_REPOSITORY_DELETE ==
|
||
備註：
|
||
|
||
從儲存庫伺服器中刪除儲存庫。
|
||
資料並未從資料庫後端中移除，但已拔除連線，
|
||
因此無法再存取。
|
||
(之後可重新連接資料，請參閱 'cm ^repository ^add'。)
|
||
|
||
範例：
|
||
|
||
cm ^repository ^delete myrepository@^repserver:myserver:8084
|
||
cm ^repository ^rm myrepository@myserver:8084
|
||
cm ^repo ^rm myrepository
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_LIST ==
|
||
列出伺服器上的儲存庫。
|
||
|
||
== CMD_USAGE_REPOSITORY_LIST ==
|
||
用法：
|
||
|
||
cm ^repository | ^repo [^list | ^ls] [<儲存庫伺服器規格>] [--^format=<字串_格式>]
|
||
|
||
選項：
|
||
|
||
儲存庫伺服器規格 儲存庫伺服器規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺服器
|
||
規格。)
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
|
||
== CMD_HELP_REPOSITORY_LIST ==
|
||
備註：
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
|
||
此命令的輸出參數如下所示：
|
||
|
||
{^repid} | {0} 儲存庫識別碼。
|
||
{^repname} | {1} 儲存庫名稱。
|
||
{^repserver} | {2} 伺服器名稱。
|
||
{^repowner} | {3} 儲存庫擁有者。
|
||
{^repguid} | {4} 儲存庫的唯一識別碼。
|
||
{^tab} 插入定位字元空格。
|
||
{^newline} 插入新行。
|
||
|
||
如果格式參數值是 '^TABLE'，輸出將使用
|
||
資料表格式與 {^repid}、{^repname} 和 {^repserver} 等欄位印出。
|
||
|
||
範例：
|
||
|
||
cm ^repository
|
||
(列出所有儲存庫。)
|
||
|
||
cm ^repository ^list localhost:8084 --^format="{1, -20} {3}"
|
||
(在 20 個空格中寫入儲存庫名稱，靠左對齊，接著接上空白，
|
||
再寫入儲存庫擁有者。)
|
||
|
||
cm ^repository ^ls localhost:8084 --^format="{^repname, -20} {^repowner}"
|
||
(如先前範例方式，寫入名稱。)
|
||
|
||
cm ^repo ^ls localhost:8084 --^format=^TABLE
|
||
(使用資料格式，以及儲存庫 ID、儲存庫名稱、儲存庫伺服器
|
||
名稱欄位，寫入儲存庫的清單。)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_RENAME ==
|
||
重新命名儲存庫。
|
||
|
||
== CMD_USAGE_REPOSITORY_RENAME ==
|
||
用法：
|
||
|
||
cm ^repository | ^repo ^rename [<儲存庫規格>] <新_名稱>
|
||
|
||
儲存庫規格 要重新命名的儲存庫。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
規格。)
|
||
新_名稱 儲存庫的新名稱。
|
||
|
||
== CMD_HELP_REPOSITORY_RENAME ==
|
||
備註：
|
||
|
||
此命令會重新命名儲存庫。
|
||
如果未指定儲存格規格，將直接使用目前儲存庫。
|
||
|
||
範例：
|
||
|
||
cm ^repository ^rename development
|
||
(目前的儲存庫將重新命名成為 'development'。)
|
||
|
||
cm ^repo ^rename ^rep:default@SERVER:8084 development
|
||
('SERVER' 上的 'default' 儲存庫將重新命名為 'development'。)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_ADD ==
|
||
以新增資料庫方式，連接現有的儲存庫。
|
||
|
||
== CMD_USAGE_REPOSITORY_ADD ==
|
||
用法：
|
||
|
||
cm ^repository | ^repo ^add <資料庫_檔案> <儲存庫_名稱> <儲存庫伺服器規格>
|
||
|
||
資料庫_檔案 在資料庫後端之資料庫檔案的名稱。
|
||
儲存庫_名稱 儲存庫的名稱。
|
||
儲存庫伺服器規格 儲存庫伺服器規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
伺服器規格。)
|
||
|
||
== CMD_HELP_REPOSITORY_ADD ==
|
||
備註：
|
||
|
||
將現有的儲存庫資料庫重新連接至伺服器。
|
||
範例：使用 'cm ^repository ^delete' 命令後，使用 '^add' 命令，
|
||
將儲存庫從一部伺服器中移動到其他伺服器，或是重新還原
|
||
封存的儲存庫。
|
||
|
||
範例：
|
||
|
||
cm ^repository ^add rep_27 myrepository myserver:8084
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_CREATE ==
|
||
建立在伺服器上的新觸發器。
|
||
|
||
== CMD_USAGE_TRIGGER_CREATE ==
|
||
用法：
|
||
|
||
cm ^trigger | ^tr ^create | ^mk <子類型-類型> <新_名稱> <指令碼_路徑>
|
||
[--^position=<新_位置>]
|
||
[--^filter=<字串_篩選>]
|
||
[--^server=<儲存庫伺服器規格>]
|
||
|
||
子類型-類型 觸發器執行與觸發器作業。
|
||
輸入 'cm ^showtriggertypes' 以查看觸發器
|
||
類型的清單。
|
||
新_名稱 新觸發器的名稱。
|
||
指令碼_路徑 要執行之指令碼所在的伺服器的
|
||
磁碟路徑。如果命令行開頭為 "^webtrigger"，
|
||
觸發器將視為 Web 觸發器。如需
|
||
如需詳細資訊，請參閱備註。
|
||
|
||
選項：
|
||
|
||
--^position 指定觸發器的新位置。
|
||
此位置不得由其他相同類型的觸發器
|
||
使用。
|
||
--^filter 僅檢查符合已指定篩選條件的項目。
|
||
--^server 建立在所指定伺服器上的觸發器。
|
||
如果未指定任何伺服器，請在用戶端上設定的
|
||
伺服器上執行命令。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
伺服器規格。)
|
||
|
||
== CMD_HELP_TRIGGER_CREATE ==
|
||
備註：
|
||
|
||
Web 觸發器：藉由輸入 "^webtrigger <目標-uri>"
|
||
做為觸發器命令，以建立 Web 觸發器。在此情況下，觸發器將對應指定的 URI 來執行
|
||
POST 查詢，其中要求本文包含具有觸發器
|
||
環境變數的 JSON 字典，以及指向字串陣列
|
||
的 INPUT 金鑰。
|
||
|
||
範例：
|
||
|
||
cm ^trigger ^create ^after-setselector "BackupMgr" "/path/to/script" --^position=4
|
||
|
||
cm ^tr ^mk ^before-mklabel new "/path/to/script" --^server=myserver:8084
|
||
|
||
cm ^tr ^mk ^after-mklabel Log "/path/to/script" --^filter="^rep:myRep,LB*"
|
||
(只有當標籤名稱以 'LB' 為開頭，且建立所在儲存庫名為
|
||
'myRep' 時，這個觸發器才會執行。)
|
||
|
||
cm ^tr ^mk ^after-checkin NotifyTeam "^webtrigger http://myserver.org/api"
|
||
|
||
== CMD_DESCRIPTION_MOVE ==
|
||
移動或重新命名檔案或目錄。
|
||
|
||
== CMD_USAGE_MOVE ==
|
||
用法：
|
||
|
||
cm ^move | ^mv <來源_路徑> <目的地_路徑> [--^format=<字串_格式>]
|
||
[--^errorformat=<字串_格式>]
|
||
|
||
來源_路徑 來源項目路徑。
|
||
目的地_路徑 目的地項目路徑。
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^errorformat 以指定的格式擷取錯誤訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
|
||
== CMD_HELP_MOVE ==
|
||
備註：
|
||
|
||
這個命令會移動或重新命名儲存庫中的項目。
|
||
變更也是在本機檔案系統中完成。
|
||
|
||
如果來源路徑是檔案，則目的地路徑可能為檔案或
|
||
目錄。在第一個情況中，會重新命名檔案；否則，會
|
||
移動項目。
|
||
如果來源路徑是個目錄，目的地路徑必須是目錄。
|
||
|
||
要移動或重新命名的項目必須存在。
|
||
|
||
格式：
|
||
{0} 來源路徑 (同時適用於 '--^format' 和 '--^errorformat')
|
||
{1} 目的地路徑 (同時適用於 '--^format' 和 '--^errorformat')
|
||
|
||
範例：
|
||
|
||
cm ^move file.txt file.old
|
||
(重新命名項目。)
|
||
|
||
cm ^mv .\file.old .\oldFiles
|
||
(將 'file.old' 移動到 'oldFiles'。)
|
||
|
||
cm ^move .\src .\src2
|
||
(重新命名目錄。)
|
||
|
||
== CMD_DESCRIPTION_LABEL ==
|
||
可讓使用者管理標籤。
|
||
|
||
== CMD_USAGE_LABEL ==
|
||
用法：
|
||
|
||
cm ^label | ^lb <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^rename
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^label <命令> --^usage
|
||
cm ^label <命令> --^help
|
||
|
||
== CMD_HELP_LABEL ==
|
||
範例：
|
||
|
||
cm ^label 我的新標籤 ^cs:42
|
||
('^create' 命令是選擇性。)
|
||
|
||
cm ^label ^rename 我的新標籤 新標籤名稱
|
||
cm ^label ^delete 新標籤名稱
|
||
|
||
== CMD_DESCRIPTION_LABEL_CREATE ==
|
||
將標籤套用至變更集，並視需要建立標籤。
|
||
|
||
== CMD_USAGE_LABEL_CREATE ==
|
||
用法：
|
||
|
||
cm ^label [^create] <分支規格> [<變更集規格> | <工作區_路徑>]
|
||
[--^allxlinkedrepositories]
|
||
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
|
||
|
||
分支規格 新標籤名稱。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解標籤
|
||
規格。)
|
||
變更集規格 標籤變更集的名稱或完整規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
|
||
規格。)
|
||
工作區_路徑 標籤工作區的路徑。(工作區所指向的
|
||
變更集將加註標籤。)
|
||
|
||
選項：
|
||
|
||
--^allxlinkedrepositories 建立在所有 Xlink 連結儲存庫中的新標籤。
|
||
-^c 將指定的註解套用至新標籤。
|
||
-^commentsfile 將指定檔案中的註解套用至
|
||
新標籤。
|
||
|
||
== CMD_HELP_LABEL_CREATE ==
|
||
備註：
|
||
|
||
設定 PLASTICEDITOR 環境變數，以指定要輸入
|
||
註解的編輯器。
|
||
|
||
範例：
|
||
|
||
cm ^label ^create ^lb:BL001 ^cs:1203 -^commentsfile=commentlb001.txt
|
||
(建立變更集 1203 所連接的標籤 'BL001'，並套用在
|
||
'commentlb001.txt' 檔案中的註解。)
|
||
|
||
cm ^label BL002 ^cs:1203 -^c="初次發行"
|
||
(建立標籤 'BL002'，含註解，並連接至變更集 1203。)
|
||
|
||
== CMD_DESCRIPTION_LABEL_DELETE ==
|
||
刪除一或多個標籤。
|
||
|
||
== CMD_USAGE_LABEL_DELETE ==
|
||
用法：
|
||
|
||
cm ^label ^delete <標籤規格>[ ...]
|
||
|
||
標籤規格 要刪除的標籤。使用空格分隔標籤。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解標籤
|
||
規格。)
|
||
|
||
== CMD_HELP_LABEL_DELETE ==
|
||
備註：
|
||
|
||
此命令刪除一或多個標籤。
|
||
|
||
範例：
|
||
|
||
cm ^label ^delete ^lb:BL001
|
||
(刪除標籤 'BL001'。)
|
||
|
||
cm ^label ^delete ^lb:BL001 ^lb:BL002@reptest@server2:8084
|
||
(刪除標籤 'BL001' 和 'BL002'。)
|
||
|
||
== CMD_DESCRIPTION_LABEL_RENAME ==
|
||
重新命名標籤。
|
||
|
||
== CMD_USAGE_LABEL_RENAME ==
|
||
用法：
|
||
|
||
cm ^label ^rename <標籤規格> <新_名稱>
|
||
|
||
標籤規格 要重新命名的標籤。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解標籤規格。)
|
||
新_名稱 新增標籤的名稱。
|
||
|
||
== CMD_HELP_LABEL_RENAME ==
|
||
備註：
|
||
|
||
此命令會重新命名標籤。
|
||
|
||
範例：
|
||
|
||
cm ^label ^rename ^lb:BL001 BL002
|
||
(將標籤 'BL001' 重新命名成 'BL002'。)
|
||
|
||
== CMD_DESCRIPTION_OBJECTSPEC ==
|
||
描述如何寫入物件規格。
|
||
|
||
== CMD_USAGE_OBJECTSPEC ==
|
||
用法：
|
||
cm ^objectspec
|
||
可取得所有關於如何建立物件規格的資訊。
|
||
|
||
== CMD_HELP_OBJECTSPEC ==
|
||
多種 Unity VCS 命令都會將「物件規格」當做輸入，以便參考至
|
||
指定的物件 (通常是分支、變更集、儲存庫等)。
|
||
|
||
這份文件說明不同的可用「規格」，及其
|
||
建置方式。
|
||
|
||
每種規格類型都會以唯一標籤做為開頭，例如 "^rep:" 或 "^cs:"。這個標籤
|
||
必須專為接受一般物件規格的命令建立，例如，
|
||
"cm ^setowner 物件_規格"，但只接受單一類型規格的命令，例如
|
||
"cm ^getfile 修訂_規格"，經常會略過此標籤。
|
||
|
||
-- 儲存庫伺服器規格 (repserverspec) --
|
||
^repserver:name:port
|
||
|
||
範例：
|
||
cm ^repo ^list ^repserver:skull:8084
|
||
cm ^repo ^list skull:8084
|
||
|
||
快速筆記：
|
||
我們將此類規格稱為「儲存庫伺服器規格」，而不光只是
|
||
「伺服器規格」，原因如下。很久以前，我們有不同的工作區和儲存庫
|
||
伺服器，而沿用了當時的命名方式。
|
||
|
||
-- 儲存庫規格 (repspec) --
|
||
^rep:rep_name@[儲存庫伺服器規格]
|
||
|
||
範例：
|
||
cm ^showowner ^rep:codice@localhost:6060
|
||
(在這個範例中，必須使用 "^rep:"，因為 ^showowner 不只准許儲存庫
|
||
也准許其他類型的物件。所以會要求使用者指明
|
||
物件類型。)
|
||
|
||
-- 分支規格 (brspec) --
|
||
^br:[/]br_name[@repspec]
|
||
|
||
範例：
|
||
cm ^switch ^br:/main@^rep:plastic@^repserver:skull:9095
|
||
(這時並不需要 "^br:"、"^rep" 和 "^repserver"，因此
|
||
命令准許更短的形式：
|
||
"cm ^switch main@plastic@skull:9095"。)
|
||
|
||
cm ^find ^revisions "^where ^branch='^br:/main/task001'"
|
||
|
||
備註：
|
||
分支並不強制使用初始符號 '/'。我們習慣以 /main、
|
||
/main/task001 (依此類推) 方式，指定所有分支。如今，我們偏用
|
||
較短的格式 main、main/task001，使命令更為簡潔。
|
||
|
||
-- 變更集規格 --
|
||
^cs:cs_number|cs_GUID[@repspec]
|
||
|
||
變更集的號碼或 GUID 可進行指定。
|
||
|
||
範例：
|
||
cm ^ls /code --^tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070
|
||
|
||
-- 標籤規格 (labelspec) --
|
||
^lb:lb_name[@repspec]
|
||
|
||
範例：
|
||
cm ^switch ^lb:RELEASE2.0
|
||
cm ^switch ^lb:RELEASE1.4@myrep@MYSERVER:8084
|
||
|
||
-- 修訂規格 --
|
||
修訂規格分為多種類型：
|
||
|
||
^rev:item_path[#(分支規格|變更集規格|標籤規格]
|
||
|
||
^rev:^serverpath:item_path#(分支規格|變更集_規格|標籤_規格)
|
||
|
||
^rev:^revid:rev_id[@rep_spec]
|
||
|
||
^rev:^itemid:item_id#(分支_規格|變更集_規格|標籤_規格)
|
||
|
||
範例：
|
||
cm ^diff ^rev:readme.txt#^cs:19 ^rev:readme.txt#^cs:20
|
||
|
||
cm ^diff ^serverpath:/doc/readme.txt#^cs:19@myrepo \
|
||
^serverpath:/doc/readme.txt#^br:/main@myrepo@localhost:8084
|
||
|
||
cm ^cat ^revid:1230@^rep:myrep@^repserver:myserver:8084
|
||
|
||
-- 項目規格 --
|
||
^item:path
|
||
很少使用。
|
||
|
||
範例：
|
||
cm ^find ^revision "^where ^item='^item:.'"
|
||
|
||
-- 屬性規格 --
|
||
^att:att_name[@repspec]
|
||
|
||
範例：
|
||
cm ^attribute ^set ^att:merged@code@doe:8084 ^cs:25@code@doe:8084 完成
|
||
|
||
-- 擱置規格 --
|
||
^sh:sh_number[@repspec]
|
||
|
||
範例：
|
||
cm ^diff ^sh:2 ^sh:4
|
||
|
||
-- 工作區規格 --
|
||
^wk:name@clientmachine
|
||
|
||
很少使用，僅套用到與工作區相關的命令。可用於
|
||
依據名稱和機器 (而不依據路徑) 來指定工作區。
|
||
|
||
範例：
|
||
cm ^showselector ^wk:codebase@modok
|
||
|
||
快速筆記：
|
||
這些是過去使用 Plastic SCM 2.x 時所建立的規格，當時使用
|
||
「工作區伺服器」作為集中儲存工作區中繼資料
|
||
的方式。現在這些方法已因效能因素而棄用。
|
||
|
||
== CMD_DESCRIPTION_PARTIAL ==
|
||
在局部工作區中執行命令。
|
||
|
||
== CMD_USAGE_PARTIAL ==
|
||
用法：
|
||
|
||
cm ^partial <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^configure
|
||
^add
|
||
^undo
|
||
^co | ^checkout
|
||
^unco | ^undocheckout
|
||
^ci | ^checkin
|
||
^mv | ^move
|
||
^rm | ^remove
|
||
^stb | ^switch
|
||
^upd | ^update
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^partial <命令> --^usage
|
||
cm ^partial <命令> --^help
|
||
|
||
== CMD_HELP_PARTIAL ==
|
||
範例：
|
||
|
||
cm ^partial ^configure +/background-blue.png
|
||
cm ^partial ^update landscape-1024.png
|
||
cm ^partial ^checkin eyes-green.png eyes-black.png
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_ADD ==
|
||
將項目新增至版本控制。
|
||
|
||
== CMD_USAGE_PARTIAL_ADD ==
|
||
用法：
|
||
|
||
cm ^partial ^add [-^R | -^r | --^recursive] [--^silent] [--^parents]
|
||
[--^ignorefailed] [--^skipcontentcheck] <項目_路徑>[ ...]
|
||
|
||
項目_路徑 要新增的項目。使用雙引號 (" ") 指定含空格的
|
||
路徑。使用空格分隔路徑。
|
||
使用 * 以新增目前目錄的所有內容。
|
||
|
||
選項：
|
||
|
||
-^R 遞迴新增項目。
|
||
--^silent 不顯示任何輸出。
|
||
--^parents 包括作業中所指定項目的
|
||
上層目錄。
|
||
--^ignorefailed 如果無法新增項目，新增作業將會在沒有項目的情況下，
|
||
繼續進行新增作業。請注意：如果無法新增目錄
|
||
，則不會新增其內容。
|
||
--^skipcontentcheck 當擴充功能不足以將檔案設為文字
|
||
或二進位時，將預設為二進位，而不是
|
||
檢查內容來偵測類型。
|
||
|
||
== CMD_HELP_PARTIAL_ADD ==
|
||
備註：
|
||
|
||
新增項目的要求：
|
||
- 要新增之項目的上層目錄必須是先前已新增的目錄。
|
||
|
||
範例：
|
||
|
||
cm ^partial ^add pic1.png pic2.png
|
||
(新增項目 'pic1.png' 和 'pic2.png'。)
|
||
|
||
cm ^partial ^add c:\workspace\picture.png
|
||
(在路徑 'c:\workspace' 中新增項目 'picture.png'。)
|
||
|
||
cm ^partial ^add -^R c:\workspace\src
|
||
(遞迴新增 'src'。)
|
||
|
||
cm ^partial ^add --^parents samples\design01.png
|
||
(新增 'design01.png' 檔案和 'samples' 上層資料夾。)
|
||
|
||
cm ^partial ^add -^R *
|
||
(遞迴新增目前目錄的所有內容。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CHECKIN ==
|
||
在此儲存庫中儲存變更。
|
||
|
||
== CMD_USAGE_PARTIAL_CHECKIN ==
|
||
用法：
|
||
|
||
cm ^partial ^checkin | ^ci [<項目_路徑>[ ...]]
|
||
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
|
||
[--^all | -^a] [--^applychanged] [--^keeplock]
|
||
[--^symlink] [--^ignorefailed]
|
||
|
||
選項：
|
||
|
||
項目_路徑 要簽入的項目。使用雙引號 (" ") 指定
|
||
含空格的路徑。使用空格分隔
|
||
路徑。
|
||
使用 . 將簽入套用至目前目錄。
|
||
-^c 指定簽入作業中所建立變更集
|
||
的註解。
|
||
-^commentsfile 將指定檔案的註解套用至
|
||
簽入作業中建立的變更集。
|
||
--^all | -^a 在指定路徑上，從本地進行變更、移動和刪除
|
||
的項目也包括在內。
|
||
--^applychanged 將簽入作業套用至工作區中偵測到
|
||
的變更項目，以及簽出
|
||
項目。
|
||
--^keeplock 在簽入作業後繼續保留鎖定已鎖定的
|
||
項目。
|
||
--^symlink 將簽入作業套用至符號連結，而不是
|
||
套用至目標。
|
||
--^ignorefailed 任何無法套用的變更 (因無法擷取鎖定
|
||
- 又名為獨佔簽出，或因本地變更
|
||
與伺服器變更存在衝突) 已遭捨棄，
|
||
因此簽入作業會繼續執行，
|
||
但不包含這些變更。
|
||
|
||
== CMD_HELP_PARTIAL_CHECKIN ==
|
||
備註：
|
||
|
||
- 如果未指定 <項目_路徑>，簽入將涉及工作區中
|
||
所有暫止的變更。
|
||
- 此簽入作業一律從指定路徑遞迴套用。
|
||
- 若要簽入項目：
|
||
- 項目必須受原始程式碼控制。
|
||
- 必須簽出項目。
|
||
- 如果項目已變更，但未簽出，則不一定要有 '--^applychanged' 標誌
|
||
，除非 <項目_路徑> 是目錄，或包含
|
||
萬用字元 ('*')。
|
||
|
||
修訂內容應該與先前修訂不同，才能
|
||
簽入。
|
||
|
||
設定 PLASTICEDITOR 環境變數，以指定要輸入
|
||
註解的編輯器。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
命令 '^partial ^checkin' 可從 stdin 讀取路徑。若要執行此操作，可
|
||
傳遞單一破折號「-」來完成。
|
||
範例：cm ^partial ^checkin -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線以指定要簽入的檔案。
|
||
範例：
|
||
dir /S /B *.c | cm ^partial ^checkin --^all -
|
||
(在 Windows 中，簽入工作區中所有 .c 檔案。)
|
||
|
||
範例：
|
||
|
||
cm ^partial ^checkin figure.png landscape.png
|
||
(套用簽入到 'figure.png' 和 'landscape.png' 已簽出檔案。)
|
||
|
||
cm ^partial ^checkin .-^commentsfile=mycomment.txt
|
||
(套用簽入到目前的目錄，並從 'mycomment.txt' 檔案設定
|
||
註解。)
|
||
|
||
cm ^partial ^ci background.png -^c="我的註解" --^keeplock
|
||
(套用簽入到 'background.png'，包括註解，並保留
|
||
鎖定狀態。)
|
||
|
||
cm ^partial ^checkin --^applychanged
|
||
(套用簽入到工作區中的所有暫止變更。)
|
||
|
||
cm ^partial ^checkin 連結 --^symlink
|
||
(套用簽入到連結檔案，而非目標；適用於
|
||
UNIX 環境。)
|
||
|
||
cm ^partial ^checkin .--^ignorefailed
|
||
(套用簽入到目前的目錄，因此忽略無法套用的
|
||
變更。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
|
||
將檔案標示為準備好修改。
|
||
|
||
== CMD_USAGE_PARTIAL_CHECKOUT ==
|
||
用法：
|
||
|
||
cm ^partial ^checkout | ^co [<項目_路徑>[ ...]] [--^resultformat=<字串_格式>]
|
||
[--^silent] [--^ignorefailed]
|
||
|
||
選項：
|
||
|
||
項目_路徑 要簽出的項目。使用雙引號 (" ") 指定
|
||
含空格的路徑。使用空格分隔
|
||
路徑。
|
||
使用 . 將簽出套用至目前目錄。
|
||
--^resultformat 以指定的格式擷取輸出
|
||
結果訊息。
|
||
--^silent 不顯示任何輸出。
|
||
--^ignorefailed 如果無法鎖定項目 (無法執行獨佔簽出)，
|
||
則會在沒有項目的情況下，
|
||
繼續進行簽出作業。
|
||
|
||
== CMD_HELP_PARTIAL_CHECKOUT ==
|
||
備註：
|
||
|
||
若要簽出項目：
|
||
- 項目必須受原始程式碼控制。
|
||
- 必須簽入項目。
|
||
|
||
如果在伺服器上已設定鎖定 (lock.conf 存在)，那麼每次在路徑上
|
||
發生簽出時，Unity VCS 會檢查其是否符合任何規則，如果符合，
|
||
該路徑會處於獨佔簽出 (已鎖定)，如此一來，就沒有人
|
||
可以同時簽出。
|
||
您可以使用 'cm ^lock ^list' 以取得伺服器中的所有鎖定。
|
||
查看《管理指南》以瞭解鎖定的運作方式：
|
||
https://www.plasticscm.com/download/help/locking
|
||
|
||
範例：
|
||
|
||
cm ^partial ^checkout pic1.png pic2.png
|
||
(簽出檔案 'pic1.png' 和 'pic2.png'。)
|
||
|
||
cm ^partial ^co *.png
|
||
(簽出所有 png 檔案。)
|
||
|
||
cm ^partial ^checkout .
|
||
(簽出目前目錄。)
|
||
|
||
cm ^partial ^checkout -^R c:\workspace\src
|
||
(遞迴簽出 'src' 資料夾。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
|
||
允許透過將項目載入工作區或從其中取消載入，進行工作區設定。
|
||
|
||
== CMD_USAGE_PARTIAL_CONFIGURE ==
|
||
用法：
|
||
|
||
cm ^partial ^configure <+|-路徑>[ ...][--^silent] [--^ignorefailed]
|
||
[--^ignorecase] [--^restorefulldirs]
|
||
|
||
路徑 要載入或取消載入的路徑。使用雙引號 (" ")
|
||
指定含空格的路徑。使用空格分隔
|
||
路徑。
|
||
路徑開頭必須為 "/"。
|
||
|
||
選項：
|
||
|
||
--^silent 不顯示任何輸出。
|
||
--^ignorefailed 略過過程中的所有錯誤。不正確的路徑
|
||
不會造成命令停止執行。
|
||
--^ignorecase 忽略路徑的大小寫區分。搭配這個標誌時，'^configure'
|
||
將適用於 "/Data/Textures"，即使使用者是寫入
|
||
"/data/teXtures"。
|
||
--^restorefulldirs 重設無效的目錄設定 (發生在
|
||
非局部作業執行於局部工作區中時)。
|
||
在這個清單中的目錄將會完全設定
|
||
(完整檢查)，這表示進行更新時，這些目錄都將
|
||
自動下載全新內容。
|
||
這個作業不會下載任何檔案，而是僅
|
||
還原在局部工作區上的
|
||
目錄設定。
|
||
|
||
== CMD_HELP_PARTIAL_CONFIGURE ==
|
||
備註：
|
||
|
||
此命令應該會執行遞迴作業。
|
||
|
||
範例：
|
||
|
||
cm ^partial ^configure +/landscape_grey.png
|
||
(載入項目 'landscape_grey.png'。)
|
||
|
||
cm ^partial ^configure -/landscape_black.png
|
||
(取消載入項目 'landscape_black.png'。)
|
||
|
||
cm ^partial ^configure +/soft -/soft/soft-black.png
|
||
(載入所有 'soft' 目錄下層項目，但 'soft-black.png' 除外。)
|
||
|
||
cm ^partial ^configure -/
|
||
(取消載入整個工作區。)
|
||
|
||
cm ^partial ^configure -/ +/
|
||
(載入整個工作區。)
|
||
|
||
cm ^partial ^configure -/figure-64.png --^ignorefailed
|
||
(取消載入 'figure-64.png' 項目，即使其已經取消載入。)
|
||
|
||
cm ^partial ^configure +/ --^restorefulldirs
|
||
(將所有目錄設成自動下載新內容。)
|
||
|
||
cm ^partial ^configure +/src/lib --^restorefulldirs
|
||
(僅將 '/src/lib' 及其子目錄設成自動下載
|
||
新內容。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_MOVE ==
|
||
移動或重新命名檔案或目錄。
|
||
|
||
== CMD_USAGE_PARTIAL_MOVE ==
|
||
用法：
|
||
|
||
cm ^partial ^move | ^mv <來源_路徑> <目的地_路徑> [--^format=<字串_格式>]
|
||
|
||
來源_路徑 來源項目路徑。
|
||
目的地_路徑 目的地項目路徑。
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
|
||
== CMD_HELP_PARTIAL_MOVE ==
|
||
備註：
|
||
|
||
這個命令會移動或重新命名儲存庫中的項目。
|
||
變更也是在本機檔案系統中完成。
|
||
|
||
如果來源路徑是檔案，則目的地路徑可能為檔案或
|
||
目錄。在第一個情況中，將會重新命名檔案；否則，將
|
||
移動項目。
|
||
如果來源路徑是個目錄，目的地路徑必須是目錄。
|
||
|
||
要移動或重新命名的項目必須存在。
|
||
|
||
格式：
|
||
{0} 來源路徑。
|
||
{1} 目的地路徑。
|
||
|
||
範例：
|
||
|
||
cm ^partial ^move file.png file-blue.png
|
||
(重新命名項目。)
|
||
|
||
cm ^partial ^mv .\file-blue.png .\blueFiles
|
||
(將 'file-blue.png' 移到 'blueFiles'。)
|
||
|
||
cm ^partial ^move .\design .\marketing
|
||
(重新命名目錄。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_REMOVE ==
|
||
從版本控制刪除檔案或目錄。
|
||
|
||
== CMD_USAGE_PARTIAL_REMOVE ==
|
||
用法：
|
||
|
||
cm ^partial ^remove | ^rm <項目_路徑>[ ...][--^nodisk]
|
||
|
||
項目_路徑 要移除的項目路徑。使用雙引號 (" ")
|
||
指定含空格的路徑。使用空格分隔
|
||
路徑。
|
||
|
||
選項：
|
||
|
||
--^nodisk 從版本控制移除，但將項目保留在磁碟上。
|
||
|
||
== CMD_HELP_PARTIAL_REMOVE ==
|
||
備註：
|
||
|
||
會從磁碟刪除項目。會從原始程式碼控制的上層目錄中
|
||
移除已移除的項目。
|
||
|
||
要求：
|
||
- 項目必須受原始程式碼控制。
|
||
|
||
範例：
|
||
|
||
cm ^partial ^remove src
|
||
(移除 'src'。如果 'src' 是目錄，結果將與下面命令相同：
|
||
cm ^partial ^remove -^R src。)
|
||
|
||
cm ^partial ^remove c:\workspace\pic01.png --^nodisk
|
||
(將 'pic01.png' 從版本控制中移除，但保留於磁碟中。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_SWITCH ==
|
||
將分支設定為工作分支。
|
||
|
||
== CMD_USAGE_PARTIAL_SWITCH ==
|
||
用法：
|
||
|
||
cm ^switch <分支_規格> [--^report | --^silent] [--^workspace=<路徑>]
|
||
(設定工作分支，並更新工作區。)
|
||
|
||
cm ^switch <分支_規格> --^configure <+|-路徑>[ ...][--^silent]
|
||
[--^ignorefailed] [--^ignorecase] [--^workspace=<路徑>]
|
||
(設定工作分支，並使工作區設定的執行如同 'cm
|
||
^partial ^configure' 命令。)
|
||
|
||
分支_規格 分支規格。(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
分支規格。)
|
||
路徑 要載入或取消載入的路徑。使用雙引號 (" ")
|
||
指定含空格的路徑。使用空格
|
||
分隔路徑。路徑開頭必須為 "/"。
|
||
|
||
選項：
|
||
|
||
--^silent 不顯示任何輸出。
|
||
--^report 在命令完成時列印已套用變更
|
||
的清單。使用 '--^silent' 時將會覆寫這個設定。
|
||
這個選項僅適用於未指定 '--^configure' 選項
|
||
的情況。
|
||
--^configure 在工作區分支更新後
|
||
設定 (載入 / 取消載入項目) 工作區。查看 'cm ^partial
|
||
^configure --^help' 以瞭解如何指定這些要設定的
|
||
路徑。
|
||
--^ignorefailed 略過設定過程中所出現的所有錯誤。
|
||
不正確的路徑不會造成命令停止執行。
|
||
--^ignorecase 忽略路徑的大小寫區分。搭配這個標誌時，選項
|
||
'--^configure' 將適用於 "/Data/Textures"，即使使用者
|
||
寫入的是 "/data/teXtures"。
|
||
--^workspace=路徑 工作區所在位置的路徑。
|
||
|
||
== CMD_HELP_PARTIAL_SWITCH ==
|
||
備註：
|
||
|
||
此命令可讓使用者更新工作分支。在更新
|
||
分支之後，此命令會將工作區更新成新分支，如同
|
||
'cm ^partial ^update' 命令所執行方式。不過，如果已指定 '--^configure' 選項，
|
||
此命令就可讓您使用新分支設定來
|
||
設定工作區，如同 'cm ^partial ^configure' 命令所執行方式。
|
||
|
||
範例：
|
||
|
||
cm ^switch ^br:/main/task
|
||
(將 /main/task 設為工作分支，並更新工作區。)
|
||
|
||
cm ^switch ^br:/main/task --^configure +/art/images
|
||
(將 /main/task 設為工作分支，並設定工作區可
|
||
載入 /art/images 資料夾。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UNDOCHECKOUT ==
|
||
復原項目的簽出。
|
||
|
||
== CMD_USAGE_PARTIAL_UNDOCHECKOUT ==
|
||
用法：
|
||
|
||
cm ^partial ^undocheckout | ^unco <項目_路徑>[ ...][--^silent]
|
||
|
||
項目_路徑 要套用作業的項目。使用雙引號 (" ")
|
||
指定含空格的路徑。使用空格
|
||
分隔路徑。
|
||
使用 . 將作業套用至目前目錄。
|
||
|
||
選項：
|
||
|
||
--^silent 不顯示任何輸出。
|
||
|
||
== CMD_HELP_PARTIAL_UNDOCHECKOUT ==
|
||
備註：
|
||
|
||
如果項目已簽出，而且您不想將其簽入，您可以使用此命令復原
|
||
簽出。檔案和資料夾皆可取消
|
||
簽出。項目將更新為簽出前的狀態。
|
||
|
||
要求：
|
||
- 項目必須受原始程式碼控制。
|
||
- 必須簽出項目。
|
||
|
||
範例：
|
||
|
||
cm ^partial ^undocheckout .
|
||
(復原目前目錄中的簽出。)
|
||
|
||
cm ^partial ^undocheckout pic1.png pic2.png
|
||
cm ^unco c:\workspace\design01.png
|
||
(復原所選檔案的簽出。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UNDO ==
|
||
復原工作區中的變更。
|
||
|
||
== CMD_USAGE_PARTIAL_UNDO ==
|
||
用法：
|
||
|
||
cm ^partial ^undo [<路徑>[ ...]] [--^symlink] [-^r | --^recursive]
|
||
[<篩選>[ ...]]
|
||
[--^silent | --^machinereadable [--^startlineseparator=<分隔符號>]
|
||
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
|
||
|
||
路徑 要套用作業之檔案或目錄的
|
||
路徑。使用雙引號 (" ") 指定
|
||
含空格的路徑。使用空格
|
||
分隔路徑。
|
||
如果未指定路徑，復原作業預設會
|
||
使用目前目錄中的
|
||
所有檔案。
|
||
篩選 將指定的一或多個篩選套用至指定的
|
||
路徑。使用空格分隔篩選。如需詳細資訊，請參閱
|
||
＜篩選＞一節。
|
||
|
||
選項：
|
||
|
||
--^symlink 將復原作業套用至符號連結，而不是
|
||
套用至目標。
|
||
-^r 以遞迴方式執行復原。
|
||
--^silent 不顯示任何輸出。
|
||
--^machinereadable 以易於剖析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何起始。
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何結束。
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
應如何分隔欄位。
|
||
|
||
篩選：
|
||
|
||
如果未指定標誌，會依預設復原所有變更，但
|
||
可使用下列一或多個標誌篩選路徑。
|
||
如果檔案或目錄符合一或多個指定的變更類型，
|
||
將會復原所述之檔案或目錄上的所有變更。
|
||
例如，如果您指定 '--^checkedout' 和 '--^moved'，若檔案
|
||
已簽出且移動，則會復原這兩項變更。
|
||
|
||
--^checkedout 選取已簽出的檔案和目錄。
|
||
--^unchanged 選取未變更內容的檔案。
|
||
--^changed 選取已在本地變更或簽出的檔案和
|
||
目錄。
|
||
--^deleted 選取已刪除的檔案和目錄。
|
||
--^moved 選取已移動的檔案和目錄。
|
||
--^added 選取已新增的檔案和目錄。
|
||
|
||
== CMD_HELP_PARTIAL_UNDO ==
|
||
備註：
|
||
|
||
^undo 命令具有危險性 - 它會以無法回復的方式復原工作。
|
||
^undo 作業完成後，則無法復原受其影響的檔案和
|
||
目錄的先前狀態。如果未在引數中
|
||
指定路徑，預設將復原目前目錄中的所有變更，
|
||
但不是以遞迴方式進行。
|
||
這些等同於從 /src 目錄執行：
|
||
|
||
/src
|
||
|- file.txt
|
||
|- code.cs
|
||
\- /test
|
||
|- test_a.py
|
||
\- test_b.py
|
||
|
||
cm ^partial ^undo
|
||
cm ^partial ^undo *
|
||
cm ^partial ^undo file.txt code.cs /test
|
||
|
||
cm ^partial ^undo .
|
||
cm ^partial ^undo /src file.txt code.cs
|
||
|
||
若要以遞迴的方式進行作業，您必須指定 '-^r' 標誌。
|
||
|
||
復原目錄下的所有變更 (包括影響到
|
||
目錄本身的變更)：
|
||
|
||
cm ^partial ^undo dirpath -^r
|
||
|
||
如果目錄路徑是工作區路徑，將會復原工作區中的
|
||
所有變更。
|
||
|
||
範例：
|
||
|
||
cm ^partial ^undo .-^r
|
||
(以遞迴方式復原目前目錄中的所有變更。如果已從
|
||
工作區的根目錄執行，則會復原整個工作區中的所有變更。)
|
||
|
||
cm ^partial ^co file.txt
|
||
cm ^partial ^undo file.txt
|
||
(復原 file.txt 的簽出。)
|
||
|
||
^echo ^content >> file.txt
|
||
cm ^partial ^undo file.txt
|
||
(復原 file.txt 的本地變更。)
|
||
|
||
cm ^partial ^undo src
|
||
(復原 src 目錄及其中檔案的變更。)
|
||
|
||
cm ^partial ^undo src/*
|
||
(復原 src 中所包含各個檔案與目錄的變更，而
|
||
完全不影響 src。)
|
||
|
||
cm ^partial ^undo *.cs
|
||
(復原在目前目錄中，與 *.cs 相符的每個檔案或目錄的
|
||
變更。)
|
||
|
||
cm ^partial ^undo *.cs -^r
|
||
(復原在目前目錄與底下每個目錄中，
|
||
與 *.cs 相符的每個檔案或目錄。)
|
||
|
||
cm ^partial ^co file1.txt file2.txt
|
||
^echo ^content >> file1.txt
|
||
cm ^partial ^undo --^unchanged
|
||
(復原未變更 file2.txt 的簽出，因此忽略本地變更的
|
||
file1.txt。)
|
||
|
||
^echo ^content >> file1.txt
|
||
^echo ^content >> file2.txt
|
||
cm ^partial ^co file1.txt
|
||
cm ^partial ^undo --^checkedout
|
||
(復原已簽出檔案 file1.txt 中的變更，因此忽略 file2.txt，因為這個檔案
|
||
並未簽出。)
|
||
|
||
cm ^partial ^add file.txt
|
||
cm ^partial ^undo file.txt
|
||
(復原新增 file.txt 的動作，因而使其再次成為私人檔案。)
|
||
|
||
^rm file1.txt
|
||
^echo ^content >> file2.txt
|
||
cm ^partial ^add file3.txt
|
||
cm ^partial ^undo --^deleted --^added *
|
||
(復原 file1.txt 刪除動作和 file3.txt 新增動作，而忽略 file2.txt
|
||
變更。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UPDATE ==
|
||
更新局部的工作區，以及下載最新的變更。
|
||
|
||
== CMD_USAGE_PARTIAL_UPDATE ==
|
||
用法：
|
||
|
||
cm ^partial ^update [<項目_路徑>[ ...]] [--^changeset=<數目>]
|
||
[--^silent | --^report] [--^dontmerge]
|
||
|
||
項目_路徑 要更新的項目。使用雙引號 (" ") 指定
|
||
含空格的路徑。使用空格分隔
|
||
路徑。
|
||
使用 . 將更新套用至目前目錄。
|
||
如未指定任何路徑，則目前局部的工作區
|
||
會完整獲得更新。
|
||
|
||
選項：
|
||
|
||
--^changeset 更新局部工作區成特定變更集。
|
||
--^silent 不顯示任何輸出。
|
||
--^report 在命令完成時列印已套用變更
|
||
的清單。使用 '--^silent' 時將會覆寫這個設定。
|
||
--^dontmerge 不會合併檔案衝突，只是略過。
|
||
其他的變更隨即適當套用。這個選項
|
||
可用於自動化作業，免除使用者互動。
|
||
|
||
|
||
== CMD_HELP_PARTIAL_UPDATE ==
|
||
備註：
|
||
|
||
命令 '^partial ^update' 會更新過時的檔案。
|
||
|
||
此命令應該會執行遞迴作業。
|
||
|
||
使用 '--^changeset' 選項時，如果所有的指定路徑都是在同一 Xlink
|
||
下的檔案，則可在 Xlink 連結儲存庫中的指定變更集中，
|
||
搜尋要下載的版本。
|
||
|
||
範例：
|
||
|
||
cm ^partial ^update
|
||
(更新目前局部工作區的所有內容。)
|
||
|
||
cm ^partial ^update .
|
||
(更新所有目前目錄下層項目。)
|
||
|
||
cm ^partial ^update backgroud-blue.png
|
||
(更新項目 'backgroud-blue.png'。)
|
||
|
||
cm ^partial ^update soft_black.png soft-grey.png
|
||
(更新項目 'soft_black.png' 和 'soft-grey.png'。)
|
||
|
||
cm ^partial ^update src --^report
|
||
(更新所有 'src' 目錄下層項目，並於最後列印出
|
||
套用的變更清單。)
|
||
|
||
cm ^partial ^update src --^changeset=4
|
||
(將所有 'src' 目錄下層項目更新成其在變更集 4 中
|
||
所載入的內容。)
|
||
|
||
cm ^partial ^update xlink/first.png --^changeset=4
|
||
(將 'xlink/first.png' 項目更新成其在 Xlink 連結儲存庫變更集 4 中
|
||
所載入的內容。
|
||
|
||
== CMD_DESCRIPTION_PATCH ==
|
||
從規格中產生修補檔案，或將產生的修補檔案套用到目前
|
||
工作區。
|
||
|
||
== CMD_USAGE_PATCH ==
|
||
用法：
|
||
|
||
cm ^patch <來源_規格> [<來源_規格>] [--^output=<輸出_檔案>]
|
||
[--^tool=<差異比對_的_路徑>]
|
||
產生修補檔案，其中包含分支、變更集的差異，
|
||
或變更集之間的差異。這個檔案也會追蹤
|
||
文字檔和二進位檔案的差異。
|
||
|
||
cm ^patch --^apply <修補_檔案> [--^tool=<修補_的_路徑>]
|
||
允許在目前工作區中套用所產生修補檔案
|
||
的內容。
|
||
|
||
來源_規格 變更集或分支的完整規格。(使用
|
||
'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
輸出_檔案 要儲存修補內容的檔案。如果未指定任何檔案，
|
||
修補內容將會列印到標準輸出。
|
||
修補_檔案 要套用於目前工作區的修補檔案。
|
||
|
||
選項：
|
||
|
||
--^output 設定修補命令的輸出檔案。
|
||
--^tool 設定要使用的應用程式 (差異比對或修補)。
|
||
|
||
== CMD_HELP_PATCH ==
|
||
限制：
|
||
|
||
如果已有輸出修補檔案，該命令將不會覆寫此檔案。
|
||
|
||
套用修補時，如果修改的檔案不在磁碟上，
|
||
命令將不會在其中套用變更。
|
||
|
||
重要：
|
||
|
||
這個命令需要使用差異比對 (Diff) 和修補 (Patch) 工具，公開提供於
|
||
http://gnuwin32.sourceforge.net/packages/patch.htm 和
|
||
http://gnuwin32.sourceforge.net/packages/diffutils.htm
|
||
|
||
安裝完成之後，建議在 PATH 環境變數中
|
||
新增其路徑。
|
||
|
||
範例：
|
||
|
||
cm ^patch ^cs:4@default@localhost:8084
|
||
(在主控台上以統一格式列印出 cset 4 的差異。)
|
||
|
||
cm ^patch ^br:/main --^output=file.patch
|
||
(產生修補檔案及分支 "main" 的差異。)
|
||
|
||
cm ^patch ^br:/main --^output=file.patch --^tool=C:\gnu\diff.exe
|
||
(功能如前所述，但使用 custom exe。)
|
||
|
||
cm ^patch ^cs:2@default ^cs:4@default
|
||
(在主控台上以統一格式列印出 csets 2 和 4 之間的差異。)
|
||
|
||
cm ^patch --^apply file.patch --^tool=C:\gnu\patch.exe
|
||
(使用 custom exe，將 'file.patch' 中的修補套用到本地工作區。)
|
||
|
||
== CMD_DESCRIPTION_QUERY ==
|
||
執行 SQL 查詢。需要 SQL 儲存位置。
|
||
|
||
== CMD_USAGE_QUERY ==
|
||
用法：
|
||
|
||
cm ^query <sql_命令> [--^repository=<名稱>]
|
||
|
||
sql_命令 要執行的 sql 查詢。
|
||
|
||
選項：
|
||
|
||
--^repository 要查詢的儲存庫。
|
||
|
||
== CMD_HELP_QUERY ==
|
||
備註：
|
||
|
||
此命令可讓使用者在伺服器資料庫中執行 SQL 查詢。
|
||
|
||
為寫入 SQL 查詢，請使用下列兩個預先定義的函數來管理
|
||
使用者和路徑：
|
||
- '^SolveUser(<使用者名稱>)'：將使用者名稱解析為 Unity VCS 格式。
|
||
- '^SolvePath(<路徑>)'：將磁碟路徑解析為項目 ID。
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
|
||
刪除一或多個屬性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_DELETE ==
|
||
用法：
|
||
|
||
cm ^attribute | ^att ^delete | ^rm <屬性_規格>[ ...]
|
||
|
||
屬性_規格 要刪除的屬性。使用空格分隔
|
||
屬性。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解屬性
|
||
規格。)
|
||
|
||
== CMD_HELP_ATTRIBUTE_DELETE ==
|
||
備註：
|
||
|
||
此命令會移除一或多個屬性。
|
||
|
||
範例：
|
||
|
||
cm ^attribute ^delete ^att:狀態
|
||
(刪除 '狀態' 屬性。)
|
||
|
||
cm ^att ^rm 狀態 ^att:整合@reptest@server2:8084
|
||
(刪除 '狀態' 和 '整合' 屬性。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
|
||
取消設定物件的屬性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_UNSET ==
|
||
用法：
|
||
|
||
cm ^attribute | ^att ^unset <屬性_規格> <物件_規格>
|
||
|
||
屬性_規格 屬性規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解屬性規格。)
|
||
物件_規格 要移除屬性的物件
|
||
規格。可在下列項目上設定屬性：分支、變更集、
|
||
擱置集、標籤、項目和修訂。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
== CMD_HELP_ATTRIBUTE_UNSET ==
|
||
備註：
|
||
|
||
此命令會取消設定先前在物件上所設定的屬性。它
|
||
不會刪除屬性物件本身。
|
||
|
||
範例：
|
||
|
||
cm ^attribute ^unset ^att:狀態 ^br:/main/SCM105
|
||
(從 'main/SCM105' 分支移除 '狀態' 屬性實現。)
|
||
|
||
cm ^att ^unset ^att:整合@reptest@localhost:8084 ^cs:25@reptest@localhost:8084
|
||
(從變更集 25 移除 '整合' 屬性實現，全部都在
|
||
'reptest' 儲存庫中。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
|
||
重新命名屬性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_RENAME ==
|
||
用法：
|
||
|
||
cm ^attribute | ^att ^rename <屬性_規格> <新_名稱>
|
||
|
||
屬性_規格 要重新命名的屬性。(使用 'cm ^help ^objectspec' 以深入
|
||
瞭解屬性規格。)
|
||
新_名稱 屬性的新名稱。
|
||
|
||
== CMD_HELP_ATTRIBUTE_RENAME ==
|
||
備註：
|
||
|
||
此命令會重新命名屬性。
|
||
|
||
範例：
|
||
|
||
cm ^attribute ^rename ^att:狀態 狀況
|
||
(將 '狀態' 屬性重新命名為 '狀況'。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
|
||
編輯屬性的註解。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_EDIT ==
|
||
用法：
|
||
|
||
cm ^attribute | ^att ^edit <屬性_規格> <新_註解>
|
||
|
||
屬性_規格 要變更其註解的屬性。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解屬性規格。)
|
||
新_註解 屬性的新註解。您也可以為屬性指定
|
||
預設的值清單。
|
||
|
||
== CMD_HELP_ATTRIBUTE_EDIT ==
|
||
備註：
|
||
|
||
此命令會變更屬性的註解。
|
||
|
||
若要為屬性指定預設的值清單，您只需要在屬性註解中
|
||
加入類似以下的一行：
|
||
'預設: 第一個值, "第二個值", 第 3 個值, "最後一個值"'。
|
||
|
||
範例：
|
||
|
||
cm ^attribute ^edit ^att:狀態 "CI 管線中的分支狀態。"
|
||
(編輯 '狀態' 屬性的註解。)
|
||
|
||
cm ^attribute ^edit ^att:狀態 "分支狀態。預設：未解決、已解決、已檢閱"
|
||
(編輯 '狀態' 屬性的註解。也會指定值的
|
||
清單。因此，當您將 '狀態' 屬性設定為物件時，您可以選取
|
||
下列其中一個值："未解決"、"已解決" 或 "已檢閱"。)
|
||
|
||
== CMD_DESCRIPTION_REPLICATE ==
|
||
警告：此命令已棄用。
|
||
|
||
請使用 'cm ^pull' (等同於 '^replicate') 和 'cm ^push' (等同於
|
||
'^replicate --^push')。
|
||
|
||
== CMD_USAGE_REPLICATE ==
|
||
|
||
== CMD_HELP_REPLICATE ==
|
||
|
||
== CMD_DESCRIPTION_PULL ==
|
||
從另一個儲存庫提取分支。
|
||
|
||
== CMD_USAGE_PULL ==
|
||
用法：
|
||
|
||
cm ^pull <來源_分支_規格> <目的地_儲存庫_規格>
|
||
[--^preview] [--^nodata] [轉譯選項]
|
||
[--^user=<使用者_名稱> [--^password=<密碼>] | 授權選項]
|
||
(直接 server-to-server 複寫。從儲存庫提取分支。)
|
||
|
||
cm ^pull <目的地_儲存庫_規格> --^package=<套件_檔案> [授權選項]
|
||
(套件型複寫。在目的地儲存庫中匯入套件。)
|
||
|
||
cm ^pull ^hydrate <目的地_分支_規格> [<來源_儲存庫_規格>]
|
||
[--^user=<使用者_名稱> [--^password=<密碼>] | 授權選項]
|
||
(引入先前
|
||
使用 '--^nodata' 複寫之分支的所有變更集的遺失資料。如果沒有指定要取得資料的儲存庫，
|
||
Unity VCS 會嘗試使用「複寫來源」(已複寫
|
||
分支的來源))。
|
||
|
||
cm ^pull ^hydrate <目的地_變更集_規格> [<來源_儲存庫_規格>]
|
||
[--^user=<使用者_名稱> [--^password=<密碼>] | 授權選項]
|
||
(引入先前使用
|
||
'--^nodata' 複寫之變更集的遺失資料。如果沒有指定要取得資料的儲存庫，Unity VCS 會嘗試
|
||
使用「複寫來源」)。
|
||
|
||
來源_分支_規格 要從遠端儲存庫提取的分支。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支規格。)
|
||
目的地_分支_規格 要合成的分支。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支規格。)
|
||
目的地_變更集_規格 要合成的變更集。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
|
||
規格。)
|
||
目的地_儲存庫_規格 目的地儲存庫。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
規格。)
|
||
--^package 指定要針對套件型複寫匯入的先前建立
|
||
的套件檔案。
|
||
在沒有直接網路連線的情況下，可用在
|
||
伺服器之間移動資料。
|
||
請參照 'cm ^push' 以建立套件檔案。
|
||
|
||
選項：
|
||
|
||
--^preview 提供有關將提取哪些變更的資訊，但實際上
|
||
不會執行任何變更。此選項很適合用於
|
||
在複寫變更前檢查將傳輸
|
||
的資料。
|
||
--^nodata 複寫分支變更，而不複寫
|
||
資料。此選項不可與套件
|
||
複寫搭配使用。
|
||
轉譯選項 如需詳細資訊，請參閱＜轉譯選項＞一節。
|
||
--^user, --^password 如果來源和目的地的驗證模式
|
||
不同且沒有可對目的地進行驗證的設定檔時，
|
||
所要使用的認證。
|
||
驗證選項 如需詳細資訊，請參閱
|
||
＜驗證選項＞一節。
|
||
|
||
轉譯選項：
|
||
|
||
--^trmode=(^copy|^name|^table --^trtable=<轉譯_表格_檔案>)
|
||
來源和目的地儲存庫可能會使用不同的驗證
|
||
模式。'--^trmode' 選項可指定如何將使用者名稱從
|
||
來源轉譯至目的地。'--^trmode' 必須是下列其中
|
||
一個值：
|
||
^copy (預設)。表示只會複製使用者識別碼。
|
||
^name 表示將按名稱比對使用者識別碼。
|
||
^table 使用 '--^trtable' 選項中指定的轉譯表格
|
||
(請參閱下方)。
|
||
|
||
--^trtable=<轉譯_表格_檔案>
|
||
如果轉譯模式為 '表格'，轉譯表格則為包含
|
||
<舊名稱;新名稱> (每行一個) 格式的文字行檔案。當
|
||
分支寫入至目的地儲存庫時，來源儲存庫中 '舊名稱'
|
||
所識別之使用者所建立的物件將設定至目的地上
|
||
具有 '新名稱' 的使用者。
|
||
|
||
驗證選項：
|
||
|
||
您可使用下列兩種模式之一指定驗證資料：
|
||
|
||
1) 使用驗證參數：--^authmode=<模式> --^authdata=<資料>
|
||
|
||
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
|
||
範例：
|
||
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
'--^authdata' 這一行是 client.conf 檔案和 profiles.conf 檔案中 <^SecurityConfig> 項目
|
||
的內容。您可從 Unity VCS GUI 的 [喜好設定] 下的複寫
|
||
設定檔索引標籤，輕鬆產生 profiles.conf
|
||
檔案。
|
||
|
||
如果您使用的是 ^UPWorkingMode，可以直接指定：
|
||
|
||
--^authmode=^UPWorkingMode --^user=<使用者> --^password=<密碼>
|
||
|
||
2) 驗證檔案，其中針對各個連線的目標伺服器您可能
|
||
有不同的檔案，包括該伺服器的認證。
|
||
|
||
--^authfile=<驗證_檔案>
|
||
此檔案包含 2 行：
|
||
行 1) 是模式 (如 '--^authmode' 所述)
|
||
行 2) 是驗證資料 (如 '--^authdata' 所述)
|
||
|
||
== CMD_HELP_PULL ==
|
||
備註：
|
||
|
||
'^pull' 命令能夠在來源儲存庫與目的地儲存庫之間
|
||
複寫分支 (及其變更集)。
|
||
儲存庫可位於不同的伺服器。
|
||
|
||
複寫作業分成兩種：'^push' 和 '^pull'。
|
||
|
||
'^pull' 作業是指複寫作業會要求將
|
||
來自來源儲存庫的資料儲存至目的地儲存庫。
|
||
用戶端將連線至目的地儲存庫，並且將從該主機
|
||
建立與來源儲存庫的連線，以擷取
|
||
鎖定目標的資料。提取期間，它是將
|
||
連線至來源的目的地伺服器。
|
||
|
||
雖然在一般分散式案例中，開發人員會將資料從其本機伺服器
|
||
推送至主要伺服器，但開發人員可能也會想要從主要伺服器
|
||
提取最新儲存庫更新。
|
||
|
||
若對兩個複寫的儲存庫上的相同分支
|
||
同時進行了變更，複寫可以解決此類情況：
|
||
|
||
- 推送：如果您嘗試將資料推送至儲存庫，而當中的變更比您傳送的
|
||
變更要新，系統將要求您提取最新變更、解決合併作業，
|
||
最後再次嘗試推送。
|
||
|
||
- 提取：每當您從遠端分支提取變更集時，它們會直接連結至
|
||
其上層變更集。如果您提取的變更集
|
||
不是分支中最後一個變更集的下層項目，則會出現多標頭
|
||
案例。分支將有多個「標頭」，或在分支上有
|
||
最後一個變更集。您必須先合併兩個「標頭」，
|
||
才能再次推送。
|
||
|
||
提取可在兩種模式下運作：
|
||
|
||
1) 伺服器之間的直接通訊：目的地伺服器將從來源
|
||
伺服器擷取資料，自動為指定的分支
|
||
同步資料。
|
||
|
||
2) 使用推送和 '--^package' 選項匯入先前產生的套件。
|
||
|
||
模式 1) 會要求使用者執行命令以接受遠端伺服器的驗證，
|
||
無論是使用client.conf 檔案中的預設驗證、
|
||
指定 '--^authmode' 和 '--^authdata' 修飾詞或是
|
||
'--^authmode' 和 '--^user' 和 '--^password' (如果驗證模式為
|
||
^UPWorkingMode。)
|
||
|
||
模式 2) 會要求使用先前使用推送
|
||
命令產生的套件檔案。
|
||
|
||
請注意，提取複寫會以間接的方式運作。執行時，
|
||
命令會要求目的地儲存庫連線至來源並
|
||
取得所選分支。
|
||
|
||
不過，這可直接使用推送命令完成。
|
||
這會讓命令將所選分支從來源複寫至
|
||
目的地。
|
||
|
||
範例：
|
||
|
||
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084
|
||
(將 'main' 分支從 'remoteserver' 提取至 'myserver'。在本例中，
|
||
會使用相同的驗證模式設定這兩個伺服器。)
|
||
|
||
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 \
|
||
--^authmode=^LDAPWorkingMode --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(與之前一樣，提取相同的分支，但現在遠端伺服器已設定為
|
||
透過 Active Directory 驗證使用者。例如，我正從 Linux 電腦
|
||
連線至設定為使用 Active Directory 整合模式的
|
||
Windows 伺服器。我會指定我的 Active Directory 使用者和加密的
|
||
密碼，並以 LDAP 形式將它傳遞至伺服器。)
|
||
|
||
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 \
|
||
--^authmode=^UPWorkingMode --^user=dave --^password=mysecret
|
||
(提取相同的分支，但現在使用者是在遠端伺服器上進行驗證，
|
||
善加利用
|
||
Unity VCS 所包含的使用者/密碼資料庫。)
|
||
|
||
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 --^nodata
|
||
(將 'main' 分支從 'remoteserver' 複寫至 'myserver'，但不包含資料。)
|
||
|
||
cm ^pull ^hydrate ^br:/main@projectx@myserver:8084 projectx@remoteserver:8084
|
||
(透過從遠端伺服器取得資料，
|
||
合成 'main' 分支中的所有變更集。)
|
||
|
||
cm ^pull ^hydrate ^cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
|
||
(透過從遠端伺服器取得資料，
|
||
，合成 'myserver' 中的變更集 122169。)
|
||
|
||
== CMD_DESCRIPTION_PUSH ==
|
||
將分支推送至另一個儲存庫。
|
||
|
||
== CMD_USAGE_PUSH ==
|
||
用法：
|
||
|
||
cm ^push <來源_分支_規格> <目的地_儲存庫_規格>
|
||
[--^preview] [轉譯選項]
|
||
[--^user=<使用者_名稱> [--^password=<密碼>] | 授權選項]
|
||
(直接 server-to-server 複寫。從儲存庫推送分支。)
|
||
|
||
cm ^push <來源_分支_規格> --^package=<套件_檔案> [授權選項]
|
||
(套件型複寫。在包含所選分支的來源伺服器中
|
||
建立複寫套件。)
|
||
|
||
來源_分支_規格 要推送至遠端儲存庫的分支。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支規格。)
|
||
目的地_儲存庫_規格 目的地儲存庫。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
規格。)
|
||
--^package 指定要針對套件型複寫匯出
|
||
複寫套件的路徑。
|
||
在沒有直接網路連線的情況下，
|
||
可用在伺服器之間移動資料。
|
||
|
||
選項：
|
||
|
||
--^preview 提供有關將推送哪些變更的資訊，
|
||
但實際上不會執行任何變更。此選項
|
||
很適合用來在複寫變更前
|
||
檢查將傳輸的資料。
|
||
轉譯選項 如需詳細資訊，請參閱＜轉譯選項＞一節。
|
||
--^user, --^password 如果來源和目的地的驗證模式
|
||
不同且沒有可對目的地進行驗證的設定檔時，
|
||
所要使用的認證。
|
||
驗證選項 如需詳細資訊，請參閱
|
||
＜驗證選項＞一節。
|
||
|
||
轉譯選項：
|
||
|
||
--^trmode=(^copy|^name|^table --^trtable=<轉譯_表格_檔案>)
|
||
來源和目的地儲存庫可能會使用不同的驗證
|
||
模式。'--^trmode' 選項可指定如何將使用者名稱
|
||
從來源轉譯至目的地。'--^trmode' 必須是下列
|
||
其中一個值：
|
||
^copy (預設)。表示只會複製使用者識別碼。
|
||
^name 表示將按名稱比對使用者識別碼。
|
||
^table 使用 '--^trtable' 選項中指定的轉譯表格
|
||
(請參閱下方)。
|
||
|
||
--^trtable=<轉譯_表格_檔案>
|
||
如果轉譯模式為 '表格'，轉譯表格則為包含
|
||
<舊名稱;新名稱> (每行一個) 格式的文字行檔案。當
|
||
分支寫入至目的地儲存庫時，來源儲存庫中 '舊名稱'
|
||
所識別之使用者所建立的物件將設定至目的地上
|
||
具有 '新名稱' 的使用者。
|
||
|
||
驗證選項：
|
||
|
||
您可使用下列兩種模式之一指定驗證資料：
|
||
|
||
1) 使用驗證參數：--^authmode=<模式> --^authdata=<資料>
|
||
|
||
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
|
||
範例：
|
||
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
'--^authdata' 這一行是 client.conf 檔案和 profiles.conf 檔案中 <^SecurityConfig> 項目
|
||
的內容。您可從 Unity VCS GUI 的 [喜好設定] 下的複寫
|
||
設定檔索引標籤，輕鬆產生 profiles.conf
|
||
檔案。
|
||
|
||
如果您使用的是 ^UPWorkingMode，可以直接指定：
|
||
|
||
--^authmode=^UPWorkingMode --^user=<使用者> --^password=<密碼>
|
||
|
||
2) 驗證檔案，其中針對各個連線的目標伺服器您可能
|
||
有不同的檔案，包括該伺服器的認證。
|
||
|
||
--^authfile=<驗證_檔案>
|
||
此檔案包含 2 行：
|
||
行 1) 是模式 (如 '--^authmode' 所述)
|
||
行 2) 是驗證資料 (如 '--^authdata' 所述)
|
||
|
||
== CMD_HELP_PUSH ==
|
||
備註：
|
||
|
||
'^push' 命令能夠在來源儲存庫與目的地儲存庫之間
|
||
複寫分支 (及其變更集)。
|
||
儲存庫可位於不同的伺服器。
|
||
|
||
複寫作業分成兩種：'^push' 和 '^pull'。
|
||
|
||
'^push' 作業是指複寫作業會將資料
|
||
從來源儲存庫傳送至目的地儲存庫。在此案例中，
|
||
用戶端將連線至來源儲存庫，取得要複寫的資料，
|
||
然後將該資料傳送至目的地儲存庫。前者 (來源)
|
||
必須連線至目的地，而後者 (目的地)
|
||
不會將本身連線至來源。
|
||
|
||
在一般的分散式案例中，開發人員會將資料從其本機伺服器
|
||
推送至主要伺服器。此外，開發人員可能也會想要從主要伺服器
|
||
提取最新的儲存庫更新。
|
||
|
||
若對兩個複寫的儲存庫上的相同分支同時
|
||
進行了變更，複寫可以解決此類情況。
|
||
|
||
- 推送：如果您嘗試將資料推送至儲存庫，而當中的變更比您傳送
|
||
的變更要新，系統將要求您提取最新變更、解決合併作業，
|
||
最後再次嘗試推送。
|
||
|
||
- 提取：每當您從遠端分支提取變更集時，它們會直接連結至
|
||
其上層變更集。如果您提取的變更集
|
||
不是分支中最後一個變更集的下層項目，則會出現多標頭
|
||
案例。分支將有多個「標頭」，或在分支上有
|
||
最後一個變更集。您必須先合併兩個「標頭」，
|
||
才能再次推送。
|
||
|
||
推送可在兩種模式下運作：
|
||
|
||
1) 伺服器之間的直接通訊：原始伺服器會將資料
|
||
傳送至目的地伺服器，自動為
|
||
指定的分支同步資料。
|
||
|
||
2) 匯出套件模式：用戶端只會連線至來源並
|
||
產生複寫套件，取得指定分支的
|
||
資料和中繼資料。不會使用 '--^package' 修飾詞。
|
||
|
||
這兩種模式都會要求使用者執行命令以接受
|
||
伺服器的驗證，無論是使用 client.conf
|
||
檔案中的預設驗證或是指定 '--^authmode' 和 '--^authdata' 修飾詞。
|
||
|
||
^push 複寫會以直接的方式運作。執行時，此命令
|
||
會將所選分支從來源複寫至目的地，而不
|
||
要求目的地儲存庫連線至來源和取得
|
||
所選分支 (如同提取所執行的動作)。
|
||
|
||
範例：
|
||
|
||
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084
|
||
(將 'main' 分支從 'myserver' 複寫至 'remoteserver'。在本例中，
|
||
會使用相同的驗證模式設定這兩個伺服器。)
|
||
|
||
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084 \
|
||
--^authmode=^LDAPWorkingMode --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(與之前一樣，複寫相同的分支，但現在遠端伺服器已設定為
|
||
透過 Active Directory 驗證使用者。例如，我正從 Linux 電腦
|
||
連線至設定為使用 Active Directory 整合模式的
|
||
Windows 伺服器。我會指定我的 Active Directory 使用者和加密的
|
||
密碼，並以 LDAP 形式將它傳遞至伺服器。)
|
||
|
||
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084 \
|
||
--^authmode=^UPWorkingMode --^user=dave --^password=mysecret
|
||
(複寫相同的分支，但現在使用者是在遠端伺服器上進行驗證，
|
||
善加利用
|
||
Unity VCS 所包含的使用者/密碼資料庫。)
|
||
|
||
== CMD_DESCRIPTION_CLONE ==
|
||
複製遠端儲存庫。
|
||
|
||
== CMD_USAGE_CLONE ==
|
||
用法：
|
||
|
||
cm ^clone <來源_儲存庫_規格> [<目的地_儲存庫_規格> | <目的地_儲存庫伺服器_規格>]
|
||
[--^user=<使用者_名稱> [--^password=<密碼>] | 授權選項]
|
||
[轉譯選項]
|
||
(直接 repository-to-repository 複製。)
|
||
|
||
cm ^clone <來源_儲存庫_規格> --^package=<套件_檔案>
|
||
[--^user=<使用者_名稱> [--^password=<密碼>] | 授權選項]
|
||
(複製至中繼套件，之後可透過
|
||
提取至目的地儲存庫的方式匯入。)
|
||
|
||
來源_儲存庫_規格 複製作業的來源儲存庫。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
規格。)
|
||
目的地_儲存庫_規格 複製作業的目的地儲存庫。如果存在
|
||
儲存庫，則它必須是空的。如果儲存庫不存在，則會
|
||
建立儲存庫。
|
||
如果未指定儲存庫，此命令會使用使用者的
|
||
預設儲存庫伺服器。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
規格。)
|
||
目的地_儲存庫伺服器_規格 複製作業的目的地儲存庫伺服器。
|
||
如果有一個儲存庫的名稱與
|
||
目的地儲存庫伺服器中的 <來源_儲存庫_規格> 相同，則它
|
||
必須是空的。如果沒有儲存庫，則會建立儲存庫。
|
||
如果未指定儲存庫，此命令會使用使用者的
|
||
預設儲存庫伺服器。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
|
||
伺服器規格。)
|
||
|
||
選項：
|
||
|
||
--^user, --^password 如果來源和目的地的驗證模式
|
||
不同且沒有可對目的地進行驗證的設定檔時，
|
||
所要使用的認證。
|
||
--^package 將指定的儲存庫匯出至套件檔案，
|
||
而不是匯出至儲存庫。
|
||
在沒有直接網路連線的情況下，可用在
|
||
伺服器之間移動資料。
|
||
產生的套件必須透過提取命令
|
||
匯入。
|
||
轉譯選項 如需詳細資訊，請參閱＜轉譯選項＞一節。
|
||
驗證選項 如需詳細資訊，請參閱
|
||
＜驗證選項＞一節。
|
||
|
||
轉譯選項：
|
||
--^trmode=(^copy|^name|^table --^trtable=<轉譯_表格_檔案>)
|
||
來源和目的地儲存庫可能會使用不同的驗證
|
||
模式。'--^trmode' 選項可指定如何將使用者名稱從
|
||
來源轉譯至目的地。'--^trmode' 必須是下列其中
|
||
一個值：
|
||
^copy (預設)。表示只會複製使用者識別碼。
|
||
^name 表示將按名稱比對使用者識別碼。
|
||
^table 使用 '--^trtable' 選項中指定的轉譯表格
|
||
(請參閱下方)。
|
||
|
||
--^trtable=<轉譯_表格_檔案>
|
||
如果轉譯模式為 '表格'，轉譯表格則為包含
|
||
<舊名稱;新名稱> (每行一個) 格式的文字行檔案。當
|
||
分支寫入至目的地儲存庫時，來源儲存庫中 '舊名稱'
|
||
所識別之使用者所建立的物件將設定至目的地上
|
||
具有 '新名稱' 的使用者。
|
||
|
||
驗證選項：
|
||
|
||
您可使用下列兩種模式之一指定驗證資料：
|
||
|
||
1) 使用驗證參數：--^authmode=<模式> --^authdata=<資料>
|
||
|
||
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
|
||
範例：
|
||
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
'--^authdata' 這一行是 client.conf 檔案和 profiles.conf 檔案中 <^SecurityConfig> 項目
|
||
的內容。您可從 Unity VCS GUI 的 [喜好設定] 下的複寫
|
||
設定檔索引標籤，輕鬆產生 profiles.conf
|
||
檔案。
|
||
|
||
如果您使用的是 ^UPWorkingMode，可以直接指定：
|
||
|
||
--^authmode=^UPWorkingMode --^user=<使用者> --^password=<密碼>
|
||
|
||
2) 驗證檔案，其中針對各個連線的目標伺服器您可能
|
||
有不同的檔案，包括該伺服器的認證。
|
||
|
||
--^authfile=<驗證_檔案>
|
||
此檔案包含 2 行：
|
||
行 1) 是模式 (如 '--^authmode' 所述)
|
||
行 2) 是驗證資料 (如 '--^authdata' 所述)
|
||
|
||
== CMD_HELP_CLONE ==
|
||
備註：
|
||
|
||
複製命令能夠將分支 (及其變更集、標籤、屬性、檢閱
|
||
等項目) 從來源儲存庫複寫至目的地
|
||
儲存庫。儲存庫可位於不同的伺服器。
|
||
|
||
可事先建立目的地儲存庫，但如果它包含
|
||
先前的資料，複製作業將會失敗。
|
||
|
||
複製作業不會複製儲存庫子模組，也不會複製
|
||
Xlink 下的儲存庫。
|
||
|
||
範例：
|
||
|
||
cm ^clone awesomeProject@tardis@cloud
|
||
(將 'awesomeProject' 儲存庫從 'tardis@cloud' 組織複製至
|
||
具有相同名稱的本機儲存庫。)
|
||
|
||
cm ^clone repo@server.home:9095 repo-local
|
||
(將 'repo' 從 'server.home:9095' 複製至使用者的預設
|
||
儲存庫伺服器的 'repo-local'。)
|
||
|
||
cm ^clone project@192.168.111.130:8084 ^repserver:192.168.111.200:9095
|
||
(將 'project' 儲存庫從 '192.168.111.130:8084' 複製至
|
||
'project@192.168.111.200:9095'。)
|
||
|
||
cm ^clone project@ldapserver:8084 --authfile=credentials.txt \
|
||
--^trmode=table --^trtable=table.txt
|
||
(根據遠端儲存庫使用驗證檔案
|
||
從 'ldapserver:8084' 複製 'project' 儲存庫，並按照指定的轉譯表格
|
||
轉譯使用者。)
|
||
|
||
cm ^clone project@server.home:9095 --^package=project.plasticpkg
|
||
cm ^repository ^create project@mordor.home:8084
|
||
cm ^pull --^package=project.plasticpkg project@mordor.home:8084
|
||
(將 'project' 儲存庫從 'server.home:9095' 複製至
|
||
'project.plasticpkg' 套件，這之後會透過提取至
|
||
'mordor.home:8084' 的 'porject' 儲存庫的方式匯入。)
|
||
|
||
== CMD_DESCRIPTION_REVERT ==
|
||
將項目還原為先前修訂。
|
||
|
||
== CMD_USAGE_REVERT ==
|
||
用法：
|
||
|
||
cm ^revert <修訂規格>
|
||
|
||
修訂規格 包含將在工作區中載入之內容的修訂的
|
||
變更集規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解修訂
|
||
規格。)
|
||
|
||
== CMD_HELP_REVERT ==
|
||
備註：
|
||
|
||
必須簽入項目。
|
||
|
||
範例：
|
||
|
||
cm ^revert dir#^cs:0
|
||
cm ^revert C:\mywks\dir\file1.txt#23456
|
||
|
||
== CMD_DESCRIPTION_HISTORY ==
|
||
顯示檔案或目錄的歷程記錄。
|
||
|
||
== CMD_USAGE_HISTORY ==
|
||
用法：
|
||
|
||
cm ^history | ^hist <項目_路徑>[ ...][--^long | --^format=<字串_格式>]
|
||
[--^symlink] [--^xml[=<輸出_檔案>]] [--^encoding=<名稱>]
|
||
|
||
項目_路徑 項目路徑。使用空格分隔路徑。使用
|
||
雙引號 (" ") 指定含空格的路徑。
|
||
路徑也可以是伺服器路徑修訂。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
選項：
|
||
|
||
--^long 顯示其他資訊。
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
--^symlink 將歷程記錄作業套用至符號連結，而不是
|
||
套用至目標。
|
||
--^xml 將 XML 格式的輸出列印至標準輸出。
|
||
可以指定輸出檔案。
|
||
--^encoding 與 '--^xml' 選項搭配使用，指定要在
|
||
XML 輸出中使用的編碼，亦即：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
|
||
== CMD_HELP_HISTORY ==
|
||
備註：
|
||
|
||
此命令會顯示指定項目的修訂清單和標籤、分支，
|
||
以及每個修訂的註解資訊。
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
{0} | {^date} 日期。
|
||
{1} | {^changesetid} 變更集號碼。
|
||
{2} | {^branch} 分支。
|
||
{4} | {^comment} 註解。
|
||
{5} | {^owner} 擁有者。
|
||
{6} | {^id} 修訂 ID。
|
||
{7} | {^repository} 儲存庫。
|
||
{8} | {^server} 伺服器。
|
||
{9} | {^repspec} 儲存庫規格。
|
||
{^tab} 插入定位字元空格。
|
||
{^newline} 插入新行。
|
||
|
||
範例：
|
||
|
||
cm ^history file1.txt "file 2.txt"
|
||
|
||
cm ^hist c:\workspace --^long
|
||
(顯示所有資訊。)
|
||
|
||
cm ^history 連結 --^symlink
|
||
(將歷程記錄作業套用至 '連結' 檔案，而非套用至目標；
|
||
此功能適用於 UNIX 環境。)
|
||
|
||
cm ^history ^serverpath:/src/foo/bar.c#^br:/main/task001@myserver
|
||
(從指定分支的伺服器路徑中擷取修訂版本歷程記錄。)
|
||
|
||
== CMD_DESCRIPTION_REVISION_TREE ==
|
||
顯示項目的修訂樹。
|
||
|
||
== CMD_USAGE_REVISION_TREE ==
|
||
用法：
|
||
|
||
cm ^tree <路徑> [--^symlink]
|
||
|
||
路徑 項目路徑。
|
||
|
||
選項：
|
||
|
||
--^symlink 將作業套用至連結檔案，而不是套用至目標。
|
||
|
||
== CMD_HELP_REVISION_TREE ==
|
||
範例：
|
||
|
||
cm ^tree fichero1.txt
|
||
cm ^tree c:\workspace
|
||
cm ^tree 連結 --^symlink
|
||
(將作業套用至連結檔案，而不是套用至目標；此功能適用於
|
||
UNIX 環境。)
|
||
|
||
== CMD_DESCRIPTION_REMOVE ==
|
||
可讓使用者刪除檔案和目錄。
|
||
|
||
== CMD_USAGE_REMOVE ==
|
||
用法：
|
||
|
||
cm ^remove | ^rm <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^controlled (選用)
|
||
^private
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^remove <命令> --^usage
|
||
cm ^remove <命令> --^help
|
||
|
||
== CMD_HELP_REMOVE ==
|
||
範例：
|
||
|
||
cm ^remove \path\controlled_file.txt
|
||
cm ^remove ^private \path\private_file.txt
|
||
|
||
== CMD_DESCRIPTION_REMOVE_CONTROLLED ==
|
||
從版本控制刪除檔案或目錄。
|
||
|
||
== CMD_USAGE_REMOVE_CONTROLLED ==
|
||
用法：
|
||
|
||
cm ^remove | ^rm <項目_路徑>[ ...][--^format=<字串_格式>]
|
||
[--^errorformat=<字串_格式>] [--^nodisk]
|
||
|
||
項目_路徑 要移除的項目路徑。使用雙引號 (" ") 指定
|
||
含空格的路徑。使用空格分隔
|
||
路徑。
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出進度
|
||
訊息。如需詳細資訊，請參閱範例。
|
||
--^errorformat 以指定的格式擷取錯誤訊息
|
||
(如果有的話)。如需詳細資訊，請參閱範例。
|
||
--^nodisk 從版本控制移除，但將項目保留在
|
||
磁碟上。
|
||
|
||
== CMD_HELP_REMOVE_CONTROLLED ==
|
||
備註：
|
||
|
||
會從磁碟刪除項目。會從原始程式碼控制的上層目錄中
|
||
移除已移除的項目。
|
||
|
||
要求：
|
||
- 項目必須受原始程式碼控制。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
'^remove' 命令可從 stdin 讀取路徑。若要執行此操作，可傳遞單一
|
||
破折號「-」來完成。
|
||
範例：cm ^remove -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線指定要移除的檔案。
|
||
範例：
|
||
dir /S /B *.c | cm ^remove -
|
||
(在 Windows 中，移除工作區中的所有 .c 檔案。)
|
||
|
||
範例：
|
||
|
||
cm ^remove src
|
||
(移除 'src'。如果 'src' 是目錄，這會與
|
||
'cm ^remove -^R src' 相同。)
|
||
|
||
cm ^remove c:\workspace\file.txt --^format="{0} - 已移除" \
|
||
--^errorformat="{0} - 移除時發生錯誤"
|
||
(從版本控制和磁碟中移除 'file.txt'；如果作業成功，則寫入
|
||
"c:\workspace\file.txt - ^REMOVED"，或如果作業失敗，則寫入
|
||
"c:\workspace\file.txt - ^ERROR ^REMOVING"。)
|
||
|
||
cm ^remove c:\workspace\file.txt --^nodisk
|
||
(從版本控制移除 'file.txt'，但將它保留在磁碟上。)
|
||
|
||
== CMD_DESCRIPTION_REMOVE_PRIVATE ==
|
||
刪除私人檔案或目錄。
|
||
|
||
警告：使用此命令刪除的檔案會永久刪除，而且無法
|
||
復原。建議您使用 '--^dry-run' 選項檢查
|
||
哪些檔案會受到此命令影響。
|
||
|
||
== CMD_USAGE_REMOVE_PRIVATE ==
|
||
用法：
|
||
|
||
cm ^remove | ^rm ^private <路徑>[ ...][-^R | -^r | --^recursive] [--^ignored]
|
||
[--^verbose] [--^dry-run]
|
||
|
||
路徑 要移除的檔案或目錄的路徑。使用雙
|
||
引號 (" ") 指定含空格的路徑。使用
|
||
空格分隔路徑。
|
||
|
||
選項：
|
||
|
||
--^r 以遞迴的方式從受控目錄內
|
||
刪除私人檔案。
|
||
--^ignored 同時刪除忽略和隱匿的檔案和目錄。
|
||
--^verbose 列印所有受影響的路徑。
|
||
--^dry-run 執行此命令，而不在磁碟上進行任何變更。
|
||
|
||
== CMD_HELP_REMOVE_PRIVATE ==
|
||
備註：
|
||
|
||
如果路徑是私人檔案或目錄，則會從磁碟中將其刪除。
|
||
如果路徑是受控檔案，此命令會失敗。
|
||
如果路徑是受控目錄，除非您
|
||
指定 '-^r' 選項 (如此一來，將會刪除指定目錄下的所有私人檔案和
|
||
目錄)，否則此命令會失敗。
|
||
|
||
範例：
|
||
|
||
cm ^remove ^private 私人_目錄
|
||
(刪除 '私人_目錄'。)
|
||
|
||
cm ^remove ^private c:\workspace\受控_目錄
|
||
(失敗，因為 '受控_目錄' 不是私人目錄。)
|
||
|
||
cm ^remove ^private -^r c:\workspace\受控_目錄
|
||
(刪除 '受控_目錄' 下的所有私人檔案和目錄。)
|
||
|
||
cm ^rm ^private --^dry-run --^verbose c:\workspace\受控_目錄 -^r
|
||
(顯示受到刪除 '受控_目錄' 下的私人檔案所影響的
|
||
所有路徑 (實際上未刪除任何項目)。)
|
||
|
||
cm ^rm ^private --^verbose c:\workspace\受控_目錄 -^r
|
||
(顯示受到刪除 '受控_目錄' 下的私人檔案所影響的
|
||
所有路徑 (執行刪除動作)。)
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_DELETE ==
|
||
刪除觸發器。
|
||
|
||
== CMD_USAGE_TRIGGER_DELETE ==
|
||
用法：
|
||
|
||
cm ^trigger | ^tr ^delete | ^rm <子類型-類型> <位置_號碼>
|
||
[--^server=<儲存庫伺服器規格>]
|
||
|
||
子類型-類型 觸發器執行與觸發器作業。
|
||
輸入 'cm ^showtriggertypes' 以查看觸發器
|
||
類型的清單。
|
||
位置_號碼 建立觸發器時指派給它的位置。
|
||
|
||
選項：
|
||
|
||
--^server 在指定的伺服器上刪除觸發器。
|
||
如果未指定任何伺服器，請在用戶端上設定的
|
||
伺服器上執行命令。
|
||
|
||
== CMD_HELP_TRIGGER_DELETE ==
|
||
範例：
|
||
|
||
cm ^trigger ^delete ^after-setselector 4
|
||
cm ^tr ^rm ^after-setselector 4
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_SET ==
|
||
在指定的物件上設定屬性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_SET ==
|
||
用法：
|
||
|
||
cm ^attribute | ^att ^set <屬性_規格> <物件_規格> <屬性_值>
|
||
|
||
屬性_規格 屬性規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解屬性規格。)
|
||
物件_規格 要設定屬性的物件規格。
|
||
可在下列項目上設定屬性：分支、變更集、
|
||
擱置集、標籤、項目和修訂。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
屬性_值 要對物件設定的屬性值。
|
||
|
||
== CMD_HELP_ATTRIBUTE_SET ==
|
||
備註：
|
||
|
||
可在物件上設定屬性，以儲存此物件的
|
||
其他資訊。
|
||
可在下列物件上設定屬性：分支、變更集、
|
||
擱置集、標籤、項目和修訂。
|
||
|
||
範例：
|
||
|
||
cm ^attribute ^set ^att:狀態 ^br:/main/SCM105 未解決
|
||
(使用 '未解決' 值將 '狀態' 屬性設定為 'SCM105' 分支。)
|
||
|
||
cm ^att ^set ^att:整合@reptest@server2:8084 ^lb:LB008@reptest@server2:8084 是
|
||
(在 'reptest' 儲存庫中以 '是' 值將 '整合' 屬性設定為
|
||
標籤 'LB008' 。)
|
||
|
||
== CMD_DESCRIPTION_SETOWNER ==
|
||
設定物件的擁有者。
|
||
|
||
== CMD_USAGE_SETOWNER ==
|
||
用法：
|
||
|
||
cm ^setowner | ^sto --^user=<使用者_名稱> | --^group=<群組> <物件_規格>
|
||
|
||
--^user 使用者名稱。物件的新擁有者。
|
||
--^group 群組名稱。物件的新擁有者。
|
||
物件_規格 要設定新擁有者的物件規格。
|
||
可在下列物件上設定擁有者：
|
||
儲存庫伺服器、儲存庫、分支、變更集、
|
||
標籤、項目、修訂和屬性。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
== CMD_HELP_SETOWNER ==
|
||
備註：
|
||
|
||
物件擁有者可為使用者或群組。
|
||
|
||
可在下列物件上設定擁有者：儲存庫伺服器、
|
||
儲存庫、分支、變更集、標籤、項目、修訂和屬性。
|
||
|
||
範例：
|
||
|
||
cm ^setowner --^user=john ^repserver:localhost:8084
|
||
(將 'john' 設定為儲存庫伺服器擁有者。)
|
||
|
||
cm ^sto --^group=development ^rep:mainRep@PlasticServer:8084
|
||
(將 'development' 群組設定為 'mainRep' 儲存庫的擁有者。)
|
||
|
||
== CMD_DESCRIPTION_SETSELECTOR ==
|
||
將選擇器設定為工作區。
|
||
|
||
== CMD_USAGE_SETSELECTOR ==
|
||
此命令已棄用。它的存在是為了回溯相容性，
|
||
但在 Unity VCS 4.0 中大多已棄用選擇器。選擇器仍
|
||
存在是為了指定工作分支或變更集，但舊規則
|
||
篩選路徑的功能已不再受到支援。
|
||
|
||
用法：
|
||
cm ^setselector | ^sts [--^file=<選擇器_檔案>] [--^ignorechanges]
|
||
[--^forcedetailedprogress] [<工作區_路徑> | <工作區_規格>]
|
||
|
||
選項：
|
||
|
||
--^file 要從中載入選擇器的檔案。
|
||
--^ignorechanges 如果在更新工作區時偵測到
|
||
暫止的變更，則忽略顯示的暫止
|
||
變更警告訊息。
|
||
--^forcedetailedprogress 強制顯示詳細進度，即使在標準輸出
|
||
重新導向的情況下亦然。
|
||
工作區_路徑 要設定選擇器的工作區路徑。
|
||
工作區_規格 工作區規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解工作區規格。)
|
||
|
||
== CMD_HELP_SETSELECTOR ==
|
||
備註：
|
||
|
||
此命令會設定工作區的選擇器。
|
||
|
||
工作區需要資訊才能從儲存庫載入修訂。
|
||
為取得此資訊，Unity VCS 會使用選擇器。
|
||
|
||
透過選擇器，您可以從指定的分支、
|
||
標籤或變更集載入修訂。
|
||
|
||
如果未指定要載入選擇器的檔案，則會執行預設的作業
|
||
系統編輯器。
|
||
|
||
範例選擇器：
|
||
|
||
^repository "^default" // 工作中儲存庫
|
||
^path "/" // 規則將套用至根目錄
|
||
^branch "/^main" // 從 ^br:/^main 取得最新修訂
|
||
^checkout "/^main" // 將簽出置於分支 ^br:/^main 上
|
||
|
||
範例：
|
||
|
||
cm ^sts
|
||
(開啟要套用的目前選擇器檔案。)
|
||
|
||
cm ^sts ^wk:workspace_projA@reptest
|
||
(開啟要套用的指定選擇器檔案。)
|
||
|
||
cm ^setselector --^file=c:\selectors\sel.xml
|
||
(在目前工作區中設定指定的選擇器檔案。)
|
||
|
||
cm ^setselector --^file=c:\selectors\sel.xml ^wk:MyWorkspace
|
||
(在所選工作區中設定指定的選擇器檔案。)
|
||
|
||
== CMD_DESCRIPTION_SHELVE ==
|
||
擱置已簽出項目的內容。
|
||
|
||
== CMD_USAGE_SHELVE ==
|
||
此命令已棄用。請改用 'cm ^shelveset'。
|
||
|
||
用法：
|
||
|
||
cm ^shelve [<項目_路徑>+] [--^all] [--^dependencies]
|
||
[-^c=字串_註解 | -^commentsfile=<註解_檔案>]
|
||
[--^encoding=名稱] [--^comparisonmethod=比較_方法]
|
||
(擱置內容。)
|
||
|
||
cm ^shelve --^apply=<擱置_規格> [--^mount]
|
||
(套用已儲存的擱置集。)
|
||
|
||
--^apply 還原指定擱置集的擱置內容。
|
||
擱置規格：查看 'cm ^help ^objectspec'。
|
||
|
||
cm ^shelve --^delete=<擱置_規格>
|
||
(移除已儲存的擱置集。)
|
||
|
||
--^delete 移除指定的擱置集。
|
||
擱置集規格：查看 'cm ^help ^objectspec'。
|
||
|
||
選項：
|
||
|
||
項目_路徑 要擱置的項目 (以空格分隔)。可使用引號 (")
|
||
來指定含空格的路徑。
|
||
--^all 指定路徑上在本地變更、移動和刪除的項目
|
||
也會包括在內。
|
||
--^dependencies 將本地變更相依性包含在
|
||
要擱置的項目中。
|
||
-^c 將指定註解套用至已建立的擱置集。
|
||
-^commentsfile 將指定檔案中的註解套用至已建立的
|
||
擱置集。
|
||
--^encoding 指定輸出編碼，例如：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^comparisonmethod 設定比較方法。如需詳細資訊，請參閱備註。
|
||
--^mount 指定儲存庫的裝載點。
|
||
|
||
== CMD_HELP_SHELVE ==
|
||
|
||
備註：
|
||
|
||
如果未指定 <項目_路徑> 也未指定任何選項，擱置將包含
|
||
工作區中所有暫止的變更。
|
||
|
||
擱置作業一律會從指定路徑以遞迴方式套用。
|
||
|
||
擱置項目的要求：
|
||
- 項目必須受原始程式碼控制。
|
||
- 項目必須簽出或變更 (必須使用 --^all 選項)。
|
||
|
||
比較方法:
|
||
^ignoreeol 忽略行尾差異。
|
||
^ignorewhitespaces 忽略空格差異。
|
||
^ignoreeolwhitespaces 忽略行尾和空格差異。
|
||
^notignore 偵測行尾和空格差異。
|
||
|
||
設定 PLASTICEDITOR 環境變數，以指定要輸入
|
||
註解的編輯器。
|
||
|
||
範例：
|
||
|
||
cm ^shelve -^c="我的註解"
|
||
(擱置目前工作區中所有暫止的變更，包括
|
||
註解。)
|
||
|
||
cm ^shelve file1.txt "file 2.txt" -^commentsfile=commentshelve.txt
|
||
(擱置所選暫止的變更並套用
|
||
commentshelve.txt 檔案中的註解。)
|
||
|
||
cm ^shelve --^apply=^sh:3
|
||
(套用已儲存的擱置集。)
|
||
|
||
cm ^shelve --^delete=^sh:3
|
||
(移除已儲存的擱置集。)
|
||
|
||
cm ^status --^short --^changelist=暫止_待_檢閱 | cm ^shelve -
|
||
(擱置用戶端變更清單。
|
||
以上命令會列出名為 '暫止_待_檢閱' 變更清單中
|
||
的路徑，且此路徑清單會重新導向至
|
||
擱置命令的輸入。)
|
||
|
||
== CMD_DESCRIPTION_SHELVESET ==
|
||
可讓使用者管理擱置集。
|
||
|
||
== CMD_USAGE_SHELVESET ==
|
||
用法：
|
||
|
||
cm ^shelveset <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^apply
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^shelveset <命令> --^usage
|
||
cm ^shelveset <命令> --^help
|
||
|
||
== CMD_HELP_SHELVESET ==
|
||
範例：
|
||
|
||
cm ^shelveset ^create -^c="我的註解"
|
||
cm ^shelveset ^delete ^sh:3
|
||
cm ^shelve ^apply ^sh:3
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_CREATE ==
|
||
擱置暫止的變更。
|
||
|
||
== CMD_USAGE_SHELVESET_CREATE ==
|
||
用法：
|
||
|
||
cm ^shelveset ^create | ^mk [<項目_路徑>[ ...]] [--^all] [--^dependencies]
|
||
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
|
||
|
||
選項：
|
||
|
||
項目_路徑 要擱置的項目。使用空格分隔使用者名稱。
|
||
使用雙引號 (" ") 指定含空格的
|
||
路徑。
|
||
--^all 指定路徑上在本地變更、移動和刪除的項目
|
||
也會包括在內。
|
||
--^dependencies 將本地變更相依性包含在
|
||
要擱置的項目中。
|
||
-^c 將指定註解套用至已建立的擱置。
|
||
-^commentsfile 將指定檔案中的註解套用至已建立的
|
||
擱置。
|
||
|
||
== CMD_HELP_SHELVESET_CREATE ==
|
||
'^shelveset ^create' 命令會將已簽出項目的內容儲存在
|
||
儲存庫內。如此一來，內容就會受到保護，而不需要
|
||
簽入檔案。
|
||
|
||
備註：
|
||
|
||
如果未指定 <項目_路徑> 或任何選項，擱置集將
|
||
包含工作區中所有暫止的變更。
|
||
|
||
'^shelveset ^create' 作業一律會從指定路徑以遞迴方式
|
||
套用。
|
||
|
||
擱置項目的要求：
|
||
- 項目必須受原始程式碼控制。
|
||
- 項目必須簽出或變更 (必須使用 '--^all' 選項)。
|
||
|
||
設定 PLASTICEDITOR 環境變數，以指定要輸入
|
||
註解的編輯器。
|
||
|
||
範例：
|
||
|
||
cm ^shelveset ^create -^c="我的註解"
|
||
(擱置目前工作區中所有暫止的變更，包括
|
||
註解。)
|
||
|
||
cm ^shelveset file1.txt "file 2.txt" -^commentsfile=commentshelve.txt
|
||
(擱置所選暫止的變更並套用 'commentshelve.txt' 檔案中
|
||
的註解。請注意，'^create' 為預設子命令。)
|
||
|
||
cm ^status --^short --^changelist=暫止_待_檢閱 | cm ^shelveset -
|
||
(擱置用戶端變更清單。
|
||
以上命令會列出名為 '暫止_待_檢閱' 變更清單中
|
||
的路徑，且此路徑清單會重新導向至
|
||
'^shelveset' 命令的輸入。)
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_DELETE ==
|
||
刪除擱置集。
|
||
|
||
== CMD_USAGE_SHELVESET_DELETE ==
|
||
用法：
|
||
|
||
cm ^shelveset ^delete | ^rm <擱置_規格>
|
||
|
||
擱置_規格 擱置集規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解擱置集規格。)
|
||
|
||
== CMD_HELP_SHELVESET_DELETE ==
|
||
'^shelveset ^delete' 命令會刪除擱置集。
|
||
|
||
範例：
|
||
|
||
cm ^shelveset ^delete ^sh:3
|
||
(移除已儲存的擱置集。)
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_APPLY ==
|
||
套用已儲存的擱置集。
|
||
|
||
== CMD_USAGE_SHELVESET_APPLY ==
|
||
用法：
|
||
|
||
cm ^shelveset ^apply <擱置_規格> [--^mount] [--^encoding=<名稱>]
|
||
[--^comparisonmethod=(^ignoreeol | ^ignorewhitespaces| \
|
||
^ignoreeolwhitespaces | ^notignore)]
|
||
|
||
擱置_規格 擱置集規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解擱置集規格。)
|
||
|
||
選項：
|
||
|
||
--^mount 指定儲存庫的裝載點。
|
||
--^encoding 指定輸出編碼，例如：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^comparisonmethod 設定比較方法。如需詳細資訊，請參閱備註。
|
||
|
||
== CMD_HELP_SHELVESET_APPLY ==
|
||
'^shelveset ^apply' 命令會還原已儲存擱置集的內容。
|
||
|
||
備註：
|
||
|
||
比較方法:
|
||
^ignoreeol 忽略行尾差異。
|
||
^ignorewhitespaces 忽略空格差異。
|
||
^ignoreeolwhitespaces 忽略行尾和空格差異。
|
||
^notignore 偵測行尾和空格差異。
|
||
|
||
範例：
|
||
|
||
cm ^shelveset ^apply ^sh:3
|
||
(套用已儲存擱置。)
|
||
|
||
== CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
|
||
列出物件和屬性。
|
||
|
||
== CMD_USAGE_SHOW_FIND_OBJECTS ==
|
||
用法：
|
||
|
||
cm ^showfindobjects
|
||
|
||
== CMD_HELP_SHOW_FIND_OBJECTS ==
|
||
可用物件與屬性：
|
||
|
||
^attribute:
|
||
您可使用下列欄位進行篩選以尋找屬性：
|
||
|
||
^type ：字串。
|
||
|
||
範例：
|
||
cm ^find ^attribute "^where ^type = '狀態'"
|
||
(尋找 '狀態' 類型的所有屬性。)
|
||
|
||
^value ：字串。
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
|
||
範例：
|
||
cm ^find ^attribute "^where ^date > '^this ^week'"
|
||
(尋找本週已套用的所有屬性。)
|
||
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
|
||
範例：
|
||
cm ^find ^attribute "^where ^value = '已解決' ^and ^owner = '^me'"
|
||
(尋找我已套用 '已解決' 值的所有屬性。)
|
||
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
^comment ：字串。
|
||
^srcobj ：物件規格：項目路徑、分支、變更集、修訂或標籤。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定這些物件。
|
||
|
||
範例：
|
||
cm ^find ^attribute "^where ^srcobj = '^item:readme.txt'"
|
||
(尋找已套用至項目 'readme.txt' 的屬性。)
|
||
|
||
cm ^find ^attribute "^where ^srcobj = '^br:/main/scm23343'"
|
||
(尋找已套用至 scm23343 分支的屬性。)
|
||
|
||
cm ^find ^attribute "^where ^srcobj = '^rev:readme.txt#^br:/main/task002'"
|
||
(尋找已套用至指定修訂版本的屬性。)
|
||
|
||
cm ^find ^attribute "^where ^srcobj = '^rev:^revid:1126'"
|
||
(尋找已套用至指定修訂 ID 的屬性。)
|
||
|
||
^ID ：整數。
|
||
|
||
^attributetype:
|
||
您可使用下列欄位進行篩選以尋找屬性類型：
|
||
|
||
^name ：字串。
|
||
|
||
範例：
|
||
cm ^find ^attributetype "^where ^name ^like 'st%'"
|
||
(尋找名稱開頭為 'st' 的所有屬性。)
|
||
|
||
^value ：字串。
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
|
||
範例：
|
||
cm ^find ^attribute "^where ^date > '^today'"
|
||
(尋找今天已套用的所有屬性。)
|
||
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
^comment ：字串。
|
||
|
||
範例：
|
||
cm ^find ^attributetype "^where ^comment != ''" --^xml
|
||
(尋找具有註解的所有屬性類型，並
|
||
以 XML 格式將輸出列印至標準輸出。)
|
||
|
||
^source ：物件規格：項目路徑、分支、變更集或標籤。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定這些物件。
|
||
|
||
範例：
|
||
|
||
cm ^find ^attributetype "^where ^source = '^item:readme.txt'"
|
||
(尋找項目 'readme.txt' 中的所有屬性類型。)
|
||
|
||
cm ^find ^attributetype "^where ^source = '^cs:30'"
|
||
(尋找變更集 '30' 中的所有屬性類型。)
|
||
|
||
cm ^find ^attributetype "^where ^source = '^lb:v0.14.1'"
|
||
(尋找標籤 'v0.14.1' 中的所有屬性類型。)
|
||
|
||
^ID ：整數。
|
||
|
||
複寫欄位。檢查下列「複寫相關欄位」。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^branch:
|
||
您可使用下列欄位進行篩選以尋找分支：
|
||
|
||
^name ：字串。
|
||
|
||
範例：
|
||
cm ^find ^branch "^where ^name ^like 'scm23%'"
|
||
(尋找名稱開頭為 'scm23' 的分支。)
|
||
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
|
||
範例：
|
||
cm ^find ^branch "^where ^date > '^one ^week ^ago'"
|
||
(尋找上週已建立的分支。)
|
||
|
||
^changesets ：日期 (分支中變更集的日期)。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
|
||
範例：
|
||
cm ^find ^branch "^where ^changesets >= '^today'"
|
||
(尋找今天已建立且含有變更集的分支。)
|
||
|
||
^attribute ：字串。
|
||
^attrvalue ：字串。
|
||
|
||
範例：
|
||
cm ^find ^branch "^where ^attribute = '狀態' ^and ^attrvalue = '失敗'"
|
||
(尋找具有 '狀態' 屬性且
|
||
值為 '失敗' 的分支。)
|
||
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
^parent ：分支規格。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
|
||
|
||
範例：
|
||
cm ^find ^branch "^where ^owner != '^me' ^and ^parent != '^br:/main'"
|
||
(尋找由其他人建立且其上層
|
||
分支並非 '/main' 的分支。)
|
||
|
||
^comment ：字串。
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
|
||
^ID ：整數。
|
||
|
||
範例：
|
||
cm ^find ^branch "^where ^id = 2029607"
|
||
(尋找 ID 為 2029607 的分支。)
|
||
|
||
複寫欄位。檢查下列「複寫相關欄位」。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^changeset:
|
||
您可使用下列欄位進行篩選以尋找變更集：
|
||
|
||
^branch ：分支規格。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定此
|
||
物件。
|
||
|
||
範例：
|
||
cm ^find ^changeset "^where ^branch = '/main/scm23119'"
|
||
(尋找分支 'scm23119' 中的所有變更集。)
|
||
|
||
^changesetid ：整數。
|
||
^attribute ：字串。
|
||
|
||
範例：
|
||
cm ^find ^changeset "^where ^attribute = '狀態'"
|
||
(尋找具有 '狀態' 屬性的變更集。)
|
||
|
||
^attrvalue ：字串。
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
|
||
範例：
|
||
cm ^find ^changeset "^where ^date >= '2018/8/6' ^and ^owner != '^me'"
|
||
(尋找建立日期大於或等於
|
||
2018/8/6 且由其他人建立的所有變更集。)
|
||
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
|
||
範例：
|
||
cm ^find ^changeset "^where ^guid = '1b30674f-14cc-4fd7-962b-676c8a6f5cb6'"
|
||
(尋找具有指定 GUID 的變更集。)
|
||
|
||
^comment ：字串。
|
||
|
||
範例：
|
||
cm ^find ^changeset "^where ^comment = ''"
|
||
(尋找不含任何註解的變更集。)
|
||
|
||
^onlywithrevisions：布林值。
|
||
篩選變更集是否有修訂。
|
||
|
||
範例：
|
||
cm ^find ^changeset "^where ^onlywithrevisions = 'false'"
|
||
(尋找不含任何修訂的變更集。)
|
||
|
||
^returnparent ：布林值。
|
||
回到變更集上層的方式。適合用於編寫指令碼。
|
||
|
||
範例：
|
||
cm ^find ^changeset "^where ^changesetid = 29 ^and ^returnparent = 'true'"
|
||
(尋找變更集 29 的上層。)
|
||
|
||
^parent ：變更集 ID (整數)。
|
||
|
||
範例：
|
||
cm ^find ^changeset "^where ^parent = 548"
|
||
(尋找上層為變更集 548 的所有變更集。)
|
||
|
||
^ID ：整數。
|
||
|
||
複寫欄位。檢查下列「複寫相關欄位」。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^label:
|
||
您可使用下列欄位進行篩選以尋找標籤：
|
||
|
||
^name ：字串。
|
||
|
||
範例：
|
||
cm ^find ^label "^where ^name ^like '7.0.16.%'"
|
||
(尋找名稱開頭為 '7.0.16' 的標籤。)
|
||
|
||
^attribute ：字串。
|
||
^attrvalue ：字串。
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
|
||
範例：
|
||
cm ^find ^label "^where ^date >= '^this ^month' ^and \
|
||
^attribute = '發佈-狀態' ^and ^attrvalue != '已發佈'"
|
||
(尋找本月已建立且 '發佈-狀態' 屬性
|
||
設為 '已發佈' 以外的值的標籤。)
|
||
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
^branch ：分支規格。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
|
||
|
||
範例：
|
||
cm ^find ^label "^where ^branch = '/main'"
|
||
(尋找已套用至主要分支的所有標籤。)
|
||
|
||
^branchid ：整數。
|
||
^changeset ：變更集 ID (整數)。
|
||
|
||
範例：
|
||
cm ^find ^label "^where ^changeset = 111733"
|
||
(尋找已套用至變更集 111733 的標籤。)
|
||
|
||
^comment ：字串。
|
||
^ID ：整數。
|
||
|
||
複寫欄位。檢查下列「複寫相關欄位」。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^merge:
|
||
您可使用下列欄位進行篩選以尋找合併：
|
||
|
||
^srcbranch ：分支規格。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
|
||
|
||
範例：
|
||
cm ^find ^merge "^where ^srcbranch = '^br:/main'"
|
||
(尋找來自主要分支的合併。)
|
||
|
||
^srcchangeset ：變更集 ID (整數)。
|
||
^dstbranch ：分支規格。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
|
||
^dstchangeset ：變更集 ID (整數)。
|
||
|
||
範例：
|
||
cm ^find ^merge "^where ^dstchangeset = 108261" \
|
||
--^format="{^srcbranch} {^srcchangeset} {^dstbranch} {^dstchangeset} {^owner}"
|
||
(尋找變更集 108261 的合併，並列印
|
||
顯示來源 (分支和變更集 ID)、
|
||
目的地 (分支和變更集 ID) 以及合併擁有者的格式化輸出。)
|
||
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
^type ：字串。
|
||
可能的值為 '^merge'、'^cherrypick'、
|
||
'^cherrypicksubstractive'、'^interval'、'^intervalcherrypick'
|
||
和 '^intervalcherrypicksubstractive'
|
||
|
||
範例：
|
||
cm ^find ^merge "^where ^type = '^cherrypick' ^and ^owner = '^me'"
|
||
(尋找我所有精心挑選的項目。)
|
||
|
||
^ID ：整數。
|
||
|
||
^replicationlog:
|
||
您可使用下列欄位進行篩選以尋找複寫記錄：
|
||
|
||
^branch ：分支規格。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
|
||
|
||
範例：
|
||
cm ^find ^replicationlog "^where ^branch = '/main/gm22358'"
|
||
(尋找分支 'gm22358' 的複寫記錄。)
|
||
|
||
^repositoryname ：字串。
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
^server ：字串。
|
||
^package ：布林值。
|
||
|
||
範例：
|
||
cm ^find ^replicationlog "^where ^package = 'T' ^and ^server ^like '%cloud%'"
|
||
(尋找從伺服器名稱包含 'cloud' 之套件
|
||
所建立的複寫記錄。)
|
||
|
||
^ID ：整數。
|
||
|
||
^review:
|
||
您可使用下列欄位進行篩選以尋找程式碼檢閱：
|
||
|
||
^status ：字串。
|
||
^assignee ：字串。
|
||
|
||
範例：
|
||
cm ^find ^review "^where ^status = '暫止' ^and ^assignee = '^me'"
|
||
(尋找我所有暫止的檢閱。)
|
||
|
||
^title ：字串。
|
||
^target ：物件規格：分支或變更集。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
|
||
|
||
範例：
|
||
cm ^find ^review "^where ^target = '^br:/main/scm17932'"
|
||
(尋找分支 'scm17932' 的相關檢閱。)
|
||
|
||
^targetid ：整數。
|
||
^targettype ：字串。
|
||
可能的值為 '^branch' 和 '^changeset'。
|
||
|
||
範例：
|
||
cm ^find ^review "^where ^targettype = '^changeset'"
|
||
(尋找目標類型為變更集的檢閱。)
|
||
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
^ID ：整數。
|
||
|
||
^revision:
|
||
您可使用下列欄位進行篩選以尋找修訂：
|
||
|
||
^branch ：分支規格。
|
||
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
|
||
^changeset ：變更集 ID (整數)。
|
||
|
||
範例：
|
||
cm ^find ^revision "^where ^changeset >= 111756"
|
||
(尋找變更集 111756
|
||
和更新版本中建立的修訂。)
|
||
|
||
^item ：字串或整數。
|
||
^itemid ：整數。
|
||
|
||
範例：
|
||
cm ^find ^revision "^where ^item = 'readme.txt' ^or ^itemid = 2250"
|
||
(尋找項目 'readme.txt' 的修訂以及
|
||
項目 ID 2250。)
|
||
|
||
cm ^find ^revision "^where ^item = 'readme.txt' ^or ^item = 2250"
|
||
(取得與先前範例相同的修訂。)
|
||
|
||
^attribute ：字串。
|
||
^attrvalue ：字串。
|
||
|
||
範例：
|
||
cm ^find ^revision "^where ^attribute = '狀態' ^and ^attrvalue != '未解決'"
|
||
(尋找具有 '狀態' 屬性且值
|
||
並非 '未解決' 的修訂。)
|
||
|
||
^archived ：布林值。
|
||
|
||
範例：
|
||
cm ^find ^revision "^where ^archived = 'true'"
|
||
(尋找外部儲存空間中的
|
||
已封存修訂。)
|
||
|
||
^comment ：字串。
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
^parent ：修訂 ID (整數)。
|
||
^returnparent ：布林值。
|
||
^shelve ：擱置 ID (整數)。
|
||
^size ：整數 (以位元組為單位)。
|
||
^type ：字串。
|
||
可能的值為 '^dir'、'^bin' 和 '^txt'。
|
||
|
||
範例：
|
||
cm ^find ^revision "^where ^type = '^txt' 和 \
|
||
^size > 300000 ^and ^owner = '^me' and ^date >= '2 ^months ^ago'"
|
||
(尋找我在兩個月之前建立
|
||
且大小約大於 3MB 的文字修訂。)
|
||
|
||
^workspacecheckoutid ：整數。
|
||
^ID ：整數。
|
||
|
||
複寫欄位。檢查下列「複寫相關欄位」。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^shelve:
|
||
您可使用下列欄位進行篩選以尋找擱置：
|
||
|
||
^owner ：使用者。
|
||
准許特殊使用者 '^me'。
|
||
^date ：日期。
|
||
如需詳細資訊，請查看本指南中的「日期常數」。
|
||
|
||
範例：
|
||
cm ^find ^shelve "^where ^owner != '^me' ^and ^date >= '^1 ^years ^ago'"
|
||
(尋找其他人在去年
|
||
期間建立的擱置。)
|
||
|
||
^attribute ：字串。
|
||
^attrvalue ：字串。
|
||
^comment ：字串。
|
||
^GUID ：全域唯一識別碼。
|
||
十六進位 ID (格式為 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
|
||
^parent ：整數。
|
||
^shelveid ：整數。
|
||
|
||
範例：
|
||
cm ^find ^shelve "^where ^shelveid = 2"
|
||
(尋找具有名稱 2 的擱置。)
|
||
|
||
^ID ：整數。
|
||
|
||
範例：
|
||
cm ^find ^shelve "^where ^id >= 3848"
|
||
(尋找具有 ID 大於 3848 之物件的擱置。)
|
||
|
||
複寫欄位。檢查下列「複寫相關欄位」。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
|
||
複寫相關欄位：
|
||
很多物件會追蹤複寫資料，這表示 Unity VCS 會追蹤
|
||
原本建立這些資料的所在位置。
|
||
|
||
您可以使用的欄位包括：
|
||
|
||
^ReplSrcServer ：儲存庫規格。代表「複寫來源伺服器」。
|
||
已從中複寫物件的伺服器。
|
||
|
||
範例：
|
||
cm ^find ^branch "^where ^replsrcserver='skull.codicefactory.com:9095'"
|
||
(尋找從伺服器 'skull' 複寫的分支。)
|
||
|
||
^ReplSrcRepository ：字串。代表「複寫來源儲存庫」。這是
|
||
已從中複寫物件的儲存庫。
|
||
|
||
範例：
|
||
cm ^find ^branch "^where ^replsrcserver = 'skull.codicefactory.com:9095' \
|
||
^and ^replsrcrepository = 'codice'"
|
||
(尋找已從伺服器 'skull' 和儲存庫
|
||
'codice' 複寫的分支。)
|
||
|
||
^ReplLogId ：整數。複寫作業的 ID。在 Unity VCS 中，
|
||
每次從複本建立新物件時，
|
||
都會建立新的「複寫記錄」。
|
||
|
||
範例：
|
||
cm ^find ^revision "^where ^repllogid = 2019974"
|
||
(尋找從複本
|
||
2019974 複寫的修訂。)
|
||
|
||
^ReplSrcDate ：日期。這是複本實際發生的
|
||
日期。
|
||
複寫物件會保留其原始建立日期，
|
||
而如果您想要尋找在特定時間
|
||
範圍內複寫的物件，
|
||
此欄位會非常有用。
|
||
|
||
範例：
|
||
cm ^find ^label "^where ^replsrcdate >= '^one ^month ^ago' \
|
||
^and ^date >= '15 ^days ^ago'"
|
||
(尋找在 15 天之前建立且在一個月
|
||
之前複寫的標籤。)
|
||
|
||
cm ^find ^replicationlog "^where ^date > '^one ^week ^ago'"
|
||
8780433 2018/09/27 8:49:38 codice@BACKYARD:8087 F mbarriosc
|
||
(尋找一週之前建立的複寫記錄。)
|
||
|
||
現在，您可以檢查是否已在複寫前
|
||
建立複寫分支：
|
||
|
||
cm ^find ^branch "^where ^repllogid = 8780433"
|
||
8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T
|
||
|
||
^ReplSrcId ：整數。這是複寫來源伺服器的 ID。
|
||
您可使用 'cm ^find' 命令搜尋
|
||
'^replicationsource' 物件以探索此 ID。
|
||
|
||
範例：
|
||
cm ^find ^replicationsource
|
||
7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
|
||
8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9
|
||
|
||
現在，您可從以下尋找複寫的變更集：
|
||
codice@AFRODITA:8087:
|
||
|
||
cm ^find ^changesets "^where ^replsrcid = 7860739"
|
||
|
||
|
||
日期常數：
|
||
您可以使用遵循您的機器當地語系化設定的日期格式。
|
||
例如，如果您的電腦顯示 'MM-dd-yyyy' 格式的日期，
|
||
，則您可以在查詢中使用 '12-31-2019' 等日期。
|
||
|
||
您也可以使用下列常數簡化查詢：
|
||
'^today' ：今天的日期。
|
||
'^yesterday' ：昨天的日期。
|
||
'^this ^week' ：本週星期一的日期。
|
||
'^this ^month' ：本月第 1 天的日期。
|
||
'^this ^year' ：今年 1 月 1 日的日期。
|
||
'^one ^day ^ago' ：目前日期的一天前。
|
||
'^one ^week ^ago' ：目前日期的七天前。
|
||
'^one ^month ^ago' ：目前日期的一個月前。
|
||
'n ^days ^ago' ：目前日期的「n」天前。
|
||
'n ^months ^ago' ：目前日期的「n」個月前。
|
||
'n ^years ^ago' ：目前日期的「n」年前。
|
||
|
||
下列 '^where' 子句適用於欄位類型 '^date':
|
||
'(...)^where ^date > '^today' (...)'
|
||
'(...)^where ^date < '^yesterday' (...)'
|
||
'(...)^where ^date > '^this ^week' (...)'
|
||
'(...)^where ^date > '^this ^month' (...)'
|
||
'(...)^where ^date < '^one ^day ^ago' ^and ^date > '3 ^days ^ago' (...)'
|
||
'(...)^where ^date < '^one ^week ^ago' ^and ^date > '3 ^weeks ^ago' (...)'
|
||
'(...)^where ^date < '^one ^month ^ago' ^and ^date > '3 ^months ^ago' (...)'
|
||
'(...)^where ^date > '1 ^year ^ago' (...)'
|
||
|
||
您也可以在 'cm ^find' 命令上透過
|
||
--^dateformat 標誌強制使用特定日期格式。請查看 'cm ^find --^help' 以瞭解詳細資訊。
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
|
||
顯示可用的觸發類型。
|
||
|
||
== CMD_USAGE_TRIGGER_SHOWTYPES ==
|
||
用法：
|
||
|
||
cm ^trigger ^showtypes
|
||
|
||
== CMD_DESCRIPTION_SHOWACL ==
|
||
顯示物件的 ACL。
|
||
|
||
== CMD_USAGE_SHOWACL ==
|
||
用法：
|
||
|
||
cm ^showacl | ^sa <物件_規格> [--^extended] [--^xml[=<輸出_檔案>]]
|
||
[--^encoding=<名稱>]
|
||
|
||
物件_規格 要顯示 ACL 的物件規格。
|
||
此命令的有效物件為：
|
||
儲存庫伺服器、儲存庫、分支、變更集、標籤、項目，
|
||
以及屬性。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
選項：
|
||
|
||
--^extended 顯示 ACL 階層樹。
|
||
--^xml 將 XML 格式的輸出列印至標準輸出。
|
||
可以指定輸出檔案。
|
||
--^encoding 與 '--^xml' 選項搭配使用，指定要在
|
||
XML 輸出中使用的編碼，亦即：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
|
||
== CMD_HELP_SHOWACL ==
|
||
範例：
|
||
|
||
cm ^showacl ^repserver:PlasticServer:8084
|
||
(顯示所選伺服器的 ACL。)
|
||
|
||
cm ^sa ^br:/main --^extended
|
||
(顯示所選分支規格的 ACL 階層樹。)
|
||
|
||
== CMD_DESCRIPTION_SHOWCOMMANDS ==
|
||
顯示所有可用命令。
|
||
|
||
== CMD_USAGE_SHOWCOMMANDS ==
|
||
用法：
|
||
|
||
cm ^showcommands
|
||
|
||
== CMD_HELP_SHOWCOMMANDS ==
|
||
|
||
== CMD_DESCRIPTION_SHOWOWNER ==
|
||
顯示物件的擁有者。
|
||
|
||
== CMD_USAGE_SHOWOWNER ==
|
||
用法：
|
||
|
||
cm ^showowner | ^so <物件_規格>
|
||
|
||
物件_規格 要顯示擁有者的物件規格。
|
||
物件必須是下列其中一種：
|
||
儲存庫伺服器、儲存庫、分支、變更集、
|
||
標籤、屬性、修訂和項目。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
== CMD_HELP_SHOWOWNER ==
|
||
備註：
|
||
|
||
此命令會顯示物件的擁有者。擁有者可為使用者或
|
||
群組。可使用 'cm ^setowner' 命令修改擁有者。
|
||
|
||
範例：
|
||
|
||
cm ^showowner ^repserver:PlasticServer:8084
|
||
(顯示所選伺服器的擁有者。)
|
||
|
||
cm ^so ^item:samples\
|
||
(顯示所選項目規格的擁有者。)
|
||
|
||
== CMD_DESCRIPTION_SHOWPERMISSIONS ==
|
||
列出可用權限。
|
||
|
||
== CMD_USAGE_SHOWPERMISSIONS ==
|
||
用法：
|
||
|
||
cm ^showpermissions | ^sp
|
||
|
||
== CMD_HELP_SHOWPERMISSIONS ==
|
||
範例：
|
||
|
||
cm ^showpermissions
|
||
|
||
== CMD_DESCRIPTION_SHOWSELECTOR ==
|
||
顯示工作區選擇器。
|
||
|
||
== CMD_USAGE_SHOWSELECTOR ==
|
||
此命令已棄用。它的存在是為了回溯相容性，
|
||
但在 Unity VCS 4.0 中大多已棄用選擇器。選擇器仍
|
||
存在是為了指定工作分支或變更集，但舊規則
|
||
篩選路徑的功能已不再受到支援。
|
||
|
||
用法：
|
||
|
||
cm ^showselector | ^ss [<工作區_路徑> | <工作區_規格>]
|
||
|
||
工作區_路徑 要顯示選擇器的工作區路徑。
|
||
工作區_規格 工作區規格。(使用 'cm ^help ^objectspec' 以
|
||
深入瞭解工作區規格。)
|
||
|
||
== CMD_HELP_SHOWSELECTOR ==
|
||
備註：
|
||
|
||
如果未指定路徑或工作區規格，命令將以
|
||
目前目錄做為工作區路徑。
|
||
|
||
範例：
|
||
|
||
cm ^showselector c:\workspace
|
||
(顯示所選工作區路徑的選擇器。)
|
||
|
||
cm ^ss
|
||
(顯示目前工作區的選擇器。)
|
||
|
||
cm ^showselector > mySelector.txt
|
||
(將目前工作區的選擇器寫入檔案。)
|
||
|
||
cm ^showselector ^wk:mywk@reptest
|
||
(顯示 'reptest' 儲存庫中 'mywk' 工作區的選擇器。)
|
||
|
||
== CMD_DESCRIPTION_SUPPORT ==
|
||
可讓使用者執行支援相關作業。
|
||
|
||
== CMD_USAGE_SUPPORT ==
|
||
用法：
|
||
|
||
cm ^support <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^bundle
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^support <命令> --^usage
|
||
cm ^support <命令> --^help
|
||
|
||
== CMD_HELP_SUPPORT ==
|
||
範例：
|
||
|
||
cm ^support
|
||
cm ^support ^bundle
|
||
cm ^support ^bundle c:\outputfile.zip
|
||
|
||
== CMD_DESCRIPTION_SUPPORT_BUNDLE ==
|
||
建立含有相關記錄的「支援組合」套件。
|
||
您可以在要求協助、索取額外資訊或
|
||
提交錯誤時附加檔案。
|
||
|
||
== CMD_USAGE_SUPPORT_BUNDLE ==
|
||
用法：
|
||
|
||
cm ^support ^bundle [<輸出檔案>]
|
||
|
||
選項：
|
||
|
||
輸出檔案 在指定的位置
|
||
建立「支援組合」套件。
|
||
|
||
== CMD_HELP_SUPPORT_BUNDLE ==
|
||
備註：
|
||
|
||
此命令可讓使用者建立「支援組合」套件，以便
|
||
在要求協助、索取額外資訊或提交錯誤時附加。
|
||
使用者可選擇是否要指定輸出檔案的位置；如果未指定，
|
||
輸出檔案將寫入暫存目錄。
|
||
|
||
範例：
|
||
|
||
cm ^support ^bundle
|
||
(在暫存目錄中建立「支援組合」。)
|
||
|
||
cm ^support ^bundle c:\outputfile.zip
|
||
(在指定的位置建立「支援組合」。)
|
||
|
||
== CMD_DESCRIPTION_SWITCH ==
|
||
將工作區切換至分支、變更集、標籤或擱置集。
|
||
|
||
== CMD_USAGE_SWITCH ==
|
||
用法：
|
||
|
||
cm ^switch (<分支規格> | <變更及規格> | <標籤規格> | <擱置集規格>)
|
||
[--^workspace=<路徑>] [--^repository=<名稱>]
|
||
[--^forcedetailedprogress]
|
||
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解分支、變更集、標籤
|
||
和擱置集規格。)
|
||
|
||
選項：
|
||
|
||
--^workspace 工作區所在位置的路徑。
|
||
--^repository 切換至指定儲存庫。
|
||
--^forcedetailedprogress 強制顯示詳細進度，即使在標準輸出
|
||
重新導向的情況下亦然。
|
||
|
||
== CMD_HELP_SWITCH ==
|
||
備註：
|
||
|
||
此命令可讓使用者將工作區樹更新為指定物件
|
||
(分支、標籤、擱置集或變更集) 的內容。
|
||
|
||
範例：
|
||
|
||
cm ^switch ^br:/main
|
||
cm ^switch ^lb:Rel1.1
|
||
cm ^switch ^br:/main/scm002 --^repository=rep2
|
||
cm ^switch ^cs:4375
|
||
cm ^switch ^sh:2
|
||
|
||
== CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
|
||
將分支設定為工作分支。
|
||
|
||
== CMD_USAGE_SWITCH_TO_BRANCH ==
|
||
此命令已棄用。請改用 cm 切換。
|
||
|
||
用法：
|
||
|
||
cm ^switchtobranch [選項] [分支_規格]
|
||
|
||
分支_規格：分支規格。
|
||
|
||
選項：
|
||
|
||
--^label=名稱 | --^changeset=數字：從指定的標籤或變更集
|
||
載入修訂。如果未指定分支_規格，則需要
|
||
下列其中一個選項。
|
||
--^changeset=變更集：切換至指定的變更集。
|
||
--^repository=儲存庫：切換至指定的儲存庫。
|
||
--^workspace | -工作區=路徑：工作區所在位置的路徑。
|
||
|
||
== CMD_HELP_SWITCH_TO_BRANCH ==
|
||
備註：
|
||
|
||
此命令可讓使用者在分支中工作。
|
||
如果未指定分支_規格，則必須指定標籤或變更集。
|
||
如果未指定儲存庫，分支則會設定為目前儲存庫。
|
||
|
||
範例：
|
||
|
||
cm ^switchtobranch ^br:/main
|
||
cm ^switchtobranch ^br:/main/task001
|
||
|
||
cm ^switchtobranch --^label=BL050
|
||
(唯讀組態。此命令會載入已標示
|
||
變更集的內容。)
|
||
|
||
== CMD_DESCRIPTION_SYNC ==
|
||
與 Git 同步。
|
||
|
||
== CMD_USAGE_SYNC ==
|
||
用法：
|
||
|
||
cm ^synchronize | ^sync <儲存庫規格> ^git [<url> [--^user=<使用者_名稱> --^pwd=<密碼>]]
|
||
[(--^txtsimilaritypercent | --^binsimilaritypercent | \
|
||
--^dirsimilaritypercent)=<值>]
|
||
[--^author] [--^skipgitlfs]
|
||
|
||
|
||
儲存庫規格 儲存庫規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解儲存庫規格。)
|
||
git (預設)。
|
||
|
||
選項：
|
||
|
||
url 遠端儲存庫 URL (http(s):// 或 git:// 或
|
||
SSH URL)。
|
||
--^user 指定 URL 的使用者名稱。
|
||
--^pwd 指定 URL 的密碼。
|
||
--^txtsimilaritypercent \
|
||
--^binsimilaritypercent \
|
||
--^dirsimilaritypercent
|
||
可偵測已移動的項目，與 Unity VCS
|
||
GUI 的方式相同。
|
||
--^author 使用 git 作者的名稱和時間戳記值。
|
||
(預設為 git 提交者)
|
||
--^skipgitlfs 忽略
|
||
.gitattributes 檔案中的 Git LFS 組態。它的功能與沒有 Git LFS
|
||
支援的情況類似。
|
||
|
||
== CMD_HELP_SYNC ==
|
||
備註：
|
||
|
||
如果 git 儲存庫要求輸入使用者和密碼，則請使用 '^url'、'--^user'
|
||
和 '--^pwd' 選項。
|
||
如果 git 儲存庫未要求輸入使用者和密碼，則請將 '^url'
|
||
選項與第一個同步作業搭配使用。對於後續同步作業，'^url'
|
||
為選用選項。
|
||
|
||
若要使用 SSH 通訊協定執行同步作業，您必須將「ssh」用戶端
|
||
新增至 PATH 環境變數並正確地設定，才能連線至
|
||
遠端主機 (亦即已設定私密/公開金鑰)。
|
||
|
||
範例：
|
||
|
||
cm ^sync default@localhost:8087 ^git git://localhost/repository
|
||
|
||
== CMD_DESCRIPTION_TRIGGER ==
|
||
可讓使用者管理觸發器。
|
||
|
||
== CMD_USAGE_TRIGGER ==
|
||
用法：
|
||
|
||
cm ^trigger | ^tr <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^edit
|
||
^list | ^ls
|
||
^showtypes
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^trigger <命令> --^usage
|
||
cm ^trigger <命令> --^help
|
||
|
||
== CMD_HELP_TRIGGER ==
|
||
範例：
|
||
|
||
cm ^tr ^mk ^before-mklabel new "/path/to/script" --^server=myserver:8084
|
||
cm ^tr ^edit ^before-mklabel 7 --^position=4 --^server=myserver:8084
|
||
cm ^tr ^ls ^before-mkbranch --^server=myserver:8084
|
||
cm ^tr ^rm ^after-setselector 4
|
||
cm ^tr ^showtypes
|
||
|
||
== CMD_DESCRIPTION_UNDOCHECKOUT ==
|
||
復原項目簽出。
|
||
|
||
== CMD_USAGE_UNDOCHECKOUT ==
|
||
用法：
|
||
|
||
cm ^undocheckout | ^unco <項目_路徑>[ ...][-^a | --^all] [--^symlink] [--^silent]
|
||
[--^machinereadable [--^startlineseparator=<分隔符號>]
|
||
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
|
||
|
||
項目_路徑 要套用作業的項目。使用空格分隔
|
||
路徑。使用雙引號 (" ") 指定含空格的
|
||
路徑。
|
||
使用 . 將作業套用至目前目錄。
|
||
|
||
選項：
|
||
|
||
-^a | --^all 復原指定項目中的所有變更。如果
|
||
項目已簽出，則會還原
|
||
簽出。如果項目已在本地修改，則會
|
||
還原修改。
|
||
--^symlink 將復原簽出作業套用至連結，而非
|
||
套用至目標。
|
||
--^silent 不顯示任何輸出。
|
||
--^machinereadable 以易於剖析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定各行應如何起始。
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定各行應如何結束。
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定應如何分隔欄位。
|
||
|
||
== CMD_HELP_UNDOCHECKOUT ==
|
||
備註：
|
||
|
||
如果項目已簽出，而且您不想將其簽入，您可以使用此命令復原
|
||
簽出。檔案和資料夾皆可取消
|
||
簽出。項目將更新為簽出前的狀態。
|
||
|
||
要求：
|
||
- 項目必須受原始程式碼控制。
|
||
- 必須簽出項目。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
'^undocheckout' 命令可從 stdin 讀取路徑。若要執行此操作，可
|
||
傳遞單一破折號「-」來完成。
|
||
範例：cm ^undocheckout ^checkin -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線指定要復原簽出的檔案。
|
||
範例：
|
||
dir /S /B *.c | cm ^undocheckout --^all -
|
||
(在 Windows 中，復原工作區中所有 .c 檔案的簽出。)
|
||
|
||
範例：
|
||
|
||
cm ^undocheckout .
|
||
(復原目前目錄中的簽出。)
|
||
|
||
cm ^undocheckout file1.txt file2.txt
|
||
cm unco c:\workspace\file.txt
|
||
(復原所選檔案的簽出。)
|
||
|
||
cm ^unco -^a file1.txt
|
||
(復原 'file1.txt' 的簽出或本地修改)
|
||
|
||
cm ^unco 連結 --^symlink
|
||
(將復原簽出作業套用至連結檔案，而不是套用至目標；
|
||
此功能適用於 UNIX 環境。)
|
||
|
||
cm ^status --^short --^changelist=暫止_待_檢閱 | cm ^undocheckout -
|
||
(復原用戶端變更清單。
|
||
以上命令會列出名為
|
||
'暫止_待_檢閱' 變更清單中的路徑，且此路徑清單會重新導向至
|
||
復原簽出命令的輸入。)
|
||
|
||
cm ^unco .--^machinereadable
|
||
(復原目前目錄中的簽出，並以
|
||
簡化、易於剖析的格式列印結果。)
|
||
|
||
cm ^unco .--^machinereadable --^startlineseparator=">" --^endlineseparator="<" \
|
||
--^fieldseparator=","
|
||
(復原目前目錄中的簽出，並以簡化且易於剖析的格式
|
||
列印結果、起始行和結尾行，以及使用
|
||
指定的字串來分隔欄位。)
|
||
|
||
== CMD_DESCRIPTION_UNDOCHECKOUTUNCHANGED ==
|
||
復原未變更的已簽出項目。
|
||
|
||
== CMD_USAGE_UNDOCHECKOUTUNCHANGED ==
|
||
用法：
|
||
|
||
cm ^uncounchanged | ^unuc <項目_路徑>[ ...][-^R | -^r | --^recursive]
|
||
[--^symlink] [--^silent]
|
||
|
||
項目_路徑 要套用作業的項目。使用空格分隔
|
||
路徑。使用雙引號 (" ") 指定含空格的
|
||
路徑。
|
||
使用 . 將作業套用至目前目錄。
|
||
|
||
選項：
|
||
|
||
-^R 以遞迴方式復原指定路徑中未變更的項目。
|
||
--^symlink 將復原簽出未變更的作業套用至連結，而不是
|
||
套用至目標。
|
||
--^silent 不顯示任何輸出。
|
||
|
||
== CMD_HELP_UNDOCHECKOUTUNCHANGED ==
|
||
備註：
|
||
|
||
此命令會從工作區根目錄以遞迴的方式套用。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
'^uncounchanged' 命令可從 stdin 讀取路徑。若要執行此操作，可
|
||
傳遞單一破折號「-」來完成。
|
||
範例：cm ^uncounchanged -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線指定要復原簽出的未變更
|
||
檔案。
|
||
範例：
|
||
dir /S /B *.c | cm ^uncounchanged -
|
||
(在 Windows 中，復原工作區中所有未變更 .c 檔案上的
|
||
簽出。)
|
||
|
||
範例：
|
||
|
||
cm ^uncounchanged .-^R
|
||
(在目前目錄上以遞迴方式復原未變更檔案的簽出。)
|
||
|
||
cm ^unuc /首頁/我的使用者/我的工作區/專案/範本 -^R
|
||
(在所選目錄上以遞迴方式復原未變更檔案的簽出。)
|
||
|
||
== CMD_DESCRIPTION_UNDELETE ==
|
||
取消刪除使用特定修訂的項目。
|
||
|
||
== CMD_USAGE_UNDELETE ==
|
||
用法：
|
||
|
||
cm ^undelete <修訂規格> <路徑>
|
||
|
||
修訂規格 將在工作區中載入之內容的
|
||
修訂的規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解修訂規格。)
|
||
路徑 還原路徑。
|
||
|
||
== CMD_HELP_UNDELETE ==
|
||
備註：
|
||
|
||
要取消刪除的項目不應已載入工作區中。
|
||
|
||
xlink 不支援 '^undelete' 作業。
|
||
|
||
範例：
|
||
|
||
cm ^undelete ^revid:756 C:\mywks\src\foo.c
|
||
cm ^undelete ^itemid:68#^cs:2 C:\mywks\dir\myfile.pdf
|
||
cm ^undelete ^serverpath:/src#^br:/main C:\mywks\Dir
|
||
|
||
== CMD_DESCRIPTION_UNDOCHANGE ==
|
||
復原路徑上的變更。
|
||
|
||
== CMD_USAGE_UNDOCHANGE ==
|
||
用法：
|
||
|
||
cm ^undochange | ^unc <項目_路徑>[ ...][-^R | -^r | --^recursive]
|
||
|
||
項目_路徑 要套用作業的項目。使用空格分隔
|
||
路徑。使用雙引號 (" ") 指定含空格的
|
||
路徑。
|
||
使用 . 將作業套用至目前目錄。
|
||
|
||
選項：
|
||
|
||
-^R 以遞迴的方式套用作業。
|
||
|
||
== CMD_HELP_UNDOCHANGE ==
|
||
備註：
|
||
|
||
如果項目已簽出或修改，但未簽入，而且您不想
|
||
將其簽入，您可以使用此命令復原變更。項目
|
||
將更新為之前的內容。
|
||
|
||
從 stdin 讀取輸入：
|
||
|
||
'^undochange' 命令可從 stdin 讀取路徑。若要執行此操作，可
|
||
傳遞單一破折號「-」來完成。
|
||
範例：cm ^undochange -
|
||
|
||
將讀取路徑，直到輸入空白行為止。
|
||
這可讓您使用管線指定要復原變更的檔案。
|
||
範例：
|
||
dir /S /B *.c | cm ^undochange -
|
||
(在 Windows 中，復原工作區中所有 .c 檔案的變更。)
|
||
|
||
範例：
|
||
|
||
cm ^unc .
|
||
(復原目前目錄上的檔案變更。)
|
||
|
||
cm ^undochange .-^R
|
||
(以遞迴方式復原目前目錄上的檔案變更。)
|
||
|
||
cm ^unc file1.txt "file 2.txt"
|
||
(復原所選檔案的變更。)
|
||
|
||
cm ^unc c:\workspace\file.txt
|
||
(復原所選檔案的變更。)
|
||
|
||
== CMD_DESCRIPTION_UNDO ==
|
||
復原工作區中的變更。
|
||
|
||
== CMD_USAGE_UNDO ==
|
||
用法：
|
||
|
||
cm ^undo [<路徑>[ ...]] [--^symlink] [-^r | --^recursive] [<篩選>[ ...]]
|
||
[--^silent | --^machinereadable [--^startlineseparator=<分隔符號>]
|
||
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
|
||
|
||
路徑 要套用作用的目標檔案或目錄的
|
||
路徑。使用雙引號 (" ") 指定含空格的
|
||
路徑。使用空格分隔路徑。
|
||
如果未指定路徑，復原作業預設會
|
||
使用目前目錄中的
|
||
所有檔案。
|
||
篩選 將指定的一或多個篩選套用至指定的
|
||
路徑。使用空格分隔篩選。如需詳細資訊，請參閱
|
||
＜篩選＞一節。
|
||
|
||
選項：
|
||
|
||
--^symlink 將復原作業套用至符號連結，而不是
|
||
套用至目標。
|
||
-^r 以遞迴方式執行復原。
|
||
--^silent 不顯示任何輸出。
|
||
--^machinereadable 以易於剖析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何起始。
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
各行應如何結束。
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，指定
|
||
應如何分隔欄位。
|
||
篩選：
|
||
|
||
如果未指定標誌，會依預設復原所有變更，但
|
||
可使用下列一或多個標誌篩選路徑。
|
||
如果檔案或目錄符合一或多個指定的變更類型，
|
||
將會復原所述之檔案或目錄上的所有變更。
|
||
例如，如果您指定 '--^checkedout' 和 '--^moved'，若檔案
|
||
已簽出且移動，則會復原這兩項變更。
|
||
|
||
--^checkedout 選取已簽出的檔案和目錄。
|
||
--^unchanged 選取未變更內容的檔案。
|
||
--^changed 選取已本地變更或簽出的檔案和
|
||
目錄。
|
||
--^deleted 選取已刪除的檔案和目錄。
|
||
--^moved 選取已移動的檔案和目錄。
|
||
--^added 選取已新增的檔案和目錄。
|
||
|
||
== CMD_HELP_UNDO ==
|
||
備註：
|
||
|
||
'^undo' 命令具有危險性 - 它會以無法回復的方式復原工作。
|
||
^undo 作業完成後，則無法復原受其影響的檔案和
|
||
目錄的先前狀態。如果未在引數中
|
||
指定路徑，預設將復原目前目錄中的所有變更，
|
||
但不是以遞迴方式進行。
|
||
這些等同於從 /src 目錄執行：
|
||
|
||
/src
|
||
|- file.txt
|
||
|- code.cs
|
||
\- /test
|
||
|- test_a.py
|
||
\- test_b.py
|
||
|
||
cm ^undo
|
||
cm ^undo *
|
||
cm ^undo file.txt code.cs /test
|
||
|
||
cm ^undo .
|
||
cm ^undo /src file.txt code.cs
|
||
|
||
若要以遞迴的方式進行作業，您必須指定 '-^r' 標誌。
|
||
|
||
復原目錄下的所有變更 (包括影響到
|
||
目錄本身的變更)：
|
||
|
||
cm ^undo 目錄路徑 -^r
|
||
|
||
如果目錄路徑是工作區路徑，將會復原工作區中的
|
||
所有變更。
|
||
|
||
已刪除的項目：
|
||
|
||
若要復原檔案和目錄刪除作業，您必須指定項目的
|
||
完整路徑，或指定包含的目錄並使用遞迴 ('-^r')
|
||
標誌。
|
||
|
||
例如：
|
||
|
||
cm ^undo .
|
||
(不復原目前目錄中的刪除作業。)
|
||
|
||
cm ^undo .-^r
|
||
(以遞迴方式復原目前目錄中的所有刪除作業 (和其他變更)。)
|
||
|
||
cm ^undo src/file.txt
|
||
(復原 src/file.txt 的刪除作業 (或其他變更)。)
|
||
|
||
範例：
|
||
|
||
cm ^undo .-^r
|
||
(以遞迴方式復原目前目錄中的所有變更。如果已從
|
||
工作區的根目錄執行，則會復原整個工作區中的所有變更。)
|
||
|
||
cm ^co file.txt
|
||
cm ^undo file.txt
|
||
(在 'file.txt' 上復原簽出。)
|
||
|
||
^echo ^content >> file.txt
|
||
cm ^undo file.txt
|
||
(復原 'file.txt' 的本地變更。)
|
||
|
||
cm ^undo src
|
||
(復原 src 目錄及其檔案的變更。)
|
||
|
||
cm ^undo src/*
|
||
(復原 src 中包含的所有檔案和目錄的變更，而
|
||
完全不影響 src。)
|
||
|
||
cm ^undo *.cs
|
||
(復原符合目前目錄中 *.cs 的
|
||
所有檔案或目錄的變更。)
|
||
|
||
cm ^undo *.cs -^r
|
||
(復原符合目前目錄及其底下所有目錄中 *.cs 的
|
||
所有檔案或目錄的變更。)
|
||
|
||
cm ^co file1.txt file2.txt
|
||
^echo ^content >> file1.txt
|
||
cm ^undo --^unchanged
|
||
(復原未變更 'file2.txt' 的簽出，進而忽略本地變更的
|
||
'file1.txt'。)
|
||
|
||
^echo ^content >> file1.txt
|
||
^echo ^content >> file2.txt
|
||
cm ^co file1.txt
|
||
cm ^undo --^checkedout
|
||
(復原已簽出檔案 'file1.txt' 中的變更，進而忽略 'file2.txt'，因為
|
||
這個檔案並未簽出。)
|
||
|
||
cm ^add file.txt
|
||
cm ^undo file.txt
|
||
(復原新增 'file.txt' 的動作，進而使其再次成為私人檔案。)
|
||
|
||
^rm file1.txt
|
||
^echo ^content >> file2.txt
|
||
cm ^add file3.txt
|
||
cm ^undo --^deleted --^added *
|
||
(復原 'file1.txt' 刪除動作和 'file3.txt' 新增動作，而忽略 'file2.txt'
|
||
變更。)
|
||
|
||
== CMD_DESCRIPTION_LOCK_UNLOCK ==
|
||
復原鎖定伺服器上的項目鎖定。
|
||
|
||
== CMD_USAGE_LOCK_UNLOCK ==
|
||
用法：
|
||
|
||
cm ^lock ^unlock [<儲存庫伺服器規格>] <GUID>[ ...]
|
||
|
||
儲存庫伺服器規格 儲存庫伺服器規格。(使用 'cm ^help ^objectspec'
|
||
以深入瞭解儲存庫伺服器規格。)
|
||
GUID 要封鎖的 GUID 項目清單。使用空格
|
||
分隔 GUID。
|
||
|
||
== CMD_HELP_LOCK_UNLOCK ==
|
||
備註：
|
||
|
||
- 此命令會使用指定的伺服器來解除鎖定項目。
|
||
- 如果未指定伺服器，此命令會嘗試從目前工作區
|
||
取得伺服器。
|
||
- 如果未在上述步驟中計算伺服器，則會從目前 Unity VCS
|
||
用戶端組態取得伺服器。
|
||
- 只有伺服器管理員才能執行 'cm ^unlock' 命令。
|
||
- 若要指定 GUID，格式應為 32 位數並以連字號格式
|
||
分隔 (可選擇是否要加上括號)：
|
||
|
||
{00000000-0000-0000-0000-000000000000}
|
||
或 00000000-0000-0000-0000-000000000000
|
||
|
||
範例：
|
||
|
||
cm ^lock ^unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
|
||
(復原所選項目鎖定。)
|
||
|
||
cm ^lock ^unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 \
|
||
bcb98a61-2f62-4309-9a26-e21a2685e075
|
||
(復原名為 'DIGITALIS' 的鎖定伺服器上所選的項目鎖定。)
|
||
|
||
cm ^lock ^unlock tardis@cloud 4740c4fa-56af-3dfe-de10-8711fa248635 \
|
||
71263c17-5eaf-5271-4d2c-a25f72e101d4
|
||
(復原名為 'tardis' 的雲端鎖定伺服器上所選的項目鎖定。)
|
||
|
||
== CMD_DESCRIPTION_UPDATE ==
|
||
更新工作區並下載最新變更。
|
||
|
||
== CMD_USAGE_UPDATE ==
|
||
用法：
|
||
|
||
cm ^update [<項目_路徑> | --^last]
|
||
[--^changeset=<變更集規格>] [--^cloaked] [--^dontmerge] [--^forced]
|
||
[--^ignorechanges] [--^override] [--^recursewk] [--^skipchangedcheck]
|
||
[--^silent] [--^verbose] [--^xml[=<輸出_檔案>]] [--^encoding=<名稱>]
|
||
[--^machinereadable [--^startlineseparator=<分隔符號>]
|
||
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
|
||
[--^forcedetailedprogress]
|
||
|
||
項目_路徑 要更新的路徑。
|
||
使用 . 將更新套用至目前目錄。
|
||
如果未指定路徑，則會完全更新
|
||
目前工作區。
|
||
--^last 進行更新前，將工作區選擇器從變更集
|
||
組態或標籤組態變更為
|
||
分支組態。
|
||
選擇器已變更為變更集或
|
||
標籤所屬的分支。
|
||
|
||
選項：
|
||
|
||
--^changeset 將工作區更新為特定變更集。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解
|
||
變更集規格。)
|
||
--^cloaked 包含更新作業中的隱匿項目。
|
||
如果未指定此選項，將會在作業中忽略這些
|
||
隱匿的項目。
|
||
--^dontmerge 萬一更新作業期間需要更新合併，
|
||
則不會執行合併。
|
||
--^forced 將項目強制更新至選擇器中
|
||
指定的修訂。
|
||
--^ignorechanges 如果在更新工作區時偵測到
|
||
暫止的變更，則忽略顯示的
|
||
暫止變更警告訊息。
|
||
--^override 覆寫 Unity VCS 控制範圍外的已變更檔案。
|
||
將以伺服器內容
|
||
覆寫其內容。
|
||
--^recursewk 更新目前路徑內找到的
|
||
所有工作區。可用來更新指定路徑中
|
||
包含的所有工作區。
|
||
--^skipchangedcheck 開始前，更新會先檢查工作區中是否有
|
||
本地變更。如果您總是在修改檔案前
|
||
簽出，您可以使用此檢查功能並
|
||
加快作業的速度。
|
||
--^silent 不顯示任何輸出。
|
||
--^verbose 顯示其他資訊。
|
||
--^xml 將 XML 格式的輸出列印至標準輸出。
|
||
可以指定輸出檔案。
|
||
--^encoding 與 --^xml 選項搭配使用，指定要在 XML 輸出中
|
||
使用的編碼，亦即：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^machinereadable 以易於剖析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定各行應如何起始。
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定各行應如何結束。
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定應如何分隔欄位。
|
||
--^forcedetailedprogress 強制顯示詳細進度，即使在標準輸出
|
||
重新導向的情況下亦然。
|
||
== CMD_HELP_UPDATE ==
|
||
備註：
|
||
|
||
'^update' 命令只會下載所需的檔案。
|
||
|
||
此命令應該會執行遞迴作業。
|
||
|
||
使用 '--^last' 選項時，不需要指定路徑。
|
||
在此情況下，將更新目前工作目錄所屬的
|
||
工作區。
|
||
(請切記，如果選擇器先前指向變更集或標籤，指定此標誌
|
||
可能會導致工作區選擇器變更為
|
||
分支組態。)
|
||
|
||
|
||
範例：
|
||
|
||
cm ^update
|
||
(更新目前工作區中的所有項目。)
|
||
|
||
cm ^update .
|
||
(更新目前目錄以及所有下層項目。)
|
||
|
||
cm ^update .--^forced --^verbose
|
||
(強制擷取所有修訂。)
|
||
|
||
cm ^update --^last
|
||
|
||
cm ^update .--^machinereadable --^startlineseparator=">"
|
||
(更新目前目錄並以簡化、
|
||
易於剖析的格式列印結果，使用指定的
|
||
字串起始行。)
|
||
|
||
== CMD_DESCRIPTION_VERSION ==
|
||
顯示目前用戶端版本號碼。
|
||
|
||
== CMD_USAGE_VERSION ==
|
||
用法：
|
||
|
||
cm ^version
|
||
|
||
== CMD_HELP_VERSION ==
|
||
|
||
== CMD_DESCRIPTION_WHOAMI ==
|
||
顯示目前的 Unity VCS 使用者。
|
||
|
||
== CMD_USAGE_WHOAMI ==
|
||
用法：
|
||
|
||
cm ^whoami
|
||
|
||
== CMD_HELP_WHOAMI ==
|
||
|
||
== CMD_USAGE_WKTREENODESTATUS ==
|
||
用法：
|
||
|
||
cm ^wktreenodestatus 路徑 1, 路徑 2, ...
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE ==
|
||
可讓使用者管理工作區。
|
||
|
||
== CMD_USAGE_WORKSPACE ==
|
||
用法：
|
||
|
||
cm ^workspace | ^wk <命令> [選項]
|
||
|
||
命令：
|
||
|
||
^list | ^ls
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^move | ^mv
|
||
^rename
|
||
|
||
若要取得每個命令的詳細資訊，請執行：
|
||
cm ^workspace <命令> --^usage
|
||
cm ^workspace <命令> --^help
|
||
|
||
== CMD_HELP_WORKSPACE ==
|
||
範例：
|
||
|
||
cm ^workspace ^create myWorkspace 工作區_路徑
|
||
cm ^workspace ^list
|
||
cm ^workspace ^delete myWorkspace
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_CREATE ==
|
||
建立新工作區。
|
||
|
||
== CMD_USAGE_WORKSPACE_CREATE ==
|
||
用法：
|
||
|
||
cm ^workspace | ^wk [^create | ^mk] <工作區_名稱> <工作區_路徑> [<儲存庫_規格>]
|
||
[--^selector[=<選擇器_檔案>]
|
||
(建立新工作區。)
|
||
|
||
cm ^workspace | ^wk [^create | ^mk] <工作區_名稱> <工作區_路徑> --^dynamic --^tree=[<樹狀目錄>]
|
||
(建立動態工作區。此功能仍屬實驗性質，且
|
||
僅適用於 Windows。)
|
||
|
||
工作區_名稱 新工作區名稱。
|
||
工作區_路徑 新工作區的路徑。
|
||
儲存庫_規格 使用指定的儲存庫建立新工作區。
|
||
儲存庫規格：查看 'cm ^help ^objectspec'。
|
||
|
||
選項：
|
||
|
||
--^selector 編輯新工作區的選擇器。
|
||
如果已指定選擇器檔案，則會從指定的檔案設定
|
||
新工作區的選擇器。
|
||
--^dynamic 建立動態工作區。此功能仍屬
|
||
實驗性質，且僅適用於 Windows。
|
||
指定此標誌需要使用 --^tree 參數。
|
||
--^tree 與 '--^dynamic' 標誌搭配使用，指定
|
||
動態工作區即將進行載入的初始點。這可為
|
||
分支、變更集或標籤規格。
|
||
工作區稍後將使用規格中的
|
||
儲存庫。(使用 'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
== CMD_HELP_WORKSPACE_CREATE ==
|
||
備註：
|
||
|
||
- 工作區是對應至本地檔案系統之儲存庫的檢視畫面。
|
||
工作區選擇器會定義指定工作區內容的規則。
|
||
使用 'cm ^showselector' 顯示工作區選擇器，或使用 'cm ^setselector'
|
||
進行修改。
|
||
- 如果未指定 '儲存庫_規格' 或 '--^selector''，則會自動將工作區
|
||
設定為使用 client.conf 檔案中已設定之伺服器的第一個儲存庫
|
||
(依字母順序)。
|
||
- 動態工作區是實驗性質的功能 (僅限 Windows)，且
|
||
需要執行 plasticfs.exe 程式。
|
||
|
||
範例：
|
||
|
||
cm ^workspace ^create myworkspace c:\workspace
|
||
cm ^wk ^mk myworkspace /home/john/plastic_view
|
||
(分別在 Windows 和 Linux 中建立 'myworkspace' 工作區。)
|
||
|
||
cm ^wk mywktest c:\wks\wktest --^selector=myselector.txt
|
||
(使用 'myselector.txt' 檔案中的選擇器，建立 'mywktest' 工作區。)
|
||
|
||
cm ^wk mywkprj c:\wks\wkprj myrep@^repserver:localhost:8084
|
||
(使用所選儲存庫建立 'mywkprj' 工作區。)
|
||
|
||
cm ^wk mywkprj c:\dynwks\mywkprj --^dynamic --^tree=^br:/main@myrep@localhost:8084
|
||
(使用 'myrep@localhost:8084'
|
||
儲存庫建立動態 'mywkprj' 工作區，在第一次裝載時指向 '^br:/main'。)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_DELETE ==
|
||
刪除工作區。
|
||
|
||
== CMD_USAGE_WORKSPACE_DELETE ==
|
||
用法：
|
||
|
||
cm ^workspace | ^wk ^delete | ^rm [<工作區_路徑> | <工作區規格>] [--^keepmetadata]
|
||
|
||
工作區_路徑 要刪除的工作區路徑。
|
||
工作區規格 要刪除的工作區規格。(使用
|
||
'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
|
||
選項:
|
||
|
||
--^keepmetadata 不會刪除 .plastic
|
||
資料夾中的中繼資料檔案。
|
||
|
||
== CMD_HELP_WORKSPACE_DELETE ==
|
||
備註：
|
||
|
||
此命令會刪除路徑或規格所指定的工作區。
|
||
如果未指定引數，將直接使用目前工作區。
|
||
|
||
範例：
|
||
|
||
cm ^workspace ^delete
|
||
(移除目前工作區。)
|
||
|
||
cm ^wk ^delete c:\workspace
|
||
cm ^workspace rm /home/danipen/wks
|
||
cm ^wk ^rm ^wk:MiWorkspace
|
||
cm ^wk ^rm ^wk:MiWorkspace@DIGITALIS
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_LIST ==
|
||
列出工作區。
|
||
|
||
== CMD_USAGE_WORKSPACE_LIST ==
|
||
用法：
|
||
|
||
cm ^workspace | ^wk [^list | ^ls] [--^format=<字串_格式>]
|
||
|
||
選項：
|
||
|
||
--^format 以指定的格式擷取輸出訊息。如需
|
||
詳細資訊，請參閱備註。
|
||
|
||
== CMD_HELP_WORKSPACE_LIST ==
|
||
備註：
|
||
|
||
此命令接受格式字串以顯示輸出。
|
||
此命令的輸出參數如下所示：
|
||
|
||
{0} | {^wkname} 工作區名稱。
|
||
{1} | {^machine} 用戶端機器名稱。
|
||
{2} | {^path} 工作區路徑。
|
||
{3} | {^wkid} 工作區唯一識別碼。
|
||
{4} | {^wkspec} 使用此格式的工作區規格：
|
||
'wkname@machine'。
|
||
{^tab} 插入定位字元空格。
|
||
{^newline} 插入新行。
|
||
|
||
範例：
|
||
|
||
cm ^wk
|
||
(列出所有工作區。)
|
||
|
||
cm ^workspace ^list --^format={0}#{3,40}
|
||
cm ^workspace ^list --^format={^wkname}#{^wkid,40}
|
||
(列出所有工作區並顯示工作區名稱、# 符號和
|
||
40 個空格的工作區 GUID 欄位，靠左對齊。)
|
||
|
||
cm ^wk --^format="路徑 {2} 中的工作區 {0}"
|
||
cm ^wk --^format="路徑 {^path} 中的工作區 {^wkname}"
|
||
(列出所有工作區並以格式化字串的形式顯示結果。)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_MOVE ==
|
||
移動工作區。
|
||
|
||
== CMD_USAGE_WORKSPACE_MOVE ==
|
||
用法：
|
||
|
||
cm ^workspace | ^wk ^move | ^mv [<工作區規格>] <新_路徑>
|
||
|
||
選項：
|
||
|
||
工作區規格 要移動的工作區規格。(使用
|
||
'cm ^help ^objectspec' 以深入瞭解規格。)
|
||
新_路徑 將移動至此處的工作區。
|
||
|
||
== CMD_HELP_WORKSPACE_MOVE ==
|
||
備註：
|
||
|
||
此命令可讓使用者將工作區移動至磁碟上的另一個位置。
|
||
|
||
範例：
|
||
|
||
cm ^workspace ^move myWorkspace \new\workspaceDirectory
|
||
(將 'myWorkspace' 移動至指定的位置。)
|
||
|
||
cm ^wk ^mv c:\users\maria\wkspaces\newlocation
|
||
(將目前工作區移動至新位置。)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_RENAME ==
|
||
重新命名工作區。
|
||
|
||
== CMD_USAGE_WORKSPACE_RENAME ==
|
||
用法：
|
||
|
||
cm ^workspace | ^wk ^rename [<工作區_名稱>] <新_名稱>
|
||
|
||
工作區_名稱 要重新命名的工作區。
|
||
新_名稱 工作區的新名稱。
|
||
|
||
== CMD_HELP_WORKSPACE_RENAME ==
|
||
備註：
|
||
|
||
此命令會重新命名工作區。
|
||
如果未提供工作區名稱，則會使用目前工作區。
|
||
|
||
範例：
|
||
|
||
cm ^workspace ^rename mywk1 wk2
|
||
(將 'mywk1' 工作區重新命名為 'wk2'。)
|
||
|
||
cm ^wk ^rename 新名稱
|
||
(將目前工作區重新命名為 '新名稱'。)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACESTATUS ==
|
||
顯示工作區中的變更。
|
||
|
||
== CMD_USAGE_WORKSPACESTATUS ==
|
||
用法：
|
||
|
||
cm ^status [<工作區_路徑>] [--^changelist[=<名稱>] | --^changelists] [--^cutignored]
|
||
[ --^header] [ --^noheader] [ --^nomergesinfo] [ --^head]
|
||
[--^short] [--^symlink] [ --^dirwithchanges] [--^xml[=<輸出_檔案>]]
|
||
[--^encoding=<名稱>] [ --^wrp | --^wkrootrelativepaths]
|
||
[--^fullpaths | --^fp] [<舊版_選項>] [<搜尋_類型>[ ...]]
|
||
[--^machinereadable [--^startlineseparator=分隔符號]
|
||
[--^endlineseparator=分隔符號] [--^fieldseparator=分隔符號]]
|
||
|
||
選項：
|
||
|
||
工作區_路徑 將執行搜尋之工作區的
|
||
路徑。
|
||
--^changelist 顯示所選變更清單中的變更。
|
||
--^changelists 顯示用戶端變更清單中的分組變更。
|
||
--^cutignored 跳過已忽略目錄的內容。
|
||
需要 '--^ignored' 搜尋類型。如需詳細資訊，請參閱＜搜尋
|
||
類型＞一節。
|
||
--^header 只列印工作區狀態。
|
||
--^noheader 只列印已修改的項目搜尋結果。
|
||
--^nomergesinfo 不列印變更的合併資訊。
|
||
--^head 列印分支上最後一個變更集的狀態。
|
||
--^short 只列出包含變更的路徑。
|
||
--^symlink 將作業套用至符號連結，而不是套用至
|
||
目標。
|
||
--^dirwithchanges 顯示其中包含變更的目錄
|
||
(其中的已新增、已移動和已移除項目)。
|
||
--^xml 將 XML 格式的輸出列印至標準輸出。
|
||
可以指定輸出檔案。
|
||
--^pretty Prints workspace changes in a nice table format.
|
||
--^encoding 與 --^xml 選項搭配使用，指定要在 XML 輸出中
|
||
使用的編碼，亦即：utf-8。
|
||
請參閱 MSDN 文件 (網址為
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
)，以取得可支援之編碼及其格式的表格
|
||
(在頁尾的 [名稱] 欄中)。
|
||
--^wrp 列印工作區根目錄相對路徑，而非
|
||
目前目錄相對路徑。
|
||
--^fullpaths, --^fp 強制列印絕對路徑，覆寫任何其他
|
||
路徑列印設定。
|
||
--^machinereadable 以易於剖析的格式輸出結果。
|
||
--^startlineseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定各行應如何起始。
|
||
--^endlineseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定各行應如何結束。
|
||
--^fieldseparator 搭配 '--^machinereadable' 標誌使用，
|
||
指定應如何分隔欄位。
|
||
|
||
舊版選項：
|
||
|
||
--^cset 以舊版格式列印工作區狀態。
|
||
--^compact 以舊版格式列印工作區狀態和
|
||
變更清單。
|
||
--^noheaders 與 '--^compact' 標誌搭配使用時，
|
||
不會列印變更清單。(不會套用
|
||
至新變更清單格式。)
|
||
|
||
搜尋類型：
|
||
|
||
--^added 列印已新增的項目。
|
||
--^checkout 列印已簽出的項目。
|
||
--^changed 列印已變更的項目。
|
||
--^copied 列印已複製的項目。
|
||
--^replaced 列印已取代的項目。
|
||
--^deleted 列印已刪除的項目。
|
||
--^localdeleted 列印已在本地刪除的項目。
|
||
--^moved 列印已移動的項目。
|
||
--^localmoved 列印已在本地移動的項目。
|
||
--^percentofsimilarity=<值> 若要將兩個檔案視為相同項目，兩個檔案之間的
|
||
相似性百分比。可用於
|
||
已在本地移動的搜尋。其預設
|
||
值為 20%。
|
||
--^txtsameext 在已移動項目搜尋期間，
|
||
相似性內容比對程序
|
||
只會將具有相同副檔名的
|
||
文字檔案納入考量。根據預設，將處理所有
|
||
文字檔案。
|
||
--^binanyext 在已移動項目搜尋期間，
|
||
相似性內容比對程序
|
||
會將所有二進位檔案納入考量。根據預設，
|
||
只會處理具有相同
|
||
副檔名的二進位檔案。
|
||
--^private 列印非受控項目。
|
||
--^ignored 列印已忽略的項目。
|
||
--^hiddenchanged 列印隱藏的已變更項目。(包括
|
||
'--^changed')
|
||
--^cloaked 列印已隱匿的項目。
|
||
--^controlledchanged 此標誌會替代下列選項：
|
||
'--^added'、'--^checkout'、'--^copied'、
|
||
'--^replaced'、'--^deleted'、'--^moved'。
|
||
--^all 此標誌會取代下列參數：
|
||
'--^controlledchanged'、'--^changed'、
|
||
'--^localdeleted'、'--^localmoved'、'--^private'。
|
||
|
||
== CMD_HELP_WORKSPACESTATUS ==
|
||
備註：
|
||
|
||
'^status' 命令會列印工作區上已載入的變更集，並取得
|
||
工作區內已變更的元素。
|
||
|
||
此命令可用來顯示工作區中暫止的變更；
|
||
可使用命令參數搜尋和修改的
|
||
變更類型。預設會顯示所有變更，無論是受控
|
||
或本地變更。
|
||
|
||
已在本地移動的搜尋可使用相似性百分比參數 '--^percentofsimilarity' (-^p)，
|
||
決定兩個元素是否為相同的項目。
|
||
預設值為 20%，但您可調整此值。
|
||
|
||
可以顯示依用戶端變更清單分組的工作區變更。
|
||
'^default' 變更清單包含
|
||
其他變更清單中未包含的變更。也就是說，預設變更清單顯示的內容
|
||
將取決於指定的搜尋類型標誌。
|
||
|
||
若要顯示依變更清單分組的變更，則也需要顯示
|
||
受控變更 (狀態等於 '^added'、'^checkout'、'^copied'、
|
||
'^replaced'、'^deleted' 或 '^moved' 的項目)。因此，顯示變更清單時，
|
||
將自動啟用 '--^controlledchanged' 選項。
|
||
|
||
XML 輸出的預設編碼為 utf-8。
|
||
|
||
根據預設，除非指定 '--^machinereadable' 或 '--^short' 標誌，
|
||
否則此命令將列印目前目錄相對路徑。如果
|
||
已指定其中任何一種標誌，此命令將列印絕對路徑。
|
||
|
||
如果已指定 '--^xml' 標誌，將列印工作區根目錄
|
||
相對路徑 (除非也已指定 '--^fp' 標誌，改為列印
|
||
絕對路徑)。
|
||
|
||
範例：
|
||
|
||
cm ^status
|
||
(列印工作變更集以及工作區中所有已變更的項目類型
|
||
，但已忽略的項目除外。)
|
||
|
||
cm ^status --^controlledchanged
|
||
(列印工作變更集以及已簽出、已新增、
|
||
已複製、已取代、已刪除和已移動的項目。)
|
||
|
||
cm ^status --^added
|
||
(只列印工作變更集以及工作區內已新增的項目。)
|
||
|
||
cm ^status c:\workspaceLocation\code\client --^added
|
||
(以遞迴方式列印工作變更集以及指定路徑下已新增的
|
||
項目。)
|
||
|
||
cm ^status --^changelists
|
||
cm ^status --^changelist
|
||
(顯示依用戶端變更清單分組的所有工作區變更。)
|
||
|
||
cm ^status --^changelist=暫止_待_檢閱
|
||
(顯示名為 '暫止_待_檢閱' 的變更清單上的變更)
|
||
|
||
cm ^status --^changelist=預設 --^private
|
||
(顯示 '預設' 變更清單中的變更，顯示私人項目，以及
|
||
含有受控變更的項目 (如果有的話)。)
|
||
|
||
cm ^status --^short --^changelist=暫止_待_檢閱 | cm ^checkin -
|
||
(簽入 '暫止_待_檢閱' 變更清單中的變更。)
|
||
|
||
cm ^status C:\workspaceLocation --^xml=output.xml
|
||
(取得 XML 格式的狀態資訊並在
|
||
output.xml 檔案中使用 utf-8。)
|
||
|
||
cm ^status --^ignored
|
||
(顯示所有已忽略的項目。)
|
||
輸出：
|
||
/main@myrepo@local (^cs:2 - ^head)
|
||
^Added
|
||
狀態 大小 上次修改 路徑
|
||
|
||
^Ignored 0 位元組 19 秒鐘之前 out\app.exe
|
||
^Ignored 48 秒鐘之前 src
|
||
^Ignored 0 位元組 48 秒鐘之前 src\version.c
|
||
|
||
cm ^status --^ignored --^cutignored
|
||
(顯示未忽略上層目錄的已忽略檔案，以及已忽略的
|
||
目錄但不顯示其內容。)
|
||
輸出：
|
||
/main@myrepo@local (^cs:2 - ^head)
|
||
^Added
|
||
狀態 大小 上次修改 路徑
|
||
|
||
^Ignored 0 位元組 19 秒鐘之前 out\app.exe
|
||
^Ignored 48 秒鐘之前 src
|
||
|
||
== CMD_DESCRIPTION_XLINK ==
|
||
建立、編輯或顯示 Xlink 的詳細資料。
|
||
|
||
== CMD_USAGE_XLINK ==
|
||
用法：
|
||
|
||
cm ^xlink [-^w] [-^rs] <xlink_路徑> / (<變更集規格> | <標籤規格> | <分支規格)>
|
||
[<擴充_規則>[ ...]]
|
||
(建立 Xlink。)
|
||
|
||
cm ^xlink [-^rs] <xlink_路徑> /<相對_路徑> (<變更集規格> | <標籤規格> | <分支規格>)
|
||
[<擴充_規則>[ ...]]
|
||
(建立指向 /<相對_路徑> 而非
|
||
預設根目錄 / 的唯讀局部 Xlink。)
|
||
|
||
cm ^xlink -^e <xlink_路徑> (<變更集規格> | <標籤規格> | <分支規格>)
|
||
(編輯 Xlink 以變更目標規格。)
|
||
|
||
cm ^xlink -^s|--^show <xlink_路徑>
|
||
(顯示 Xlink 資訊，包括擴充規則。)
|
||
|
||
cm ^xlink -^ar|--^addrules <xlink_路徑> <擴充_規則>[ ...]
|
||
(將指定的擴充規則新增至 Xlink)。
|
||
|
||
cm ^xlink -^dr|--^deleterules <xlink_路徑> <擴充_規則>[ ...]
|
||
(從 Xlink 中移除指定的擴充規則)。
|
||
|
||
Xlink_路徑 這是目前工作區中
|
||
將裝載 (建立
|
||
Xlink 時) 或已裝載 (編輯 Xlink 時) 連結儲存庫的所在目錄。
|
||
變更集規格 遠端儲存庫中的完整目標變更集
|
||
規格。
|
||
這可判斷會在連結儲存庫的工作區中載入
|
||
哪個版本和分支。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
|
||
規格。)
|
||
標籤規格 遠端儲存庫中的完整標籤規格。
|
||
(使用 'cm ^help ^objectspec' 以深入瞭解標籤
|
||
規格。)
|
||
分支規格 遠端儲存庫中的完整分支規格。
|
||
這會使用指定分支指向的
|
||
目前變更集。(使用 'cm ^help ^objectspec'
|
||
深入瞭解分支規格。)
|
||
-^e 編輯現有 Xlink 以變更目標變更集
|
||
規格。
|
||
-^s | --^show 顯示關於所選 Xlink 的資訊。
|
||
-^ar | --^addrules 將一或多個擴充規則新增至所選 Xlink。
|
||
-^dr | --^deleterules 從所選 Xlink 刪除一或多個擴充
|
||
規則。
|
||
擴充_規則 指定一或多個擴充規則。每個擴充
|
||
規則都是一組分支目標分支：
|
||
^br:/main/fix-^br:/main/develop/fix
|
||
|
||
選項：
|
||
|
||
-^w 代表 Xlink 為可寫入的狀態。這表示
|
||
可透過分支自動擴充修改
|
||
目標儲存庫內容。
|
||
-^rs 相對伺服器。此選項可允許建立
|
||
獨立於儲存庫伺服器之外的相對 Xlink。如此
|
||
一來，將會自動識別不同伺服器的複寫
|
||
儲存庫中建立的 Xlink。
|
||
|
||
== CMD_HELP_XLINK ==
|
||
備註：
|
||
|
||
此命令會對指定的變更集建立 Xlink。依預設會建立唯讀
|
||
Xlink。這表示無法修改 Xlink 的工作區中
|
||
載入的內容。若要在
|
||
Xlink 內容中進行變更，則須改為建立可寫入的 Xlink (使用 '-^w' 選項)。
|
||
|
||
編輯 Xlink 的目標變更集時，可以使用簡化的
|
||
命令語法。如此一來，唯一需要的參數就是
|
||
新目標變更集。將不會修改其餘的 Xlink
|
||
參數。
|
||
|
||
分支自動擴充：
|
||
|
||
在任何可寫入 Xlink 儲存庫中進行變更時 ('-^w' 選項)，必須在目標
|
||
儲存庫中建立新分支。新分支
|
||
的名稱是根據最上層儲存庫中定義的
|
||
簽出分支。若要決定要使用的分支名稱，以下是適用的規則：
|
||
|
||
1) 執行檢查，確認目標儲存庫中是否存在
|
||
具有相同完整名稱的分支：
|
||
- 如果存在，這會用來做為簽出分支。
|
||
- 如果不存在，會按照下列方式建立分支名稱：
|
||
- 目標 Xlink 變更集的分支名稱 + 簽出分支的
|
||
簡短名稱 (最後的部分)。
|
||
- 如果此分支存在，則會用來做為簽出分支。
|
||
- 否則，則會建立分支，且分支基底會設定為
|
||
Xlink 變更集。
|
||
|
||
2) 會在指向 Xlink 儲存庫之新變更集的上層儲存庫的
|
||
分支上建立新版 Xlink。
|
||
|
||
最後，會保留最新版本的完整 Xlink 結構，並包含適當
|
||
版本中的最新變更。
|
||
|
||
範例：
|
||
|
||
cm ^xlink code\firstrepo / 1@first@localhost:8084
|
||
(在目前工作區的 'firstrepo' 資料夾中建立 Xlink，其中
|
||
將會裝載儲存庫 'first' 中的變更集 '1'。)
|
||
|
||
cm ^xlink opengl\include /includes/opengl 1627@includes@localhost:8087
|
||
(在目前工作區的目錄 'opengl\include' 中建立唯讀
|
||
局部 Xlink，其中儲存庫 'includes' 的變更集 '1627' 中的路徑 '/includes/opengl'
|
||
將裝載為根目錄。這表示無論
|
||
'/includes/opengl' 中的內容是什麼，都會裝載在 'opengl\include' 中，而
|
||
儲存庫的其餘項目則將予以忽略。)
|
||
|
||
cm ^xlink -^w -^rs code\secondrepo / ^lb:LB001@second@localhost:8084
|
||
(在目前工作區的資料夾 'secondrepo' 中建立可寫入
|
||
且相對的 Xlink，其中將裝載儲存庫 'second' 的
|
||
標籤 'LB001'。)
|
||
|
||
cm ^xlink code\thirdrepo / 3@third@localhost:8087 ^br:/main-^br:/main/scm003
|
||
(在目前工作區的 'thirdrepo' 資料夾中建立 Xlink，其中
|
||
將會裝載儲存庫 'third' 中的變更集 '3'。)
|
||
|
||
cm ^xlink -^e code\secondrepo ^br:/main/task1234@second@localhost:8084
|
||
(編輯 Xlink 'code\secondrepo'，在儲存庫 'second'
|
||
中連結分支 'main/task1234' 以變更目標儲存庫。)
|
||
|
||
cm ^xlink --^show code\thirdrepo
|
||
(顯示 Xlink 'code\thirdrepo' 的資訊，包括其擴充
|
||
規則 (如果有的話))。
|
||
|
||
cm ^xlink -^ar code\secondrepo ^br:/main-^br:/main/develop ^br:/main/fix-^br:/main/develop/fix
|
||
(將兩個擴充規則新增至 xlink 'code\secondrepo'。)
|
||
|
||
cm ^xlink -^dr code\secondrepo ^br:/main/fix-^br:/main/develop/fix
|
||
(從 xlink ' code\secondrepo' 中刪除擴充規則)。
|
||
|
||
== CMD_USAGE_AUTOCOMPLETE ==
|
||
用法：
|
||
|
||
cm ^autocomplete ^install
|
||
(將 'cm' 命令完成安裝在 Shell 中。)
|
||
|
||
cm ^autocomplete ^uninstall
|
||
(從 Shell 中解除安裝 'cm' 命令完成。)
|
||
|
||
cm ^autocomplete --^line <shell_行> --^position <滑鼠_位置>
|
||
(讓 'shell_行' 的自動完成建議回到插入於
|
||
'滑鼠_位置'。此命令並非專供最終使用者使用，
|
||
但仍記載於文件中，以防您想要為您選擇的 Shell 擴充
|
||
自動完成支援。)
|
||
|
||
shell_行 使用者已在要求自動完成時
|
||
寫入 Shell 的文字行。
|
||
在 Bash 中，這位於 COMP_LINE 環境變數中。
|
||
在 PowerShell 中，這位於 $wordToComplete 變數中。
|
||
滑鼠_位置 要求自動完成時的
|
||
滑鼠位置。
|
||
在 Bash 中，這位於 COMP_POINT 環境變數中。
|
||
在 PowerShell 中，這位於 $cursorPosition 變數中。
|
||
|
||
== CMD_DESCRIPTION_CONFIGURECLIENT ==
|
||
Configures the Unity VCS client for the current machine user to work with a default server.
|
||
|
||
== CMD_USAGE_CONFIGURECLIENT ==
|
||
用法:
|
||
cm ^configure [--^language=<language> --^workingmode=<mode> [AuthParameters]
|
||
--^server=<server> [--^port=<port>]] [--^clientconf=<clientconfpath>]
|
||
|
||
--^language 可用的語言:
|
||
en (English)
|
||
es (Spanish)
|
||
|
||
--^workingmode 可用的使用者/安全性工作模式:
|
||
NameWorkingMode (Name)
|
||
NameIDWorkingMode (Name + ID)
|
||
LDAPWorkingMode (LDAP)
|
||
ADWorkingMode (Active Directory)
|
||
UPWorkingMode (User and password)
|
||
SSOWorkingMode (Single Sign On)
|
||
|
||
AuthParameters 驗證參數 (僅適用於 ^LDAPWorkingMode 和 ^UPWorkingMode):
|
||
--^user=<user>
|
||
--^password=<password>
|
||
|
||
Single Sign On parameters (only for ^SSOWorkingMode):
|
||
--^user=<user>
|
||
--^token=<token>
|
||
|
||
--^server Unity VCS server IP / address
|
||
|
||
--^port Unity VCS server port
|
||
(port optional for Cloud servers)
|
||
|
||
--^clientconf 用來建立設定檔案的檔案路徑 (選用)
|
||
引數可以是完整的路徑、檔案名稱或目錄。
|
||
|
||
範例:
|
||
|
||
--^clientconf=c:/path/to/myclient.conf
|
||
(將使用指定的路徑來建立用戶端設定檔案)
|
||
|
||
--^clientconf=myclient.conf
|
||
(將使用預設設定目錄內的檔案 myclient.conf)
|
||
|
||
--^clientconf=c:/exisitingDirectory
|
||
(將使用指定目錄中的預設檔案名稱 client.conf)
|
||
|
||
== CMD_HELP_CONFIGURECLIENT ==
|
||
備註：
|
||
|
||
The cm ^configure command cannot be used on Cloud Edition or DVCS Edition of Unity VCS.
|
||
Use 'plastic --configure' instead.
|
||
|
||
範例:
|
||
|
||
cm ^configure
|
||
(runs the interactive Unity VCS client configuration command)
|
||
|
||
cm ^configure --^language=^en --^workingmode=^LDAPWorkingMode --^user=^jack --^password=^01234 \
|
||
--^server=^plastic.mymachine.com --^port=^8084
|
||
(configures the Unity VCS client with the specified parameters and creates the 'client.conf'
|
||
configuration file in the default directory).
|
||
(Cloud 伺服器的選用連接埠)
|
||
|
||
cm ^configure --^language=^en --^workingmode=^NameWorkingMode --^server=^plastic.mymachine.com \
|
||
--^port=^8084 --^clientconf=^clientconf_exp.conf
|
||
(configures the Unity VCS client with the specified parameters and creates the 'client.conf'
|
||
configuration file in the specified path).
|
||
(Cloud 伺服器的選用連接埠)
|