== 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 == 設定權限需要瞭解 Plastic SCM 安全性的運作方式。 查看《安全性指南》以瞭解權限的運作方式： 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 繼承： 繼承是來自 Plastic SCM 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 == 備註： 若要啟動使用者，該使用者先前必須已停用。 預設情況下，第一次在 Plastic SCM 中執行寫入 作業時，會啟動使用者。只有在未超過使用者人數上限時， 才會自動啟動使用者。 如需停用 Plastic SCM 使用者的詳細資訊，請參閱 '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_APPLY_LOCAL == 檢查本地變更 (本地移動、本地刪除，以及本地變更) 並加以套用，這樣 Plastic SCM 就會開始追蹤這些變更。 == CMD_USAGE_APPLY_LOCAL == 用法： cm ^applylocal | ^al [--^dependencies] [<項目_路徑>[ ...]] [--^machinereadable [--^startlineseparator=<分隔符號>] [--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]] 選項： --^dependencies 將本地變更相依性新增至 要套用的項目。 項目_路徑 要套用的項目。使用空格分隔 路徑。使用雙引號 (" ") 指定 含空格的路徑。 --^machinereadable 以容易解析的格式輸出結果。 --^startlineseparator 搭配 '--^machinereadable' 標誌使用，指定 各行應如何起始。 --^endlineseparator 搭配 '--^machinereadable' 標誌使用，指定 各行應如何結束。 --^fieldseparator 搭配 '--^machinereadable' 標誌使用，指定應如何 分隔欄位。 == CMD_HELP_APPLY_LOCAL == 備註： 如果未指定 --^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' 以瞭解如何指定修訂規格。 執行此命令的使用者必須是 Plastic SCM 伺服器管理員 (儲存庫伺服器擁有者)，才能完成此作業。 來自指定修訂的每個資料區段將存放在 不同檔案中，其名稱以 --^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_EDIT_COMMENT == 修改變更集的註解。 == CMD_USAGE_CHANGESET_EDIT_COMMENT == 用法： cm ^changeset ^editcomment | ^edit <變更集規格> <新_註解> 選項： 變更集規格 將編輯註解的目標變更集。 (使用 'cm ^help ^objectspec' 以深入瞭解變更集 規格。) 新_註解 將新增至鎖定目標之變更集的 新註解。 == CMD_HELP_CHANGESET_EDIT_COMMENT == 備註： - 鎖定目標的變更集規格必須有效。 範例： 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 == 備註： - 此命令會傳回訊息，指出設定的 Plastic SCM 伺服器是否具備有效連線。 - 此命令會檢查設定的使用者是否有效。它也會 檢查與伺服器的版本相容性。 == 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 存在)，那麼每次在路徑上 發生簽出時，Plastic 會檢查其是否符合任何規則，如果符合， 該路徑會處於獨佔簽出 (已鎖定)，如此一來，就沒有人 可以同時簽出。 您可以使用 '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_CHGREVTYPE == 變更項目修訂類型 (二進位或文字)。 == CMD_USAGE_CHGREVTYPE == 用法： cm ^changerevisiontype | ^chgrevtype | ^crt <項目_路徑>[ ...]--^type=(^bin | ^txt) 項目_路徑 要變更修訂類型的項目。使用雙引號 (" ") 指定含空格的路徑。使用空格 分隔項目路徑。 --^type 目標修訂類型。選擇 '^bin' 或 '^txt'。 == CMD_HELP_CHGREVTYPE == 備註： 此命令只能套用至檔案，而無法套用至目錄。 指定的類型必須是系統支援的類型：'^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 [--^status=<狀態_名稱>] [--^assignee=<使用者_名稱>] [--^repository=<儲存庫_規格>] (編輯程式碼檢閱。) cm ^codereview -^d [ ...][--^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 == 備註： 此命令會將使用者設為非作用中，禁止該使用者使用 Plastic SCM。 如需啟動 Plastic SCM 使用者的詳細資訊，請參閱 '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 Plastic SCM 使用「/」做為分支階層中的預設 分隔符號。此選項允許使用字元做為階層分隔符號， 因此 main-task-sub 在 Plastic SCM 中會描繪成 /main/task/sub。 --^nodata 匯出儲存庫但不包含資料。此命令 對於檢查匯出是否將正常執行非常有用。 --^from 從特定變更集匯出。 --^to 匯出至特定變更集。 == CMD_HELP_FASTEXPORT == 備註： - 若要將 Plastic SCM 儲存庫匯入至 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 Plastic SCM 使用「/」做為分支階層中的預設 分隔符號。此選項允許使用 字元做為階層分隔符號，因此 main-task-sub 在 Plastic SCM 中會描繪成 /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_QUERY == 執行類似 SQL 的查詢，以尋找 Plastic SCM 物件。 == CMD_USAGE_FIND_QUERY == 用法： 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_QUERY == 備註： 如果未指定任何儲存庫，將會在工作區中設定的 儲存庫上進行搜尋。 當您從命令列使用比較運算子 (>、<、>=、<=) 執行查詢時， 請記住，此命令介面會將這些運算子視為 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' 選項，Plastic 會根據檔案時間戳記 尋找變更。指定 '--^checkcontent' 選項時，會比較檔案或 資料夾內容，而不是使用時間戳記。 此命令對於在與 Plastic SCM 伺服器中斷連線時偵測已變更的檔案， 相當有用。此輸出可透過管道傳送至簽出命令， 在稍後檢查變更 (請參閱範例)。 範例： 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 == 備註： 如果有指定任何路徑，Plastic SCM 將開始從 目前目錄搜尋。 此命令對於在資料夾上新增私人項目相當有用，透過管道將輸出 傳送至新增命令。請參閱範例。 範例： 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_GETWWI == 顯示關於工作區選擇器的資訊。 == CMD_USAGE_GETWWI == 用法： cm ^wi [<工作區_路徑>] 選項： 工作區_路徑 機器上的工作區路徑。 == CMD_HELP_GETWWI == 備註： '^wi' 命令會顯示工作區 (儲存庫、分支，及/或標籤) 的作用中設定。 範例： cm ^wi c:\mywk == CMD_DESCRIPTION_GWP == 從路徑取得工作區資訊。 == CMD_USAGE_GWP == 這是自動化命令，目的僅限用於自動化 'cm'。 方便使用的程度並不高。 用法： cm ^getworkspacefrompath | ^gwp <項目_路徑> [--^format=<字串_格式>] 項目_路徑 磁碟上的檔案或資料夾。 選項： --^format 以指定的格式擷取輸出訊息。如需 詳細資訊，請參閱備註。 == CMD_HELP_GWP == 備註： 此命令會顯示位於路徑中的工作區相關資訊。 此命令接受格式字串以顯示輸出。 此命令的輸出參數如下所示： {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 == 取得 Plastic SCM 命令的說明。 == CMD_USAGE_HELP == 用法： cm ^help <命令> == CMD_HELP_HELP == == CMD_DESCRIPTION_IOSTATS == 顯示關於硬體的統計資料。 == CMD_USAGE_IOSTATS == 用法： cm ^iostats [<儲存庫伺服器規格>] [<測試_清單>[ ...]] [--^nettotalmb=<值_mb>] [--^networkiterations=<值_反覆項目>] [--^diskdatasize=<值_大小>] [--^disktestpath=<值_路徑>] [--^systemdisplaytime=<值_時間>] [--^systemdisplaytimeinterval=<值_間隔>] 選項： 儲存庫伺服器規格 執行網路測試的可用 Plastic SCM 伺服器，例如 "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 (預設) 測量從 Plastic SCM 用戶端到伺服器的資料上傳速度。 --^serverdownloadtest (預設) 測量從 Plastic SCM 伺服器到用戶端的資料下載速度。 --^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。 --^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_LS == 列出樹狀目錄的內容。 == CMD_USAGE_LS == 用法： cm ^ls | ^dir [<路徑>[ ...]] [--^format=<字串_格式>] [--^symlink] [--^selector[=<選擇器_格式>]] [--^tree=<物件_規格>] [-^R | -^r | --^recursive] [--^xml[=<輸出_檔案>]] [--^encoding=<名稱>] 選項： 路徑 列出要顯示的路徑。使用空格分隔 路徑。 使用雙引號 (" ") 指定含空格的 路徑。 --^format 以指定的格式擷取輸出訊息。如需 詳細資訊，請參閱備註。 --^symlink 將作業套用至符號連結，而不是套用至 目標。 --^selector 取得此作用中工作區選擇器中的內容。 如已指定 [選擇器_格式]，則會列出 指定的選擇器。 這個選擇器幾乎已棄用，因為這些選擇器 自 4.x 版起已不再是 Plastic SCM 的中心部分。 --^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_LS == 備註： - 路徑輸入可使用中繼字元。 - 實際清單依工作區選擇器而定。 - 此命令的輸出可依指定的格式字串格式化處理。 - 如果指定了--^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_OBLITERATE == 已棄用 == CMD_USAGE_OBLITERATE == 已棄用。 == CMD_HELP_OBLITERATE == 已棄用。 == CMD_DESCRIPTION_OBJECTSPEC == 描述如何寫入物件規格。 == CMD_USAGE_OBJECTSPEC == 用法： cm ^objectspec 可取得所有關於如何建立物件規格的資訊。 == CMD_HELP_OBJECTSPEC == 多種 Plastic SCM 命令都會將「物件規格」當做輸入，以便參考至 指定的物件 (通常是分支、變更集、儲存庫等)。 這份文件說明不同的可用「規格」，及其 建置方式。 每種規格類型都會以唯一標籤做為開頭，例如 "^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 存在)，那麼每次在路徑上 發生簽出時，Plastic 會檢查其是否符合任何規則，如果符合， 該路徑會處於獨佔簽出 (已鎖定)，如此一來，就沒有人 可以同時簽出。 您可以使用 '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_RM == 從版本控制刪除檔案或目錄。 == CMD_USAGE_PARTIAL_RM == 用法： cm ^partial ^remove | ^rm <項目_路徑>[ ...][--^nodisk] 項目_路徑 要移除的項目路徑。使用雙引號 (" ") 指定含空格的路徑。使用空格分隔 路徑。 選項： --^nodisk 從版本控制移除，但將項目保留在磁碟上。 == CMD_HELP_PARTIAL_RM == 備註： 會從磁碟刪除項目。會從原始程式碼控制的上層目錄中 移除已移除的項目。 要求： - 項目必須受原始程式碼控制。 範例： 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_UNCO == 復原項目的簽出。 == CMD_USAGE_PARTIAL_UNCO == 用法： cm ^partial ^undocheckout | ^unco <項目_路徑>[ ...][--^silent] 項目_路徑 要套用作業的項目。使用雙引號 (" ") 指定含空格的路徑。使用空格 分隔路徑。 使用 . 將作業套用至目前目錄。 選項： --^silent 不顯示任何輸出。 == CMD_HELP_PARTIAL_UNCO == 備註： 如果項目已簽出，而且您不想將其簽入，您可以使用此命令復原 簽出。檔案和資料夾皆可取消 簽出。項目將更新為簽出前的狀態。 要求： - 項目必須受原始程式碼控制。 - 必須簽出項目。 範例： 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 [--^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(<使用者名稱>)'：將使用者名稱解析為 Plastic SCM 格式。 - '^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' 複寫之分支的所有變更集的遺失資料。如果沒有指定要取得資料的儲存庫， Plastic 會嘗試使用「複寫來源」(已複寫 分支的來源))。 cm ^pull ^hydrate <目的地_變更集_規格> [<來源_儲存庫_規格>] [--^user=<使用者_名稱> [--^password=<密碼>] | 授權選項] (引入先前使用 '--^nodata' 複寫之變更集的遺失資料。如果沒有指定要取得資料的儲存庫，Plastic 會嘗試 使用「複寫來源」)。 來源_分支_規格 要從遠端儲存庫提取的分支。 (使用 '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> 項目 的內容。您可從 Plastic 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 (提取相同的分支，但現在使用者是在遠端伺服器上進行驗證， 善加利用 Plastic SCM 所包含的使用者/密碼資料庫。) 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> 項目 的內容。您可從 Plastic 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 (複寫相同的分支，但現在使用者是在遠端伺服器上進行驗證， 善加利用 Plastic SCM 所包含的使用者/密碼資料庫。) == 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> 項目 的內容。您可從 Plastic 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_REVISION_HISTORY == 顯示檔案或目錄的歷程記錄。 == CMD_USAGE_REVISION_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_REVISION_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_RM == 可讓使用者刪除檔案和目錄。 == CMD_USAGE_RM == 用法： cm ^remove | ^rm <命令> [選項] 命令： ^controlled (選用) ^private 若要取得每個命令的詳細資訊，請執行： cm ^remove <命令> --^usage cm ^remove <命令> --^help == CMD_HELP_RM == 範例： cm ^remove \path\controlled_file.txt cm ^remove ^private \path\private_file.txt == CMD_DESCRIPTION_RM_CONTROLLED == 從版本控制刪除檔案或目錄。 == CMD_USAGE_RM_CONTROLLED == 用法： cm ^remove | ^rm <項目_路徑>[ ...][--^format=<字串_格式>] [--^errorformat=<字串_格式>] [--^nodisk] 項目_路徑 要移除的項目路徑。使用雙引號 (" ") 指定 含空格的路徑。使用空格分隔 路徑。 選項： --^format 以指定的格式擷取輸出進度 訊息。如需詳細資訊，請參閱範例。 --^errorformat 以指定的格式擷取錯誤訊息 (如果有的話)。如需詳細資訊，請參閱範例。 --^nodisk 從版本控制移除，但將項目保留在 磁碟上。 == CMD_HELP_RM_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_RM_PRIVATE == 刪除私人檔案或目錄。 警告：使用此命令刪除的檔案會永久刪除，而且無法 復原。建議您使用 '--^dry-run' 選項檢查 哪些檔案會受到此命令影響。 == CMD_USAGE_RM_PRIVATE == 用法： cm ^remove | ^rm ^private <路徑>[ ...][-^R | -^r | --^recursive] [--^ignored] [--^verbose] [--^dry-run] 路徑 要移除的檔案或目錄的路徑。使用雙 引號 (" ") 指定含空格的路徑。使用 空格分隔路徑。 選項： --^r 以遞迴的方式從受控目錄內 刪除私人檔案。 --^ignored 同時刪除忽略和隱匿的檔案和目錄。 --^verbose 列印所有受影響的路徑。 --^dry-run 執行此命令，而不在磁碟上進行任何變更。 == CMD_HELP_RM_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 == 此命令已棄用。它的存在是為了回溯相容性， 但在 Plastic SCM 4.0 中大多已棄用選擇器。選擇器仍 存在是為了指定工作分支或變更集，但舊規則 篩選路徑的功能已不再受到支援。 用法： cm ^setselector | ^sts [--^file=<選擇器_檔案>] [--^ignorechanges] [--^forcedetailedprogress] [<工作區_路徑> | <工作區_規格>] 選項： --^file 要從中載入選擇器的檔案。 --^ignorechanges 如果在更新工作區時偵測到 暫止的變更，則忽略顯示的暫止 變更警告訊息。 --^forcedetailedprogress 強制顯示詳細進度，即使在標準輸出 重新導向的情況下亦然。 工作區_路徑 要設定選擇器的工作區路徑。 工作區_規格 工作區規格。(使用 'cm ^help ^objectspec' 以深入瞭解工作區規格。) == CMD_HELP_SETSELECTOR == 備註： 此命令會設定工作區的選擇器。 工作區需要資訊才能從儲存庫載入修訂。 為取得此資訊，Plastic SCM 會使用選擇器。 透過選擇器，您可以從指定的分支、 標籤或變更集載入修訂。 如果未指定要載入選擇器的檔案，則會執行預設的作業 系統編輯器。 範例選擇器： ^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 複寫相關欄位： 很多物件會追蹤複寫資料，這表示 Plastic 會追蹤 原本建立這些資料的所在位置。 您可以使用的欄位包括： ^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。在 Plastic 中， 每次從複本建立新物件時， 都會建立新的「複寫記錄」。 範例： 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 == 此命令已棄用。它的存在是為了回溯相容性， 但在 Plastic SCM 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 [ [--^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 可偵測已移動的項目，與 Plastic SCM 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=<密碼> (將 Plastic SCM 設定為使用 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 (將 Plastic SCM 伺服器連線至 Plastic Tube。) cm ^tube ^disconnect (中斷 Plastic SCM 伺服器與 Plastic Tube 的連線。) cm ^tube ^status (顯示 Plastic SCM 伺服器是否已連線至 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_UNCO == 復原項目簽出。 == CMD_USAGE_UNCO == 用法： cm ^undocheckout | ^unco <項目_路徑>[ ...][-^a | --^all] [--^symlink] [--^silent] [--^machinereadable [--^startlineseparator=<分隔符號>] [--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]] 項目_路徑 要套用作業的項目。使用空格分隔 路徑。使用雙引號 (" ") 指定含空格的 路徑。 使用 . 將作業套用至目前目錄。 選項： -^a | --^all 復原指定項目中的所有變更。如果 項目已簽出，則會還原 簽出。如果項目已在本地修改，則會 還原修改。 --^symlink 將復原簽出作業套用至連結，而非 套用至目標。 --^silent 不顯示任何輸出。 --^machinereadable 以易於剖析的格式輸出結果。 --^startlineseparator 搭配 '--^machinereadable' 標誌使用， 指定各行應如何起始。 --^endlineseparator 搭配 '--^machinereadable' 標誌使用， 指定各行應如何結束。 --^fieldseparator 搭配 '--^machinereadable' 標誌使用， 指定應如何分隔欄位。 == CMD_HELP_UNCO == 備註： 如果項目已簽出，而且您不想將其簽入，您可以使用此命令復原 簽出。檔案和資料夾皆可取消 簽出。項目將更新為簽出前的狀態。 要求： - 項目必須受原始程式碼控制。 - 必須簽出項目。 從 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_UNCOUNCHANGED == 復原未變更的已簽出項目。 == CMD_USAGE_UNCOUNCHANGED == 用法： cm ^uncounchanged | ^unuc <項目_路徑>[ ...][-^R | -^r | --^recursive] [--^symlink] [--^silent] 項目_路徑 要套用作業的項目。使用空格分隔 路徑。使用雙引號 (" ") 指定含空格的 路徑。 使用 . 將作業套用至目前目錄。 選項： -^R 以遞迴方式復原指定路徑中未變更的項目。 --^symlink 將復原簽出未變更的作業套用至連結，而不是 套用至目標。 --^silent 不顯示任何輸出。 == CMD_HELP_UNCOUNCHANGED == 備註： 此命令會從工作區根目錄以遞迴的方式套用。 從 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 [<儲存庫伺服器規格>] [ ...] 儲存庫伺服器規格 儲存庫伺服器規格。(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺服器規格。) GUID 要封鎖的 GUID 項目清單。使用空格 分隔 GUID。 == CMD_HELP_LOCK_UNLOCK == 備註： - 此命令會使用指定的伺服器來解除鎖定項目。 - 如果未指定伺服器，此命令會嘗試從目前工作區 取得伺服器。 - 如果未在上述步驟中計算伺服器，則會從目前 Plastic SCM 用戶端組態取得伺服器。 - 只有伺服器管理員才能執行 '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 覆寫 Plastic SCM 控制範圍外的已變更檔案。 將以伺服器內容 覆寫其內容。 --^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 == 顯示目前的 Plastic SCM 使用者。 == 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 格式的輸出列印至標準輸出。 可以指定輸出檔案。 --^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。) cm ^xlink [-^rs] /<相對_路徑> (<變更集規格> | <標籤規格> | <分支規格>) [<擴充_規則>[ ...]] (建立指向 /<相對_路徑> 而非 預設根目錄 / 的唯讀局部 Xlink。) cm ^xlink -^e (<變更集規格> | <標籤規格> | <分支規格>) (編輯 Xlink 以變更目標規格。) cm ^xlink -^s|--^show (顯示 Xlink 資訊，包括擴充規則。) cm ^xlink -^ar|--^addrules <擴充_規則>[ ...] (將指定的擴充規則新增至 Xlink)。 cm ^xlink -^dr|--^deleterules <擴充_規則>[ ...] (從 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 --^position <滑鼠_位置> (讓 'shell_行' 的自動完成建議回到插入於 '滑鼠_位置'。此命令並非專供最終使用者使用， 但仍記載於文件中，以防您想要為您選擇的 Shell 擴充 自動完成支援。) shell_行 使用者已在要求自動完成時 寫入 Shell 的文字行。 在 Bash 中，這位於 COMP_LINE 環境變數中。 在 PowerShell 中，這位於 $wordToComplete 變數中。 滑鼠_位置 要求自動完成時的 滑鼠位置。 在 Bash 中，這位於 COMP_POINT 環境變數中。 在 PowerShell 中，這位於 $cursorPosition 變數中。