Files
SpaceDroid/Droid 2/Library/Artifacts/51/516ac360efa2b4e687e99a79caf13ea6
T

8191 lines
307 KiB
Plaintext
Raw Normal View History

2025-01-17 13:04:56 +01:00

a̬
 0.0.0þÿÿÿÿÿ0v²,¾|pØäA Ê@Ã3Ë7€ÿÿÿÿ€¦€²€E€ Þ€)€.€2€;a€ Þ€)€.€2€†€r€ Þ€) €.€2
€H€«€ÿÿÿÿ €1€1€ÿÿÿÿ @Þ€€
Q€j€ñ€PÿÿÿÿÀ1€1€ÿÿÿÿ€Þ€€€j€ÿÿÿÿ€b›€ÿÿÿÿ€H€xÿÿÿÿ€1€1€ÿÿÿÿ@Þ€€Q€j€H€}ÿÿÿÿ€1€1€ÿÿÿÿ@Þ€€Q€j€H€†ÿÿÿÿ€1€1€ÿÿÿÿ@Þ€€Q€j€y€
€ Þ€)!€.€2"€€‹ÿÿÿÿ#@1€1€ÿÿÿÿ$Þ€€%.€j€&H€™ÿÿÿÿ'€1€1€ÿÿÿÿ(@Þ€€)Q€j€*H€¤ÿÿÿÿ+€1€1€ÿÿÿÿ,@Þ€€-Q€j€.H€¶ÿÿÿÿ/€1€1€ÿÿÿÿ0@Þ€€1Q€j€2TextScriptImporterPPtr<EditorExtension>m_FileIDm_PathIDPPtr<PrefabInstance>m_ExternalObjectsSourceAssetIdentifiertypeassemblynamem_UsedFileIDsm_UserDatam_AssetBundleNamem_AssetBundleVariant1ÿÿeF¼_1Ch_Þ‰Ž$=O€7€ÿÿÿÿ€¦€²€E€ Þ€€.€€(a€ Þ€€.€€†€r€ Þ€ €.€
€H€«€ÿÿÿÿ €1€1€ÿÿÿÿ @Þ€€
Q€j€H€ê€ÿÿÿÿ€1€1€ÿÿÿÿ@Þ€€Q€j€PPtr<EditorExtension>m_FileIDm_PathIDPPtr<PrefabInstance>H ÄJHÄÁ ÄJcm-help.zh-Hant‚Á== 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_命令> [--^outputfile=<輸出_檔案>]
[--^solveuser=<欄_�>[,...]]
[--^solvepath=<欄_�>[,...]]
[--^columnwidth=<值>] [--^nocolumnname]
[--^columnseparator=<分隔符號>] [--^repository=<�稱>]
sql_命令 �執行的 sql 查詢。
�項:
--^outputfile 將�果寫入輸出檔案。
--^solveuser 將指定的欄�設為 [使用者�稱] 欄�。查詢
解譯器會將這些欄�的資料�定
為使用者,並將因此嘗試進行解�。
--^solvepath 將指定的欄�設為 [項目 ID] 欄�。查詢解譯器
將嘗試將項目 ID 解�為檔案系統
路徑。
--^columnwidth 指定�個欄的寬度以格�化輸出。
--^nocolumnname �列�欄�。
--^columnseparator 使用字元�為欄分隔符號,而�使用定�字元 (\t)。
--^repository �查詢的儲存庫。
== CMD_HELP_QUERY ==
備註:
此命令�讓使用者在伺�器資料庫中執行 SQL 查詢。
為寫入 SQL 查詢,請使用下列兩個�先定義的函數來管�
使用者和路徑:
- '^SolveUser(<使用者�稱>)':將使用者�稱解�為 Unity VCS 格�。
- '^SolvePath(<路徑>)':將�碟路徑解�為項目 ID。
此外,您�以使用�項以人類�讀的格�顯示查詢�果。
您�以使用 '--^solveuser=<欄_�>' 和
'--^solvepath=<欄_�>' �項,指定查詢解譯器
必須轉�為�讀文字的欄。您�以指定多個欄�,
並使用逗號分隔。
範例:
cm ^query "^SELECT * ^FROM ^revision" --^columnwidth=25 --^repository=reptest
(從 'reptest' 儲存庫的 '修訂' 表格擷�資料)
cm ^query "^SELECT b.^sname ^as 分支_�稱, o.^dtimestamp ^as 日期 ^from ^branch b, \
^object o, ^seid s ^where b.^iobjid=o.^iobjid ^and o.^fidowner=s.^iseidid ^and \
s.^scode='^SolveUser(john)'" --^outputfile=query.txt
(輸出至以�有者 'john' �為分支的檔案。)
cm ^query "^select r.^iobjid, r.^fiditem ^as 路徑, s.^scode ^as 使用者�稱 ^FROM \
^revision r, ^object o, ^seid s ^WHERE r.^iobjid=o.^iobjid ^and \
o.^fidowner=s.^iseidid ^and o.^dtimestamp>2014/04/25" \
--^solveuser=使用者�稱 --^solvepath=路徑 --^repository=reptest@server2:9095
(從所�儲存庫擷�所�資料。)
cm ^query "^SELECT * ^FROM ^revision ^WHERE ^fiditem=^SolvePath(c:\mywkpath\info)"
(擷�路徑 'info' 的所有修訂資料。)
== 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_TUBE ==
執行 Plastic Tube 的相關命令。
== CMD_USAGE_TUBE ==
用法:
cm ^tube ^config -^u=<使用者> -^p=<密碼>
(將 Unity VCS 設定為使用 Plastic Tube ��指定的使用者和
密碼。)
cm ^tube ^create <�端使用者>
(建立 "�端使用者 -> 我的使用者" Tube。
"我的使用者" 使用者�讓 "�端使用者" 連線至 "我的使用者" 伺�器。
�建立從 "�端使用者" 到 "我的使用者" 的連線。
�能建立從其他使用者到目� Tube 使用者的 Tube。)
cm ^tube ^remove <�端使用者>
(移除 "�端使用者 -> 我的使用者" Tube。)
cm ^tube ^local
(列出本地伺�器中共用的本地儲存庫,以�共用的
使用者。)
cm ^tube ^remote
(列出與目� Tube 使用者共用的共用
�端儲存庫。)
cm ^tube ^share <儲存庫_�格>[ ...]-^u=<�端使用者> -^a=(^pull | ^push | ^pull,^push)
(與�端使用者共用本地儲存庫並設定指定的
存�模�。使用空格分隔儲存庫�格。)
cm ^tube ^unshare <儲存庫_�格>[ ...]-^u=<�端使用者>
(�消與�端使用者共用本地儲存庫。使用空格
分隔儲存庫�格。)
cm ^tube ^connect
(將 Unity VCS 伺�器連線至 Plastic Tube。)
cm ^tube ^disconnect
(中斷 Unity VCS 伺�器與 Plastic Tube 的連線。)
cm ^tube ^status
(顯示 Unity VCS 伺�器是�已連線至 Plastic Tube。)
�項
-^u Tube 使用者 (plasticscm.com 使用者)。
-^p 使用者密碼。
-^a 設定存�模�。
儲存庫_�格 儲存庫�格。(使用 'cm ^help ^objectspec' 以
深入瞭解儲存庫�格。)
== CMD_HELP_TUBE ==
備註:
使用 'cm ^tube' 命令管� Plastic Tube。
範例:
cm ^tube ^config -^u=ruben@codicesoftware.com -^p=rubenpassword
cm ^tube ^create pablo@codicesoftware.com
('pablo@codicesoftware.com' �連線至目�的 Plastic Tube 使用者)
cm ^tube ^remove pablo@codicesoftware.com
cm ^tube ^local
cm ^tube ^remote
cm ^tube ^share repo@server:8087 -^u=pablo@codicesoftware.com -^a=^pull,^push
cm ^tube ^share repo@server:8087 doc@server:8087 -^u=pablo@codicesoftware.com -^a=^push
cm ^tube ^unshare repo@server:8087 -^u=pablo@codicesoftware.com
cm ^tube ^connect
cm ^tube ^disconnect
cm ^tube ^status
== 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).