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

8191 lines
307 KiB
Plaintext
Raw Normal View History

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

a̬
 0.0.0þÿÿÿÿÿ0v²,¾|pØäA Ê@Ã3Ë7€ÿÿÿÿ¦€²E Þ€).€2;a Þ€).€2€r Þ€) .€2
H€«€ÿÿÿÿ 1€1€ÿÿÿÿ @Þ
Q€jñ€PÿÿÿÿÀ1€1€ÿÿÿÿÞ€j€ÿÿÿÿb€ÿÿÿÿH€xÿÿÿÿ1€1€ÿÿÿÿ@ÞQ€jH€}ÿÿÿÿ1€1€ÿÿÿÿ@ÞQ€jH€†ÿÿÿÿ1€1€ÿÿÿÿ@ÞQ€jy
 Þ€)!.€2"€‹ÿÿÿÿ#@1€1€ÿÿÿÿ$Þ%.€j&H€™ÿÿÿÿ'1€1€ÿÿÿÿ(@Þ)Q€j*H€¤ÿÿÿÿ+1€1€ÿÿÿÿ,@Þ-Q€j.H€¶ÿÿÿÿ/1€1€ÿÿÿÿ0@Þ1Q€j2TextScriptImporterPPtr<EditorExtension>m_FileIDm_PathIDPPtr<PrefabInstance>m_ExternalObjectsSourceAssetIdentifiertypeassemblynamem_UsedFileIDsm_UserDatam_AssetBundleNamem_AssetBundleVariant1ÿÿeF¼_1Ch_Þ‰Ž$=O€7€ÿÿÿÿ¦€²E Þ.(a Þ.€r Þ .
H€«€ÿÿÿÿ 1€1€ÿÿÿÿ @Þ
Q€jH€ê€ÿÿÿÿ1€1€ÿÿÿÿ@ÞQ€jPPtr<EditorExtension>m_FileIDm_PathIDPPtr<PrefabInstance>H ÄJHÄÁ ÄJcm-help.zh-Hant‚Á== CMD_DESCRIPTION_ACL ==
設定物件權é™ã€‚
== CMD_USAGE_ACL ==
用法:
cm ^acl (--^user=<使用者_å稱> | --^group=<群組_å稱>)
(-^allowed|-^denied|-^overrideallowed|-^overridedenied=+|-<權é™>[,...])[,...]
<ç‰©ä»¶è¦æ ¼>
--^user 使用者å稱。
--^group 群組å稱。
-^allowed 啟用指定的一或多項權é™ã€‚使用
逗號以分隔權é™ã€‚(使用 'cm ^showpermissions'
以顯示所有å¯ç”¨çš„æ¬Šé™ã€‚)
-^denied 拒絕指定的一或多項權é™ã€‚使用
逗號以分隔權é™ã€‚(使用 'cm ^showpermissions'
以顯示所有å¯ç”¨çš„æ¬Šé™ã€‚)
-^overrideallowed 覆寫å…許的一或多項權é™ã€‚使用
逗號以分隔權é™ã€‚(使用 'cm ^showpermissions'
以顯示所有å¯ç”¨çš„æ¬Šé™ã€‚)
-^overridedenied 覆寫拒絕的一或多項權é™ã€‚使用
逗號以分隔權é™ã€‚(使用 'cm ^showpermissions'
以顯示所有å¯ç”¨çš„æ¬Šé™ã€‚)
ç‰©ä»¶è¦æ ¼ 將設定權é™çš„物件。
此命令的有效物件為:
儲存庫伺æœå™¨ã€å„²å­˜åº«ã€åˆ†æ”¯ã€è®Šæ›´é›†ã€æ¨™ç±¤ã€é …目,
以åŠå±¬æ€§ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
安全路徑的特殊用法:
cm ^acl [(--^user=<使用者_å稱> | --^group=<群組_å稱>)
(-^allowed|-^denied|-^overrideallowed|-^overridedenied=+|-<權é™>[,...])[,...]]
[--^delete] [--^branches=[+ | -]<分支>[,...]]
<è¦æ ¼>
--^delete 移除安全路徑。
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^branches 將安全路徑權é™è¨­ç‚ºåˆ†æ”¯ç¾¤çµ„。
使用逗號以分隔分支。
或者,æ¯å€‹åˆ†æ”¯å‰é¢å¯åŠ ä¸Š + 或 -
簽署以指定在編輯時是å¦å¿…須在清單中新增或刪除
分支。
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
è¦æ ¼ è¨­å®šæ¬Šé™æ‰€åœ¨çš„安全路徑。
== CMD_HELP_ACL ==
設定權é™éœ€è¦çž­è§£ Unity VCS 安全性的é‹ä½œæ–¹å¼ã€‚
查看《安全性指å—》以瞭解權é™çš„é‹ä½œæ–¹å¼ï¼š
https://www.plasticscm.com/download/help/securityguide
備註:
此命令為使用者或群組設定特定物件ã€å„²å­˜åº«ã€åˆ†æ”¯ã€æ¨™ç±¤
åŠ/或伺æœå™¨è·¯å¾‘的權é™ã€‚
ç‰©ä»¶è¦æ ¼ï¼š
(使用 'cm ^help ^objectspec' 以瞭解如何指定物件。)
'^acl' å‘½ä»¤ä½¿ç”¨ç‰¹æ®Šé¡žåž‹çš„è¦æ ¼ï¼šå®‰å…¨è·¯å¾‘。
- å®‰å…¨è·¯å¾‘è¦æ ¼ï¼š
^path:server_path[#tag]
範例:^path:/src/foo.c
^path:/doc/pdf
^path:/doc/pdf#documents
權é™å‹•作:
使用 -^allowed å’Œ -^denied 以指定è¦è¨­å®šçš„æ¬Šé™ã€‚
使用 -^overrideallowed 和 -^overridedenied 引數以指定
è¦è¦†å¯«çš„æ¬Šé™ã€‚
æ¯å€‹å‹•作皆需è¦ä»¥é€—è™Ÿåˆ†éš”çš„æ¬Šé™æ¸…單。
權é™å稱:
æ¯å€‹æ¬Šé™å‰é¢å·²åŠ ä¸Š + 或 - 符號。
+ 符號å¯è¨­å®šæ¬Šé™ï¼Œ- ç¬¦è™Ÿå¯æ¸…除權é™ã€‚
è‹¥è¦æŸ¥çœ‹ç‰©ä»¶çš„æ¬Šé™ï¼Œè«‹ä½¿ç”¨ 'cm ^showacl' 命令。
已覆寫的權é™ï¼š
使用 -^overrideallowed 和 -^overridedenied
覆寫權é™å¯è®“您略éŽç¹¼æ‰¿ã€‚
ç•¥éŽåœ¨å„²å­˜åº«æˆ–伺æœå™¨å±¤ç´šè¨­å®šçš„æ¬Šé™æœƒ
很有幫助。
範例:
cm ^acl --^user=vio -^allowed=+^ci -^overrideallowed=+^ci ^br:qa@test
³ä½¿ä½¿ç”¨è€… 'vio' 的權é™åœ¨å„²å­˜åº«å±¤ç´šé­å—拒絕,該使用者也å¯ä»¥åœ¨å„²å­˜åº« 'test'
的分支 'qa' 上簽入。)
伺æœå™¨è·¯å¾‘權陈稱為安全路徑):
- å¯é‡å°ç‰¹å®šä¼ºæœå™¨è·¯å¾‘指定權é™ã€‚
- 簽入作業期間會檢查這些權é™ã€‚
- 更新作業期間也會檢查這些權é™ï¼Œ
並且å¯ç”¨ä¾†é˜²æ­¢æŸäº›ç›®éŒ„和檔案
下載至工作å€ã€‚
- å°æ–¼è¦ç°½å…¥çš„æ¯å€‹é …ç›®ï¼Œä¼ºæœå™¨æœƒå˜—試將項目路徑
與安全路徑進行比å°ã€‚如果相符,簽入作業會檢查
該項目是å¦å…·æœ‰è¦ç°½å…¥çš„æ¬Šé™ã€‚
å¯ä»¥é‡å°å®‰å…¨è·¯å¾‘定義的權é™
如下:
'^ci'ã€'^change'ã€'^add'ã€'^move'ã€'^rm'ã€'^read'
如果任何涉åŠé …ç›®çš„æ¬Šé™æª¢æŸ¥ä¸æˆåŠŸï¼Œ
將會復原簽入作業。
è‹¥è¦å°‡å®‰å…¨è·¯å¾‘權é™è¨­ç‚ºåˆ†æ”¯ç¾¤çµ„,請使用
--^branches é¸é …。
範例:
cm ^acl --^user=jo -^denied=+^ci ^path:/src#rule0 --^branches=main,main/rel0
è‹¥è¦ç·¨è¼¯èˆ‡å®‰å…¨è·¯å¾‘相關的 ACL,標籤很有用。
範例:
cm ^acl --^user=jo -^denied=+^rm ^path:/src#rule0
(如果沒有此標籤,å¯èƒ½éœ€è¦å†æ¬¡æŒ‡å®š
分支清單。)
å¯ç·¨è¼¯å®‰å…¨è·¯å¾‘的分支清單。
範例:
cm ^acl ^path:/src#rule0 --^branches=-main,+main/rel1
(將 'main' 從清單中移除,並新增 'main/rel1'。)
è‹¥è¦ç§»é™¤å®‰å…¨è·¯å¾‘,請使用 --^delete 引數。
範例:
cm ^acl --^user=jo --^delete ^path:/src#rule0
繼承:
繼承是來自 Unity VCS 3.0 çš„é¸é …。
這是進階é¸é …,但幾乎已棄用。
該é¸é …å¯è®“物件繼承來自任何其他物件的權é™ï¼Œ
覆寫é è¨­çš„繼承關係。
使用é¸é … -^cut 以切斷繼承éˆã€‚
使用é¸é … -^cutncpy 以切斷和複製目å‰ç¹¼æ‰¿çš„
權é™ã€‚(這是å—到 Windows 檔案系統權é™çš„啟發
,在當中您å¯ä»¥åˆ‡æ–·ç¹¼æ‰¿ï¼Œä½†ä¿ç•™å¯¦é𛿬Šé™ã€‚)
-^inherit é¸é …å¯è®“ä½¿ç”¨è€…ç¹¼æ‰¿ç‰©ä»¶è¦æ ¼ã€‚
範例:'-^inherit=物件_è¦æ ¼'
範例:
cm ^acl --^user=danipen -^denied=+^ci ^rep:core
(在儲存庫 'core' 上拒絕使用者 'danipen' 的簽入。)
cm ^acl --^group=developers -^allowed=+^view,-^read -^denied=+^chgperm ^br:main
(此命令å¯é‡å° 'main' 分支中 'developers' 群組授予檢視權é™ã€
æ¸…é™¤è®€å–æ¬Šé™ï¼Œä¸¦æ‹’絕 chgperm 權é™ã€‚)
安全路徑範例:
cm ^acl --^group=devs -^denied=+^ci ^path:/server#rel --^branches=main,main/2.0
(此命令會拒絕分支 'main' å’Œ 'main/2.0' ä¸­ä»»ä½•ç¬¦åˆ '/server' 之路徑
çš„ '開發' 群組的簽入權é™ã€‚建立標籤 '#rel'
是為了能在日後進行åƒç…§ã€‚)
cm ^acl ^path:/server#rel --^branches=-/main,+/main/Rel2.1
(更新安全路徑 '/server',其標籤是 'rel',移除
'main' 分支,並將分支 'main/Rel2.1' 新增至
安全路徑é©ç”¨çš„分支群組。請考é‡å…ˆå‰ç¯„例,
ç¾åœ¨åˆ†æ”¯æ¸…å–®å°‡åŒ…å« 'main/Rel2.1' å’Œ 'main/2.0'。)
cm ^acl --^user=vsanchezm -^allowed=-^read -^overrideallowed=+^read ^path:/doc
(é‡å° '/doc' 路徑中覆寫的 'vsanchezm',移除 '^read' 權é™ã€‚)
== CMD_DESCRIPTION_ACTIVATEUSER ==
啟動授權使用者。
== CMD_USAGE_ACTIVATEUSER ==
用法:
cm ^activateuser | ^au <使用者å稱>[ ...][--^server=<儲存庫伺æœå™¨è¦æ ¼>]
使用者å稱 è¦å•Ÿå‹•的一或多個使用者å稱。使用雙引號 (" ")
以指定使用者å稱 (包å«ç©ºæ ¼)。使用空格
以分隔使用者å稱。
é¸é …:
--^server=<儲存庫伺æœå™¨è¦æ ¼> 在指定的伺æœå™¨ä¸­å•Ÿå‹•使用者。
如果未指定任何伺æœå™¨ï¼Œè«‹åœ¨ client.conf 檔案的
é è¨­ä¼ºæœå™¨ä¸­åŸ·è¡Œå‘½ä»¤ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解
儲存庫伺æœå™¨è¦æ ¼ã€‚)
== CMD_HELP_ACTIVATEUSER ==
備註:
è‹¥è¦å•Ÿå‹•使用者,該使用者先å‰å¿…須已åœç”¨ã€‚
é è¨­æƒ…æ³ä¸‹ï¼Œç¬¬ä¸€æ¬¡åœ¨ Unity VCS 中執行寫入
ä½œæ¥­æ™‚ï¼Œæœƒå•Ÿå‹•ä½¿ç”¨è€…ã€‚åªæœ‰åœ¨æœªè¶…éŽä½¿ç”¨è€…äººæ•¸ä¸Šé™æ™‚,
æ‰æœƒè‡ªå‹•啟動使用者。
如需åœç”¨ Unity VCS 使用者的詳細資訊,請åƒé–±
'cm ^help ^deactivateuser' 命令。
範例:
cm ^activateuser john
cm ^activateuser david "mary collins"
cm ^au peter --^server=localhost:8087
== CMD_DESCRIPTION_ADD ==
將項目新增至版本控制。
== CMD_USAGE_ADD ==
用法:
cm ^add [-^R | -^r | --^recursive] [--^silent] [--^ignorefailed]
[--^skipcontentcheck] [--^coparent] [--^filetypes=<檔案>] [--^noinfo]
[--^format=<字串格å¼>] [--^errorformat=<字串格å¼>]
<項目路徑>[ ...]
項目路徑 è¦æ–°å¢žçš„一或多個項目。使用雙引號 (" ") 指定
å«ç©ºæ ¼çš„路徑。使用空格以分隔項目。
使用 * 以新增目å‰ç›®éŒ„的所有內容。
é¸é …:
-^R -^r --^recursive éžè¿´æ–°å¢žé …目。
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^ignorefailed 如果無法新增項目,新增作業將會在沒有項目的情æ³ä¸‹ï¼Œ
繼續進行新增作業。請注æ„:如果無法新增目錄
ï¼Œå‰‡ä¸æœƒæ–°å¢žå…¶å…§å®¹ã€‚
--^skipcontentcheck 當擴充功能ä¸è¶³ä»¥å°‡æª”案設為文字
æˆ–äºŒé€²ä½æ™‚,將設為二進ä½ï¼Œè€Œä¸æœƒ
æª¢æŸ¥å…§å®¹ä»¥åµæ¸¬é¡žåž‹ã€‚這麼åšçš„目的是
æé«˜å¤§é‡ç°½å…¥çš„æ•ˆèƒ½ã€‚
--^coparent é‡å°è¦æ–°å¢žé …目的上層執行簽出。
--^filetypes è¦ä½¿ç”¨çš„æª”案類型檔案。如需詳細資訊,
請查看以下連çµï¼š
http://blog.plasticscm.com/2008/03/custom-file-types.html
--^noinfo ä¸åˆ—å°é€²åº¦è³‡è¨Šã€‚
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需詳細資訊,
請查看範例。
--^errorformat ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–錯誤訊æ¯
(如果有的話)。如需詳細資訊,請查看範例。
== CMD_HELP_ADD ==
備註:
æ–°å¢žé …ç›®çš„è¦æ±‚:
- è¦æ–°å¢žä¹‹é …目的上層目錄先å‰å¿…須已新增。
從 stdin 讀å–輸入:
'^add' 命令å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯å‚³éžå–®ä¸€ç ´æŠ˜è™Ÿ
「-ã€ä¾†å®Œæˆã€‚
範例:cm ^add -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“æ‚¨ä½¿ç”¨ç®¡ç·šä»¥æŒ‡å®šè¦æ–°å¢žçš„æª”案。
範例:
dir /S /B *.c | cm ^add -
(在 Windows 中,新增工作å€ä¸­æ‰€æœ‰ .c 檔案。)
範例:
cm ^add file1.txt file2.txt
(新增 'file1.txt' 和 'file2.txt' 項目。)
cm ^add c:\workspace\file.txt
(在路徑 'c:\workspace' 中新增 'file.txt' 項目。)
cm ^add -^R c:\workspace\src
žè¿´æ–°å¢ž 'src'。)
cm ^add -^R *
žè¿´æ–°å¢žç›®å‰ç›®éŒ„的所有內容。)
cm ^add -^R * --^filetypes=filetypes.conf
žè¿´æ–°å¢žç›®å‰ç›®éŒ„的所有內容,使用
'filetypes.conf' 以根據其副檔å將類型指派給æ¯å€‹æª”案,
è€Œä¸æ˜¯æª¢æŸ¥å…¶å…§å®¹ã€‚)
cm ^add --^coparent c:\workspace\dir\file.txt
(將 'file.txt' 新增至原始檔控制,並執行 'dir' 的簽出。)
cm ^add -^R * --^format="ADD {0}" --^errorformat="ERR {0}"
žè¿´æ–°å¢žç›®å‰ç›®éŒ„çš„æ‰€æœ‰å…§å®¹ï¼Œå°æ–¼æˆåŠŸæ–°å¢žçš„æª”æ¡ˆï¼Œ
åˆ—å° '^ADD <é …ç›®>'ï¼Œå°æ–¼ç„¡æ³•新增的項目,列å°
'^ERR <項目>'。)
== CMD_USAGE_ADDIGNOREPATTERN ==
用法:
cm ^addignorepattern <模å¼>[ ...]
[--^workspace=<工作å€è·¯å¾‘> | --^allworkspaces] [--^remove]
== CMD_DESCRIPTION_ADMIN ==
在伺æœå™¨ä¸ŠåŸ·è¡Œç³»çµ±ç®¡ç†å‘½ä»¤ã€‚
== CMD_USAGE_ADMIN ==
用法:
cm ^admin <命令> [é¸é …]
å¯ç”¨å‘½ä»¤ï¼š
^readonly
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^admin <命令> --^usage
cm ^admin <命令> --^help
== CMD_HELP_ADMIN ==
備註:
åªæœ‰ä¼ºæœå™¨ç®¡ç†å“¡æ‰å¯ä»¥åŸ·è¡Œç³»çµ±ç®¡ç†å‘½ä»¤ã€‚
範例:
cm ^admin ^readonly ^enter
cm ^admin ^readonly ^status
== CMD_DESCRIPTION_ADMIN_READONLY ==
啟用/åœç”¨ä¼ºæœå™¨å”¯è®€æ¨¡å¼ã€‚
== CMD_USAGE_ADMIN_READONLY ==
用法:
cm ^admin ^readonly (^enter | ^leave | ^status) [<伺æœå™¨>]
動作:
^enter 伺æœå™¨é€²å…¥å”¯è®€æ¨¡å¼ã€‚寫入作業將é­å—拒絕。
^leave 伺æœå™¨é›¢é–‹å”¯è®€æ¨¡å¼ã€‚
^status 顯示伺æœå™¨å”¯è®€æ¨¡å¼ç‹€æ…‹ã€‚
é¸é …:
伺æœå™¨ 在指定的伺æœå™¨ä¸­åŸ·è¡Œå‘½ä»¤ (server:port)。(使用
'cm ^help ^objectspec' 以深入瞭解伺æœå™¨è¦æ ¼ã€‚)
如果未指定任何伺æœå™¨ï¼Œå‘½ä»¤å°‡ä½¿ç”¨ç›®å‰
工作å€ä¸­çš„伺æœå™¨ã€‚
如果目å‰è·¯å¾‘ä¸åœ¨å·¥ä½œå€ä¸­ï¼Œå‘½ä»¤æœƒä½¿ç”¨ client.conf
設定檔案中定義的é è¨­ä¼ºæœå™¨ã€‚
== CMD_HELP_ADMIN_READONLY ==
備註:
åªæœ‰ä¼ºæœå™¨ç®¡ç†å“¡æ‰å¯ä»¥é€²å…¥ä¼ºæœå™¨å”¯è®€æ¨¡å¼ã€‚
範例:
cm ^admin ^readonly ^enter diana:8086
cm ^admin ^readonly ^leave
== CMD_DESCRIPTION_ANNOTATE ==
顯示檔案æ¯ä¸€è¡Œä¸Šæ¬¡ä¿®æ”¹çš„變更集åŠå…¶ä½œè€…。
== CMD_USAGE_ANNOTATE ==
用法:
cm ^annotate | ^blame <è¦æ ¼>[ ...]
[--^format=<字串_æ ¼å¼>]
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
[--^dateformat=<字串_日期_æ ¼å¼>]
[--^encoding=<å稱>]
[--^stats]
[--^repository=<å„²å­˜åº«è¦æ ¼>]
è¦æ ¼ è¦æ¨™è¨»çš„æª”æ¡ˆè¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
使用雙引號 (" ") 指定å«ç©ºæ ¼çš„路徑。
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^ignore 設定指定的比較方法。
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^dateformat 設定輸出格å¼ä»¥åˆ—å°æ—¥æœŸã€‚
--^encoding 指定輸出編碼,例如:utf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^stats 顯示統計資料資訊。
--^repository 指定用於計算
æ¨™è¨»çš„å„²å­˜åº«è¦æ ¼ã€‚é è¨­æƒ…æ³ä¸‹ï¼Œæ­¤å‘½ä»¤æœƒä½¿ç”¨
儲存庫,其中,工作å€ä¸­è¼‰å…¥çš„修訂儲存庫
å³å­˜æ”¾åœ¨æ­¤ã€‚(使用 'cm ^help ^objectspec' 以深入
çž­è§£å„²å­˜åº«è¦æ ¼ã€‚)
== CMD_HELP_ANNOTATE ==
備註:
äºŒé€²ä½æª”案無法標註。
--^ignore é¸é …:
^none 嵿¸¬è¡Œå°¾å’Œç©ºæ ¼å·®ç•°ã€‚
^eol 忽略行尾差異。
^whitespaces 忽略空格差異。
^"eol&whitespaces" 忽略行尾和空格差異。
--^format é¸é …:
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^owner} 上次變更行的使用者。
{^rev} 行的來æºä¿®è¨‚è¦æ ¼ã€‚
{^content} 行內容。
{^date} 簽入行的日期。
{^comment} 行的來æºä¿®è¨‚註解。
{^changeset} 行的來æºä¿®è¨‚變更集。
{^line} 檔案的行號。
{^id} 項目 ID。
{^parentid} 項目的上層 ID。
{^rep} 項目的儲存庫。
{^branch} 行的來æºä¿®è¨‚分支。
{^ismergerev} 此行的修訂是å¦åœ¨åˆä½µä¸­å»ºç«‹ã€‚
--^dateformat:
è‹¥è¦æŒ‡å®šåˆ—å°æ—¥æœŸçš„輸出格å¼ã€‚
è«‹åƒé–±æŒ‡å®šçš„æ”¯æ´æ ¼å¼ï¼Œç¶²å€ç‚ºï¼š
https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings
--^repository:
å¯å¾žé ç«¯å„²å­˜åº«æ“·å–è³‡æ–™ã€‚å°æ–¼åˆ†æ•£å¼
案例很有用。
範例:
cm ^blame c:\workspace\src --^ignore=^"eol&whitespaces" --^encoding=utf-8
cm ^annotate c:\workspace\file.txt --^ignore=^eol
cm ^annotate c:\workspace\file.txt --^format="{^owner} {^date, 10} {^content}"
(ä¾åºå¯«å…¥æ“有者欄ä½ã€ç©ºç™½ã€æ—¥æœŸæ¬„ä½ å³å°é½Š),
然後空白,å†å¯«å…¥å…§å®¹ã€‚)
cm ^blame c:\workspace\file.txt --^format="{^owner, -7} {^comment} {^date}" \
--^dateformat=yyyyMMdd
(以 7 å€‹ç©ºæ ¼å¯«å…¥æ“æœ‰è€…欄你左å°é½Š),接著是
空白ã€è¨»è§£ï¼Œç„¶å¾Œæ˜¯å¦ä¸€å€‹ç©ºç™½ï¼Œæœ€å¾Œæ˜¯
已格å¼åŒ–的日期 (例如,20170329)。)
cm ^annotate c:\workspace\file.txt --^repository=centralRep@myserver:8084
cm ^blame ^serverpath:/src/client/checkin/Checkin.cs#^cs:73666
(使用伺æœå™¨è·¯å¾‘é‡å°ä»¥è®Šæ›´é›† 73666 開始的檔案進行標註。)
== CMD_DESCRIPTION_APPLYLOCAL ==
檢查本地變更 (æœ¬åœ°ç§»å‹•ã€æœ¬åœ°åˆªé™¤ï¼Œä»¥åŠæœ¬åœ°è®Šæ›´)
並加以套用,這樣 Unity VCS 就會開始追蹤這些變更。
== CMD_USAGE_APPLYLOCAL ==
用法:
cm ^applylocal | ^al [--^dependencies] [<項目_路徑>[ ...]]
[--^machinereadable [--^startlineseparator=<分隔符號>]
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
é¸é …:
--^dependencies å°‡æœ¬åœ°è®Šæ›´ç›¸ä¾æ€§æ–°å¢žè‡³
è¦å¥—用的項目。
é …ç›®_路徑 è¦å¥—用的項目。使用空格分隔
路徑。使用雙引號 (" ") 指定
å«ç©ºæ ¼çš„路徑。
--^machinereadable 以容易解æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„行應如何起始。
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,指定應如何
分隔欄ä½ã€‚
== CMD_HELP_APPLYLOCAL ==
備註:
如果未指定 --^dependencies å’Œ <é …ç›®_路徑>,該作業會涉åŠ
工作å€ä¸­æ‰€æœ‰æœ¬åœ°è®Šæ›´ã€‚
一律會從指定路徑進行éžè¿´å¥—用。
範例:
cm ^applylocal foo.c bar.c
cm ^applylocal .
(在目å‰ç›®éŒ„中套用所有本地變更。)
cm ^applylocal
(在工作å€ä¸­å¥—用所有本地變更。)
cm ^applylocal --^machinereadable
(在工作å€ä¸­å¥—用所有本地變更,並以
簡化的易於剖æžçš„æ ¼å¼åˆ—å°çµæžœã€‚)
cm ^applylocal --^machinereadable --^startlineseparator=">" \
--^endlineseparator="<" --^fieldseparator=","
(在工作å€ä¸­å¥—用所有本地變更,並以簡化ã€
易於剖æžçš„æ ¼å¼åˆ—å°çµæžœï¼Œä½¿ç”¨æŒ‡å®šçš„字串來
èµ·å§‹å’ŒçµæŸè¡Œï¼Œä»¥åŠåˆ†é𔿬„ä½ã€‚)
== CMD_DESCRIPTION_ARCHIVE ==
外部儲存å€ä¸­çš„å°å­˜è³‡æ–™ã€‚
== CMD_USAGE_ARCHIVE ==
用法:
cm ^archive | ^arch <ä¿®è¨‚è¦æ ¼>[ ...][-^c | --^comment=<字串_註解>]
[--^file=<基底_檔案>]
(從儲存庫擷å–資料,並將其存放在外部儲存å€ã€‚)
cm ^archive | ^arch <ä¿®è¨‚è¦æ ¼>[ ...]--^restore
(將先å‰å°å­˜çš„修訂還原至儲存庫。)
ä¿®è¨‚è¦æ ¼ ä¸€æˆ–å¤šå€‹ä¿®è¨‚è¦æ ¼ã€‚å¯ä»¥ä½¿ç”¨ã€Œ-ã€ä¿®é£¾è©ž
從 STDIN 讀å–。(使用 'cm ^help ^objectspec' 以
æ·±å…¥çž­è§£ä¿®è¨‚è¦æ ¼ã€‚)
--^restore 從產生的å°å­˜æª”案還原先å‰å°å­˜
的資料。
é¸é …:
-^c | --^comment 在è¦å»ºç«‹çš„å°å­˜å„²å­˜æª”案中設定註解。
--^file æ–°å°å­˜è³‡æ–™æª”案的å稱首碼和 (é¸ç”¨)
路徑。
== CMD_HELP_ARCHIVE ==
備註:
此命令會從儲存庫資料庫擷å–資料,並將其存放在
外部儲存å€ï¼Œç¯€çœè³‡æ–™åº«ç©ºé–“。
此命令也會將先å‰å°å­˜çš„修訂還原至
儲存庫資料庫 (--^restore)。
使用 'cm ^help ^objectspec' ä»¥çž­è§£å¦‚ä½•æŒ‡å®šä¿®è¨‚è¦æ ¼ã€‚
執行此命令的使用者必須是 Unity VCS 伺æœå™¨ç®¡ç†å“¡
(儲存庫伺æœå™¨æ“有者),æ‰èƒ½å®Œæˆæ­¤ä½œæ¥­ã€‚
來自指定修訂的æ¯å€‹è³‡æ–™å€æ®µå°‡å­˜æ”¾åœ¨
ä¸åŒæª”案中,其å稱以 --^file
引數定義的值為開頭。該引數å¯ä»¥åŒ…å«å®Œæ•´çš„路徑值,包括未來å°å­˜æª”案
的首碼,也å¯ä»¥åƒ…包括此首碼值。
å°å­˜å¾Œï¼ŒæŒ‡å®šä¿®è¨‚的資料å¯ä»¥é€éŽå…©ç¨®æ–¹å¼
å­˜å–:
- å¾žç”¨æˆ¶ç«¯ï¼šç”¨æˆ¶ç«¯å°‡åµæ¸¬è³‡æ–™æ˜¯å¦å·²å°å­˜ï¼Œè€Œä¸”
å°‡æç¤ºä½¿ç”¨è€…輸入檔案ä½ç½®ã€‚
使用者å¯ä»¥è—‰ç”±å»ºç«‹å為 externaldata.conf 的檔案
來設定外部資料ä½ç½® (在標準設定檔案ä½ç½®ï¼Œä½¿ç”¨
é©ç”¨æ–¼ client.conf 檔案的相åŒè¦å‰‡),包å«
å°å­˜è³‡æ–™æ‰€åœ¨çš„路徑。
- 從伺æœå™¨ï¼šä½¿ç”¨æ­¤æ–¹æ³•的使用者ä¸å¿…知é“資料是å¦
å°å­˜ï¼Œå› ç‚ºä¼ºæœå™¨å°‡æœƒæ˜Žç¢ºåœ°è§£æž
è¦æ±‚。若è¦åŸ·è¡Œæ­¤ä½œæ¥­ï¼Œç®¡ç†å“¡å°‡æœƒåœ¨ä¼ºæœå™¨ç›®éŒ„中
建立å為 externaldata.conf 的檔案,並填入
å°å­˜ç£ç¢Ÿæ©Ÿæ‰€åœ¨çš„路徑。
è‹¥è¦å–消å°å­˜ (還原) 修訂 (或修訂集åˆ),用戶端必須è¦èƒ½å¤ 
å­˜å–å°å­˜çš„æª”æ¡ˆã€‚å› æ­¤ï¼Œç„¡æ³•å–æ¶ˆå°å­˜
伺æœå™¨ (方法 2) 所解æžçš„資料,因為用戶端
將無法將該資料識別為已å°å­˜ã€‚如果使用方法 2,若è¦
æˆåŠŸå–æ¶ˆå°å­˜ï¼Œç®¡ç†å“¡å¿…須先編輯 externaldata.conf
伺æœå™¨æª”案,æ‰èƒ½ç§»é™¤å¿…é ˆå–æ¶ˆå°å­˜ä¹‹
å°å­˜æª”æ¡ˆçš„å­˜å–æ¬Šã€‚
設定 PLASTICEDITOR 環境變數,以指定è¦è¼¸å…¥è¨»è§£
的編輯器。
範例:
cm ^archive bigfile.zip#^br:/main
(在分支 'main' 中å°å­˜ 'bigfile.zip' 的最後一個修訂。)
cm ^archive ^rev:myfile.pdf#^cs:2 -^c="大型 pdf 檔案" --^file=c:\arch_files\arch
(å°å­˜ 'c:\archived_files' è³‡æ–™å¤¾ä¸­å° myfile.pdf 的變更集 2
的修訂。å°å­˜æª”案å稱將以 'arch' 為開頭 (例如,arch_11_56)。)
cm ^find "^revs ^where ^size > 26214400" --^format="{^item}#{^branch}" \
--^nototal | cm ^archive --^comment="volume00" --^file="volume00" -
(將所有大於 25Mb 的所有檔案å°å­˜åœ¨å稱以 'volume00' 為開頭
的檔案中。)
cm ^find "^revs ^where ^size > 26214400 ^and ^archived='true'" \
--^format="{^item}#{^branch}" --^nototal | cm ^archive --^restore
(還原大於 25Mb 的所有å°å­˜æª”案。)
== CMD_DESCRIPTION_ATTRIBUTE ==
å¯è®“使用者管ç†å±¬æ€§ã€‚
== CMD_USAGE_ATTRIBUTE ==
用法:
cm ^attribute | ^att <命令> [é¸é …]
命令:
^create | ^mk
^delete | ^rm
^set
^unset
^rename
^edit
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^attribute <命令> --^usage
cm ^attribute <命令> --^help
== CMD_HELP_ATTRIBUTE ==
範例:
cm ^attribute ^create 狀態
cm ^attribute ^set ^att:status ^br:/main/SCM105 未解決
cm ^attribute ^unset ^att:status ^br:/main/SCM105
cm ^attribute ^delete ^att:status
cm ^attribute ^rename ^att:status "組建狀態"
cm ^attribute ^edit ^att:status "CI 管線中的任務狀態"
== CMD_DESCRIPTION_CHANGELIST ==
分組變更清單中暫止的變更。
== CMD_USAGE_CHANGELIST ==
用法:
a) 變更清單物件的管ç†ï¼š
cm ^changelist | ^clist [--^symlink]
(顯示所有變更清單。)
cm ^changelist | ^clist ^add <變更清單_å稱>
[<變更清單_æè¿°>] [--^persistent | --^notpersistent] [--^symlink]
(建立變更清單。)
cm ^changelist | ^clist ^rm <變更清單_å稱> [--^symlink]
(移除é¸å–çš„è®Šæ›´æ¸…å–®ã€‚å¦‚æžœæ­¤è®Šæ›´æ¸…å–®åŒ…å«æš«æ­¢çš„變更,
則這些將移動至 ^default 變更清單。)
cm ^changelist | ^clist ^edit <變更清單_å稱> [<動作_å稱> <動作_值>]
[--^persistent | --^notpersistent] [--^symlink]
(編輯é¸å–的變更清單。)
b) ç®¡ç†æŒ‡å®šè®Šæ›´æ¸…單的內容:
cm ^changelist | ^clist <變更清單_å稱> (^add | ^rm) <路徑_å稱>[ ...]
[--^symlink]
(藉由新增 ('^add') 或移除 ('^rm')
ç¬¦åˆæŒ‡å®šè·¯å¾‘å稱的變更,新增é¸å–的變更清單。使用空格
分隔路徑_å稱。使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。路徑狀態必須是 '^Added' 或 '^Checked-out'。)
é¸é …:
變更清單_å稱 變更清單的å稱。
變更清單_æè¿° 變更清單的æè¿°ã€‚
動作_å稱 鏿“‡ '^rename' 或 '^description' 以編輯
變更清單。
動作_值 編輯變更清單時,套用新å稱或
æ–°æè¿°ã€‚
--^persistent å³ä½¿ç°½å…¥æˆ–復原變更清單的內容,變更清單
ä»å°‡ä¿ç•™å·¥ä½œå€ä¸­ã€‚
--^notpersistent (é è¨­) å³ä½¿ç°½å…¥æˆ–復原變更清單的內容,
è®Šæ›´æ¸…å–®ä¹Ÿä¸æœƒä¿ç•™åœ¨
工作å€ä¸­ã€‚
--^symlink 將作業套用至符號連çµï¼Œè€Œä¸æ˜¯å¥—用至
目標。
== CMD_HELP_CHANGELIST ==
備註:
'^changelist' 命令會處ç†å·¥ä½œå€æš«æ­¢çš„變更清單以åŠ
變更清單中包å«çš„變更。
範例:
cm ^changelist
(顯示目å‰å·¥ä½œå€è®Šæ›´æ¸…單。)
cm ^changelist ^add 組態_變更 "dotConf 檔案" --^persistent
(建立å稱為 '組態_變更' 且æè¿°ç‚º 'dotConf 檔案'
的新變更清單,一旦暫止的變更清單已簽入或已復原,
該變更清單都將æŒçºŒä¿ç•™åœ¨ç›®å‰å·¥ä½œå€ä¸­ã€‚)
cm ^changelist ^edit 組態_變更 ^rename 組態_檔案 --^notpersistent
(編輯å稱為 '組態_變更' çš„è®Šæ›´æ¸…å–®ï¼Œä¸¦å°‡å…¶é‡æ–°å‘½å為
'組態_檔案'。此外,它會將變更清單轉變æˆã€ŒéžæŒçºŒã€ã€‚)
cm ^changelist ^edit 組態_變更 --^notpersistent
(編輯å稱為 '組態_變更' 的變更清單,並將它轉變æˆã€ŒéžæŒçºŒã€ã€‚)
cm ^changelist ^rm 組態_檔案
(將暫止的變更清單 '組態_檔案' 從目å‰å·¥ä½œå€ä¸­ç§»é™¤ã€‚)
cm ^changelist 組態_檔案 ^add foo.conf
(將檔案 'foo.conf' 新增至 '組態_檔案' 變更清單。)
cm ^changelist 組態_檔案 ^rm foo.conf readme.txt
(將檔案 'foo.conf' 和 'readme.txt' 從 '組態_檔案' 變更清單中移除,
並將檔案移動至系統é è¨­è®Šæ›´æ¸…單。)
== CMD_DESCRIPTION_CHANGESET ==
在變更集執行進階æ“作。
== CMD_USAGE_CHANGESET ==
用法:
cm ^changeset <命令> [é¸é …]
命令:
^move | ^mv
^delete | ^rm
^editcomment | ^edit
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^changeset <命令> --^usage
cm ^changeset <命令> --^help
== CMD_HELP_CHANGESET ==
範例:
cm ^changeset ^move ^cs:15@myrepo ^br:/main/scm005@myrepo
cm ^changeset ^delete ^cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData
== CMD_DESCRIPTION_CHANGESET_EDITCOMMENT ==
修改變更集的註解。
== CMD_USAGE_CHANGESET_EDITCOMMENT ==
用法:
cm ^changeset ^editcomment | ^edit <è®Šæ›´é›†è¦æ ¼> <æ–°_註解>
é¸é …:
è®Šæ›´é›†è¦æ ¼ 將編輯註解的目標變更集。
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
è¦æ ¼ã€‚)
新_註解 將新增至鎖定目標之變更集的
新註解。
== CMD_HELP_CHANGESET_EDITCOMMENT ==
備註:
- éŽ–å®šç›®æ¨™çš„è®Šæ›´é›†è¦æ ¼å¿…須有效。
範例:
cm ^changeset ^editcomment ^cs:15@myrepo "我忘記新增簽入詳細資料"
cm ^changeset ^edit ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
"此註解文字將å–代先å‰çš„註解文字。"
== CMD_DESCRIPTION_CHANGESET_MOVE ==
將變更集åŠå…¶æ‰€æœ‰ä¸‹å±¤ç§»å‹•至ä¸åŒçš„分支。
== CMD_USAGE_CHANGESET_MOVE ==
用法:
cm ^changeset ^move | ^mv <è®Šæ›´é›†è¦æ ¼> <åˆ†æ”¯è¦æ ¼>
é¸é …:
è®Šæ›´é›†è¦æ ¼ è¦ç§»å‹•至ä¸åŒåˆ†æ”¯çš„第一個變更集。相åŒ
分支中的所有下層變更集也會
由命令鎖定目標。
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
è¦æ ¼ã€‚)
åˆ†æ”¯è¦æ ¼ 存放鎖定目標之變更集的目標
分支。須為空白或ä¸å­˜åœ¨ï¼›å¦‚æžœ
目的地分支ä¸å­˜åœ¨ï¼Œå°‡ç”±å‘½ä»¤
建立一個。
(使用 'cm ^help ^objectspec' 以深入瞭解分支
è¦æ ¼ã€‚)
== CMD_HELP_CHANGESET_MOVE ==
備註:
- éŽ–å®šç›®æ¨™çš„è®Šæ›´é›†è¦æ ¼å¿…須有效。
- 目的地分支須為空白或ä¸å­˜åœ¨ã€‚
- 如果目的地分支ä¸å­˜åœ¨ï¼Œå°‡æœƒå»ºç«‹ä¸€å€‹ã€‚
- åˆä½µé€£çµå°‡ä¿æŒä¸è®Šï¼Œå› ç‚ºåˆ†æ”¯ä¸æœƒå½±éŸ¿é€™äº›é€£çµã€‚
範例:
cm ^changeset ^move ^cs:15@myrepo ^br:/main/scm005@myrepo
cm ^changeset ^move ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a ^br:/hotfix/TL-352
== CMD_DESCRIPTION_CHANGESET_DELETE ==
從儲存庫中刪除變更集。
== CMD_USAGE_CHANGESET_DELETE ==
用法:
cm ^changeset ^delete | ^rm <è®Šæ›´é›†è¦æ ¼>
é¸é …:
è®Šæ›´é›†è¦æ ¼ è¦ç§»é™¤çš„目標變更集。必須滿足
æŸäº›ç‰¹å®šæ¢ä»¶ã€‚如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
è¦æ ¼ã€‚)
== CMD_HELP_CHANGESET_DELETE ==
備註:
- 目標變更集必須是其分支的最後一個。
- 目標變更集ä¸å¯ç‚ºä»»ä½•其他變更集的上層。
- 目標變更集ä¸èƒ½æ˜¯åˆä½µé€£çµçš„來æºï¼Œä¹Ÿä¸èƒ½æ˜¯
作為來æºä¹‹é–“éš”åˆä½µçš„一部分。
- 沒有標籤必須套用至目標變更集。
- 目標變更集ä¸å¾—為根變更集 ('^cs:0')
範例:
cm ^changeset ^rm ^cs:4525@myrepo@myserver
cm ^changeset ^delete ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a
== CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
變更使用者密碼 (UP)。
== CMD_USAGE_CHANGEUSERPASSWORD ==
用法:
cm ^changepassword | ^passwd
== CMD_HELP_CHANGEUSERPASSWORD ==
備註:
æ­¤å‘½ä»¤åªæœ‰åœ¨å®‰å…¨æ€§è¨­å®šç‚º UP (使用者/密碼) 時
æ‰å¯ä½¿ç”¨ã€‚如需詳細資訊,請åƒé–±ã€Šç®¡ç†æŒ‡å—》。
需è¦èˆŠå¯†ç¢¼èˆ‡æ–°å¯†ç¢¼ã€‚
範例:
cm ^passwd
== CMD_DESCRIPTION_CHECKCONNECTION ==
檢查與伺æœå™¨çš„連線。
== CMD_USAGE_CHECKCONNECTION ==
用法:
cm ^checkconnection | ^cc
== CMD_HELP_CHECKCONNECTION ==
備註:
- 此命令會傳回訊æ¯ï¼ŒæŒ‡å‡ºè¨­å®šçš„ Unity VCS
伺æœå™¨æ˜¯å¦å…·å‚™æœ‰æ•ˆé€£ç·šã€‚
- æ­¤å‘½ä»¤æœƒæª¢æŸ¥è¨­å®šçš„ä½¿ç”¨è€…æ˜¯å¦æœ‰æ•ˆã€‚它也會
檢查與伺æœå™¨çš„版本相容性。
== CMD_DESCRIPTION_CHECKDB ==
檢查儲存庫完整性。
== CMD_USAGE_CHECKDB ==
用法:
cm ^checkdatabase | ^chkdb [<儲存庫伺æœå™¨è¦æ ¼> | <å„²å­˜åº«è¦æ ¼>]
使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺æœå™¨èˆ‡å„²å­˜åº«è¦æ ¼ã€‚
== CMD_HELP_CHECKDB ==
備註:
- 如果未指定儲存庫伺æœå™¨è¦æ ¼ï¼Œä¹ŸæœªæŒ‡å®šå„²å­˜åº«è¦æ ¼ï¼Œ
將會在 client.conf 檔案中指定的伺æœå™¨ä¸­åŸ·è¡Œæª¢æŸ¥ã€‚
範例:
cm ^checkdatabase ^repserver:localhost:8084
cm ^chkdb ^rep:default@localhost:8084
== CMD_DESCRIPTION_CHECKIN ==
在此儲存庫中儲存變更。
== CMD_USAGE_CHECKIN ==
用法:
cm ^checkin | ^ci [<項目_路徑>[ ...]]
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
[--^all|-^a] [--^applychanged] [--^private] [--^update] [--^symlink]
[--^noshowchangeset]
[--^machinereadable [--^startlineseparator=<分隔符號>]
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
é¸é …:
é …ç›®_路徑 è¦ç°½å…¥çš„項目。使用雙引號 (" ")
指定å«ç©ºæ ¼çš„路徑。使用空格
分隔項目路徑。
使用 . 將簽入套用至目å‰ç›®éŒ„。
-^c 將指定的註解套用至
簽入作業中建立的變更集。
-^commentsfile 將指定檔案中的註解套用至
簽入作業中建立的變更集。
--^all | -^a 指定路徑上在本地變更ã€ç§»å‹•和刪除的項目
也包括在內。
--^applychanged 將簽入作業套用至
工作å€ä¸­åµæ¸¬åˆ°çš„變更項目,以åŠç°½å‡º
項目。
--^private 工作å€ä¸­åµæ¸¬åˆ°çš„ç§äººé …目也
包括在內。
--^update 如果最終發生此情æ³ï¼Œ
æœƒè‡ªå‹•è™•ç†æ›´æ–°åˆä½µã€‚
--^symlink 將簽入作業套用至符號連çµï¼Œè€Œä¸æ˜¯
套用至目標。
--^noshowchangeset ä¸åˆ—å°çµæžœè®Šæ›´é›†ã€‚
--^machinereadable 以容易解æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„行應如何起始。
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,指定應
如何分隔欄ä½ã€‚
== CMD_HELP_CHECKIN ==
備註:
- 如果未指定 <é …ç›®_路徑>,簽入會涉åŠå·¥ä½œå€ä¸­
所有暫止的變更。
- 簽入作業一律會從指定路徑進行éžè¿´å¥—用。
- è‹¥è¦ç°½å…¥é …目:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
- 如果項目是ç§äººçš„ (未å—到原始程å¼ç¢¼æŽ§åˆ¶)ï¼Œå‰‡éœ€è¦æœ‰ --^private
標誌,æ‰èƒ½ç°½å…¥è©²é …目。
- 必須簽出項目。
- 如果項目已變更,但未簽出,則ä¸ä¸€å®šè¦æœ‰ --^applychanged 標誌,
é™¤éž <é …ç›®_路徑> 是目錄,或包å«
è¬ç”¨å­—å…ƒ ('*')。
修訂內容應該與先å‰ä¿®è¨‚ä¸åŒï¼Œæ‰èƒ½
簽入。
設定 PLASTICEDITOR 環境變數,以指定è¦è¼¸å…¥
註解的編輯器。
從 stdin 讀å–輸入:
'^checkin' 命令å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯å‚³éžå–®ä¸€
破折號「-ã€ä¾†å®Œæˆã€‚
範例:cm ^checkin -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“您使用管線以指定è¦ç°½å…¥çš„æª”案。
範例:
dir /S /B *.c | cm ^checkin --^all -
(在 Windows 中,簽入工作å€ä¸­æ‰€æœ‰ .c 檔案。)
範例:
cm ^checkin file1.txt file2.txt
(簽入 'file1.txt' 和 'file2.txt' 簽出檔案。)
cm ^checkin .-^commentsfile=mycomment.txt
(簽入目å‰ç›®éŒ„,並在 'mycomment.txt' 檔案中
設定註解。)
cm ^checkin é€£çµ --^symlink
(簽入 '連çµ' 檔案,而éžç›®æ¨™ï¼›é©ç”¨æ–¼ UNIX
環境。)
cm ^ci file1.txt -^c="我的註解"
(簽入 'file1.txt' 並包å«è¨»è§£ã€‚)
cm ^status --^short --^compact --^changelist=暫止_待_檢閱 | cm ^checkin -
(列出變更清單中å稱為 '暫止_å¾…_檢閱' 的路徑,並將此清單
釿–°å°Žå‘簽入命令的輸入。)
cm ^ci .--^machinereadable
(簽入目å‰ç›®éŒ„ï¼Œä¸¦ä»¥ç°¡åŒ–ã€æ˜“於剖æž
的格å¼ä¾†åˆ—å°çµæžœã€‚)
cm ^ci .--^machinereadable --^startlineseparator=">" --^endlineseparator="<" --^fieldseparator=","
(簽入目å‰ç›®éŒ„ï¼Œä¸¦ä»¥ç°¡åŒ–ã€æ˜“於剖æžçš„æ ¼å¼
來列å°çµæžœï¼Œä½¿ç”¨æŒ‡å®šçš„字串起始行
å’Œçµå°¾è¡Œï¼Œä»¥åŠåˆ†é𔿬„ä½ã€‚)
== CMD_DESCRIPTION_CHECKOUT ==
將檔案標示為準備好修改。
== CMD_USAGE_CHECKOUT ==
用法:
cm ^checkout | ^co [<項目_路徑>[ ...]] [-^R | -^r | --^recursive]
[--^format=<字串_æ ¼å¼>]
[--^errorformat=<字串_æ ¼å¼>] [--^resultformat=<字串_æ ¼å¼>]
[--^silent] [--^symlink] [--^ignorefailed]
[--^machinereadable [--^startlineseparator=<分隔符號>]
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
é¸é …:
é …ç›®_路徑 è¦ç°½å‡ºçš„項目。使用雙引號 (" ")
指定å«ç©ºæ ¼çš„路徑。使用空格
分隔項目路徑。
使用 . 將簽出套用至目å‰ç›®éŒ„。
-^R éžè¿´ç°½å‡ºæª”案。
--^format 以指定的
æ ¼å¼æ“·å–輸出進度訊æ¯ã€‚如需詳細資訊,請查看範例。
--^errorformat 以指定的
æ ¼å¼æ“·å–éŒ¯èª¤è¨Šæ¯ (如果有的話)。如需詳細資訊,請查看範例。
--^resultformat ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出
çµæžœè¨Šæ¯ã€‚如需詳細資訊,請查看範例。
--^silent 完全ä¸é¡¯ç¤ºä»»ä½•輸出。
--^symlink 將簽出作業套用至符號連çµï¼Œè€Œéž
套用至目標。
--^ignorefailed 如果無法鎖定項目 (無法執行ç¨ä½”簽出
),則會在沒有項目的情æ³ä¸‹ï¼Œ
繼續進行簽出作業。
--^machinereadable 以容易解æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„行應如何起始。
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,指定應
如何分隔欄ä½ã€‚
== CMD_HELP_CHECKOUT ==
備註:
è‹¥è¦ç°½å‡ºé …目:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
- 必須簽入項目。
如果在伺æœå™¨ä¸Šå·²è¨­å®šéŽ–å®š (lock.conf 存在)ï¼Œé‚£éº¼æ¯æ¬¡åœ¨è·¯å¾‘上
發生簽出時,Unity VCS 會檢查其是å¦ç¬¦åˆä»»ä½•è¦å‰‡ï¼Œå¦‚果符åˆï¼Œ
該路徑會處於ç¨ä½”簽出 (已鎖定),如此一來,就沒有人
å¯ä»¥åŒæ™‚簽出。
您å¯ä»¥ä½¿ç”¨ 'cm ^lock ^list' 以å–得伺æœå™¨ä¸­çš„æ‰€æœ‰éŽ–å®šã€‚
如需詳細資訊,請åƒé–±ã€Šç®¡ç†æŒ‡å—》:
https://www.plasticscm.com/download/help/adminguide
æ ¼å¼å­—串會將é ç•™ä½ç½® '{0}' å–代為待簽出項目
的路徑。請查看範例,瞭解使用方法。
從 stdin 讀å–輸入:
'^checkout' 命令å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯å‚³éžå–®ä¸€
破折號「-ã€ä¾†å®Œæˆã€‚
範例:cm ^checkout -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“您使用管線以指定è¦ç°½å‡ºçš„æª”案。
範例:
dir /S /B *.c | cm ^checkout -
(在 Windows 中,簽出工作å€ä¸­æ‰€æœ‰ .c 檔案。)
範例:
cm ^checkout file1.txt file2.txt
(簽出 'file1.txt' 和 'file2.txt' 檔案。)
cm ^co *.txt
(簽出所有 txt 檔案。)
cm ^checkout .
(簽出目å‰ç›®éŒ„。)
cm ^checkout -^R c:\workspace\src
žè¿´ç°½å‡º 'src' 資料夾。)
cm ^co file.txt --^format="正在簽出項目 {0}"
--^errorformat="簽出項目 {0} 時發生錯誤" /
--^resultformat="項目 {0} 已簽出"
(使用指定的格å¼å­—串簽出 'file.txt',
以顯示作業的進度ã€çµæžœå’ŒéŒ¯èª¤ã€‚)
cm ^checkout é€£çµ --^symlink
(簽出 '連çµ' 檔案,而éžç›®æ¨™ï¼›é©ç”¨æ–¼ UNIX
環境。)
cm ^checkout .-^R --^ignorefailed
žè¿´ç°½å‡ºç›®å‰è³‡æ–™å¤¾ï¼Œå¿½ç•¥ç„¡æ³•簽出
的檔案。)
cm ^co .--^machinereadable --^startlineseparator=">"
(簽出目å‰ç›®éŒ„ï¼Œä»¥ç°¡åŒ–ã€æ˜“於剖æžçš„æ ¼å¼ä¾†åˆ—å°çµæžœï¼Œ
並使用指定的字串起始行。)
== CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
æª¢æŸ¥é¸æ“‡å™¨çš„語法。
== CMD_USAGE_CHECKSELECTORSYNTAX ==
用法:
cm ^checkselectorsyntax | ^css --^file=<鏿“‡å™¨_檔案>
(æª¢æŸ¥é¸æ“‡å™¨æª”案語法。)
^cat <鏿“‡å™¨_檔案> | cm ^checkselectorsyntax | ^css -
(Unixã€‚å¾žæ¨™æº–è¼¸å…¥æª¢æŸ¥é¸æ“‡å™¨æª”案。)
^type <鏿“‡å™¨_檔案> | cm ^checkselectorsyntax | ^css -
(Windowsã€‚å¾žæ¨™æº–è¼¸å…¥æª¢æŸ¥é¸æ“‡å™¨æª”案。)
--^file è¦å¾žä¸­è®€å–鏿“‡å™¨çš„æª”案。
== CMD_HELP_CHECKSELECTORSYNTAX ==
備註:
æ­¤å‘½ä»¤æœƒè®€å–æª”æ¡ˆæˆ–æ¨™æº–è¼¸å…¥ä¸Šçš„é¸æ“‡å™¨ï¼Œä¸¦æª¢æŸ¥å…¶
是å¦ç‚ºæœ‰æ•ˆèªžæ³•。如果語法檢查失敗,原因會
列å°åœ¨æ¨™æº–輸出上。
範例:
cm ^checkselectorsyntax --^file=myselector.txt
(檢查 'myselector.txt' 檔案的語法。)
^cat myselector.txt | cm ^checkselectorsyntax
(從標準輸入檢查 'myselector.txt' 的語法。)
== CMD_DESCRIPTION_CHANGEREVISIONTYPE ==
變更項目修訂類型 (äºŒé€²ä½æˆ–文字)。
== CMD_USAGE_CHANGEREVISIONTYPE ==
用法:
cm ^changerevisiontype | ^chgrevtype | ^crt <項目_路徑>[ ...]--^type=(^bin | ^txt)
é …ç›®_路徑 è¦è®Šæ›´ä¿®è¨‚類型的項目。使用雙引號 (" ")
指定å«ç©ºæ ¼çš„路徑。使用空格
分隔項目路徑。
--^type ç›®æ¨™ä¿®è¨‚é¡žåž‹ã€‚é¸æ“‡ '^bin' 或 '^txt'。
== CMD_HELP_CHANGEREVISIONTYPE ==
備註:
此命令åªèƒ½å¥—用至檔案,而無法套用至目錄。
指定的類型必須是系統支æ´çš„類型:'^bin' 或 '^txt' (二進ä½
或文字)。
範例:
cm ^changerevisiontype c:\workspace\file.txt --^type=^txt
(將 'file.txt' 修訂類型變更為文字。)
cm ^chgrevtype comp.zip "image file.jpg" --^type=^bin
(å°‡ 'comp.zip' å’Œ "image file.jpg" 修訂類型變更為二進ä½ã€‚)
cm ^crt *.* --^type=^txt
(將所有檔案的修訂類型變更為文字。)
== CMD_DESCRIPTION_TRIGGER_EDIT ==
編輯觸發器。
== CMD_USAGE_TRIGGER_EDIT ==
用法:
cm ^trigger | ^tr ^edit <å­é¡žåž‹_類型> <ä½ç½®_號碼>
[--^position=<æ–°_ä½ç½®>]
[--^name=<æ–°_å稱>] [--^script=<指令碼_路徑>]
[--^filter=<字串_篩é¸>] [--^server=<儲存庫伺æœå™¨è¦æ ¼>]
å­é¡žåž‹_類型 觸發器執行與觸發器作業。
輸入 'cm ^showtriggertypes' 以查看觸發器
類型的清單。
ä½ç½®_號碼 待修改之觸發器所佔的ä½ç½®ã€‚
é¸é …:
--^position 指定觸發器的新ä½ç½®ã€‚
æ­¤ä½ç½®ä¸å¾—由其他相åŒé¡žåž‹çš„
觸發器使用。
--^name 指定觸發器的新å稱。
--^script 指定觸發器指令碼的新執行路徑。
如果指令碼開頭為 "^webtrigger",該指令碼將
視為 Web 觸發器。如需進一步的詳細資料,
è«‹åƒé–±å‚™è¨»ã€‚
--^filter 僅檢查符åˆå·²æŒ‡å®šç¯©é¸æ¢ä»¶çš„項目。
--^server 在指定的伺æœå™¨ä¸Šä¿®æ”¹è§¸ç™¼å™¨ã€‚
如果未指定任何伺æœå™¨ï¼Œè«‹åœ¨ç”¨æˆ¶ç«¯ä¸Šè¨­å®šçš„
伺æœå™¨ä¸ŠåŸ·è¡Œå‘½ä»¤ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解伺æœå™¨
è¦æ ¼ã€‚)
== CMD_HELP_TRIGGER_EDIT ==
備註:
Web 觸發器:藉由輸入 "^webtrigger <目標-uri>"
åšç‚ºè§¸ç™¼å™¨å‘½ä»¤ï¼Œä»¥å»ºç«‹ Web 觸發器。在此情æ³ä¸‹ï¼Œè§¸ç™¼å™¨å°‡å°æ‡‰æŒ‡å®šçš„ URI 來執行 POST 查詢,
å…¶ä¸­è¦æ±‚本文包å«å…·æœ‰è§¸ç™¼å™¨ç’°å¢ƒè®Šæ•¸çš„ JSON
字典,以åŠ
指å‘字串陣列的 INPUT 金鑰。
範例:
cm ^trigger ^edit ^after-setselector 6 --^name="Backup2 管ç†å“¡" --^script="/new/path/al/script"
cm ^tr ^edit ^before-mklabel 7 --^position=4 --^server=myserver:8084
cm ^trigger ^edit ^after-add 2 --^script="^webtrigger http://myserver.org/api"
== CMD_DESCRIPTION_CODEREVIEW ==
建立ã€ç·¨è¼¯æˆ–刪除程å¼ç¢¼æª¢é–±ã€‚
== CMD_USAGE_CODEREVIEW ==
用法:
cm ^codereview <è¦æ ¼> <標題> [--^status=<狀態_å稱>]
[--^assignee=<使用者_å稱>] [--^format=<字串_æ ¼å¼>]
[--^repository=<儲存庫_è¦æ ¼>]
(建立程å¼ç¢¼æª¢é–±ã€‚)
cm ^codereview -^e <ID> [--^status=<狀態_å稱>] [--^assignee=<使用者_å稱>]
[--^repository=<儲存庫_è¦æ ¼>]
(編輯程å¼ç¢¼æª¢é–±ã€‚)
cm ^codereview -^d <ID> [ ...][--^repository=<儲存庫_è¦æ ¼>]
(刪除一或多個程å¼ç¢¼æª¢é–±ã€‚)
è¦æ ¼ è¦æ ¼å¯èƒ½æ˜¯è®Šæ›´é›†è¦æ ¼æˆ–åˆ†æ”¯è¦æ ¼ã€‚
è©²è¦æ ¼å°‡æœƒæ˜¯æ–°ç¨‹å¼ç¢¼æª¢é–±çš„目標。(使用
'cm ^help ^objectspec' 以深入瞭解變更集或
åˆ†æ”¯è¦æ ¼ã€‚)
標題 åšç‚ºæ–°
程å¼ç¢¼æª¢é–±æ¨™é¡Œçš„æ–‡å­—字串。
ID 程å¼ç¢¼æª¢é–±è­˜åˆ¥ç¢¼ã€‚也å¯ä»¥ä½¿ç”¨
GUID。
é¸é …:
-^e ç·¨è¼¯ç¾æœ‰ç¨‹å¼ç¢¼æª¢é–±çš„åƒæ•¸ã€‚
-^d åˆªé™¤ä¸€æˆ–å¤šå€‹ç¾æœ‰çš„程å¼ç¢¼æª¢é–±ã€‚使用
空格來分隔程å¼ç¢¼æª¢é–± ID。
--^status 設定程å¼ç¢¼æª¢é–±çš„æ–°ç‹€æ…‹ã€‚如需其他資訊,
è«‹åƒé–±å‚™è¨»ã€‚
--^assignee 設定程å¼ç¢¼æª¢é–±æ–°çš„å—æŒ‡æ´¾è€…。
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
其他資訊,請åƒé–±å‚™è¨»ã€‚
--^repository 設定è¦åšç‚ºé è¨­ä½¿ç”¨çš„儲存庫。(使用
'cm ^help ^objectspec' 以深入瞭解儲存庫
è¦æ ¼ã€‚)
== CMD_HELP_CODEREVIEW ==
備註:
此命令å¯è®“使用者管ç†ç¨‹å¼ç¢¼æª¢é–±ï¼šå»ºç«‹ã€ç·¨è¼¯å’Œåˆªé™¤
變更集或分支的程å¼ç¢¼æª¢é–±ã€‚
è‹¥è¦å»ºç«‹æ–°çš„程å¼ç¢¼æª¢é–±ï¼Œéœ€è¦è®Šæ›´é›†/åˆ†æ”¯è¦æ ¼
和標題。也å¯ä»¥è¨­å®šåˆå§‹ç‹€æ…‹å’Œå—æŒ‡æ´¾è€…ã€‚çµæžœæœƒå‚³å›ž ID
(或 GUID,如果有的話)。
è‹¥è¦ç·¨è¼¯æˆ–åˆªé™¤ç¾æœ‰çš„程å¼ç¢¼æª¢é–±ï¼Œéœ€è¦æœ‰ç›®æ¨™ç¨‹å¼ç¢¼æª¢é–± ID
(或 GUID)ã€‚å¦‚æžœæ²’æœ‰éŒ¯èª¤ï¼Œå‰‡ä¸æœƒé¡¯ç¤ºä»»ä½•訊æ¯ã€‚
ç‹€æ…‹åƒæ•¸åªèƒ½æ˜¯ä»¥ä¸‹å…¶ä¸­ä¹‹ä¸€ï¼š^"Under review"
(é è¨­)ã€^"Reviewed" 或 ^"Rework required"。
å„²å­˜åº«åƒæ•¸å¯ç”¨æ–¼è¨­å®šé è¨­çš„工作中
儲存庫。當使用者想è¦åœ¨èˆ‡ç›®å‰å·¥ä½œå€ç›¸é—œçš„伺æœå™¨
ä¸åŒçš„伺æœå™¨ä¸Šç®¡ç†æª¢é–±æ™‚,或完全沒有
ç›®å‰å·¥ä½œå€æ™‚,這相當有用。
輸出格å¼è‡ªè¨‚化:
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{0} ID
{1} GUID
請注æ„,'--^format' åƒæ•¸åªæœ‰åœ¨å»ºç«‹
新的程å¼ç¢¼æª¢é–±æ™‚æ‰æœƒç”Ÿæ•ˆã€‚
範例:
cm ^codereview ^cs:1856@myrepo@myserver:8084 "我的程å¼ç¢¼æª¢é–±" --^assignee=虛設
cm ^codereview ^br:/main/task001@myrepo@myserver:8084 "我的程å¼ç¢¼æª¢é–±" \
--^status=^"Rework required" --^assignee=新人 --^format="{^id} -> {^guid}"
cm ^codereview 1367 -^e --^assignee=æ–°_å—æŒ‡æ´¾è€…
cm ^codereview -^e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --^status=已檢閱
cm ^codereview -^d 1367 --^repository=myremoterepo@myremoteserver:18084
cm ^codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -^d
== CMD_DESCRIPTION_CRYPT ==
加密密碼。
== CMD_USAGE_CRYPT ==
用法:
cm ^crypt <我的密碼>
我的密碼 è¦åŠ å¯†çš„å¯†ç¢¼ã€‚
== CMD_HELP_CRYPT ==
備註:
此命令會å°å‚³éžåšç‚ºå¼•數的指定密碼進行加密。
其設計目的是加密設定檔案中的密碼,並æé«˜
安全性。
範例:
cm ^crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
(加密資料庫設定檔案中的密碼:'db.conf'。)
== CMD_DESCRIPTION_DEACTIVATEUSER ==
åœç”¨æŽˆæ¬Šä½¿ç”¨è€…。
== CMD_USAGE_DEACTIVATEUSER ==
用法:
cm ^deactivateuser | ^du <使用者_å稱>[ ...][--^server=<å稱:連接埠>]
[--^nosolveuser]
使用者_å稱 è¦åœç”¨çš„使用者å稱。使用空格以分隔
使用者å稱。
如果是 SIDï¼Œå‰‡éœ€è¦ '--^nosolveuser'。
é¸é …:
--^server 在指定的伺æœå™¨ä¸­åœç”¨ä½¿ç”¨è€…。
如果未指定任何伺æœå™¨ï¼Œè«‹åœ¨ç”¨æˆ¶ç«¯ä¸Šè¨­å®šçš„
伺æœå™¨ä¸ŠåŸ·è¡Œå‘½ä»¤ã€‚
--^nosolveuser 使用此é¸é …ï¼Œå‘½ä»¤å°‡ä¸æœƒæª¢æŸ¥ä½¿ç”¨è€…å稱
是å¦å­˜åœ¨æ–¼é©—證系統中。此
<使用者_å稱> 必須是使用者 SID。
== CMD_HELP_DEACTIVATEUSER ==
備註:
此命令會將使用者設為éžä½œç”¨ä¸­ï¼Œç¦æ­¢è©²ä½¿ç”¨è€…使用
Unity VCS。
如需啟動 Unity VCS 使用者的詳細資訊,請åƒé–± 'cm ^activateuser'
命令。
此命令會檢查使用者是å¦å­˜åœ¨æ–¼åŸºç¤Žé©—證系統 (例如,
ActiveDirectoryã€LDAPã€ä½¿ç”¨è€…/密碼...)。
è‹¥è¦å¼·åˆ¶åœç”¨é©—證系統中ä¸å†å­˜åœ¨çš„使用者,
您å¯ä»¥ä½¿ç”¨ '--^nosolveuser' é¸é …。
範例:
cm ^deactivateuser john
cm ^du peter "mary collins"
cm ^deactivateuser john --^server=myserver:8084
cm ^deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --^nosolveuser
== CMD_DESCRIPTION_DIFF ==
顯示檔案ã€è®Šæ›´é›†å’Œæ¨™ç±¤ä¹‹é–“的差異。
== CMD_USAGE_DIFF ==
用法:
cm ^diff <è®Šæ›´é›†è¦æ ¼> | <æ¨™ç±¤è¦æ ¼> | <æ“±ç½®è¦æ ¼> [<è®Šæ›´é›†è¦æ ¼> | <æ¨™ç±¤è¦æ ¼> | <æ“±ç½®è¦æ ¼>]
[<路徑>]
[--^added] [--^changed] [--^moved] [--^deleted]
[--^repositorypaths] [--^download=<下載_路徑>]
[--^encoding=<å稱>]
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
[--^clean]
[--^format=<字串_æ ¼å¼>] [--^dateformat=<字串_æ ¼å¼>]
顯示「來æºã€è®Šæ›´é›†æˆ–擱置集與
「目的地ã€è®Šæ›´é›†æˆ–擱置集之間的差異。å¯ä½¿ç”¨è®Šæ›´é›†æˆ–æ¨™ç±¤è¦æ ¼
來指定變更集。
在æä¾›å…©ç¨®è¦æ ¼çš„æƒ…æ³ä¸‹ï¼Œç¬¬ä¸€å€‹æ˜¯å·®ç•°çš„「來æºã€ï¼›
第二個是「目的地ã€ã€‚
在僅æä¾›ä¸€ç¨®è¦æ ¼çš„æƒ…æ³ä¸‹ï¼Œã€Œä¾†æºã€å°‡æœƒæ˜¯æŒ‡å®š
「目的地ã€çš„上層變更集。
如果已指定é¸ç”¨çš„路徑,[差異比å°] 視窗將會啟動,以顯示
該檔案兩種修訂之間的差異。
cm ^diff <ä¿®è¨‚è¦æ ¼1> <ä¿®è¨‚è¦æ ¼2>
顯示一å°ä¿®è¨‚之間的差異。差異顯示在
[差異比å°] 視窗中。指定的第一個修訂將出ç¾
在左å´ã€‚
cm ^diff <åˆ†æ”¯è¦æ ¼> [--^added] [--^changed] [--^moved] [--^deleted]
[--^repositorypaths] [--^download=<下載_路徑>]
[--^encoding=<å稱>]
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
[--^clean]
[--^format=<字串_æ ¼å¼>] [--^dateformat=<字串_æ ¼å¼>]
[--^fullpaths | --^fp]
顯示分支差異。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
é¸é …:
--^added 僅列å°åŒ…嫿–°å¢žè‡³å„²å­˜åº«ä¹‹
項目的差異。
--^changed 僅列å°åŒ…å«è®Šæ›´é …ç›®
的差異。
--^moved 僅列å°åŒ…å«å·²ç§»å‹•æˆ–å·²é‡æ–°å‘½å
項目的差異。
--^deleted 僅列å°åŒ…å«å·²åˆªé™¤é …ç›®
的差異。
如果未指定 '--^added'ã€'--^changed'ã€'--^moved' 或 '--^deleted',
å‰‡æ­¤å‘½ä»¤æœƒåˆ—å°æ‰€æœ‰å·®ç•°ã€‚
'^A' 表示已新增項目。
'^C' 表示已變更項目。
'^D' 表示已刪除項目。
'^M' 表示已移動項目。左å´é …目是原始的,
å³å´é …目是目的地。
--^repositorypaths 列å°å„²å­˜åº«è·¯å¾‘,而éžå·¥ä½œå€è·¯å¾‘。
(æ­¤é¸é …會覆寫 '--^fullpaths' é¸é …。)
--^download 儲存指定的輸出路徑中的
差異內容。
--^encoding 指定輸出編碼,例如:utf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^ignore 設定指定的比較方法。
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^clean ä¸è€ƒæ…®å› åˆä½µè€Œç”¢ç”Ÿçš„差異,
僅考慮簡單簽入所建立
的差異。
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^dateformat 用於輸出日期的格å¼ã€‚
--^fullpaths, --^fp 如果å¯èƒ½ï¼Œæœƒå¼·åˆ¶åˆ—å°æª”案和目錄的
完整工作å€è·¯å¾‘。
== CMD_HELP_DIFF ==
備註:
比較方法:
^eol 忽略行尾差異。
^whitespaces 忽略空格差異。
^"eol&whitespaces" 忽略行尾和空格差異。
^none 嵿¸¬è¡Œå°¾å’Œç©ºæ ¼å·®ç•°ã€‚
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„åƒæ•¸å¦‚下所示:
{^path} 項目路徑。
{^date} 變更日期/時間。
{^owner} 變更作者。
{^revid} 差異中視為目的地之修訂的
修訂 ID。
{^parentrevid} 差異中視為目的地之修訂上層的
修訂 ID。
{^baserevid} 差異中視為來æºä¹‹ä¿®è¨‚çš„
修訂 ID。
{^srccmpath} 移動項目 (移動作業) 之å‰çš„伺æœå™¨è·¯å¾‘。
{^dstcmpath} 移動項目 (移動作業) 之後的伺æœå™¨è·¯å¾‘。
{^type} 項目類型:
^D 目錄ã€
^B äºŒé€²ä½æª”案ã€
^F 文字檔ã€
^S 符號連çµã€
^X Xlink。
{^repository} 項目的儲存庫。
{^status} 項目狀態:
^A 已新增ã€
^D 已刪除ã€
^M 已移動ã€
^C 已變更。
{^fsprotection} é¡¯ç¤ºé …ç›®æ¬Šé™ (Linux/Mac chmod)。
{^srcfsprotection} 顯示上層修訂項目權é™ã€‚
{^newline} æ’入新行。
'^revid' 的說明:
å°æ–¼å·²æ–°å¢žçš„項目,'^baserevid' å’Œ '^parentrevid' 將會是 -1,因為
在此情æ³ä¸‹ï¼Œä¸å­˜åœ¨ä»»ä½•å…ˆå‰ä¿®è¨‚。
å°æ–¼å·²åˆªé™¤çš„項目,'^revid' 是來æºä¿®è¨‚çš„ ID,而且
'^baserevid' 將會是 -1,因為沒有任何目的地修訂。
å°æ–¼ Xlinks,'^baserevid' å’Œ '^parentrevid' 一律為 -1。
範例:
比較分支:
cm ^diff ^br:/main/task001
cm ^diff ^br:/main/task001 \doc\readme.txt
比較變更集樹狀目錄:
cm ^diff 19
cm ^diff 19 25
cm ^diff ^cs:19 ^cs:25 --^format="{^path} {^parentrevid}"
cm ^diff ^cs:19 ^cs:23 --^format="{^date} {^path}" --^dateformat="yy/dd/MM HH:mm:ss"
cm ^diff ^cs:19 ^cs:23 --^changed
cm ^diff ^cs:19 ^cs:23 --^repositorypaths
cm ^diff ^cs:19 ^cs:23 --^download="D:\temp"
cm ^diff ^cs:19 ^cs:23 --^clean
cm ^diff ^cs:19 ^cs:23 \doc\readme.txt
比較標籤樹狀目錄:
cm ^diff ^lb:FirstReleaseLabel ^lb:SecondReleaseLabel
cm ^diff ^lb:tag_193.2 ^cs:34214
cm ^diff ^cs:31492 ^lb:tag_193.2
比較擱置樹狀目錄:
cm ^diff ^sh:2
cm ^diff ^sh:2 ^sh:4
æ¯”è¼ƒä¿®è¨‚è¦æ ¼ï¼š
cm ^diff ^rev:readme.txt#^cs:19 ^rev:readme.txt#^cs:20
cm ^diff ^serverpath:/doc/readme.txt#^cs:19@myrepo \
^serverpath:/doc/readme.txt#^br:/main@myrepo@localhost:8084
== CMD_DESCRIPTION_DIFFMETRICS ==
顯示兩個修訂之間的ä¸åŒæŒ‡æ¨™ã€‚
== CMD_USAGE_DIFFMETRICS ==
用法:
cm ^diffmetrics | ^dm <ä¿®è¨‚è¦æ ¼1> <ä¿®è¨‚è¦æ ¼2> [--^format=<字串_æ ¼å¼>]
[--^encoding=<å稱>]
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
ä¿®è¨‚è¦æ ¼ 用於比較的修訂。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£ä¿®è¨‚è¦æ ¼ã€‚)
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^encoding 指定輸出編碼,例如:utf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^ignore 設定指定的比較方法。
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
== CMD_HELP_DIFFMETRICS ==
備註:
指標為:已變更ã€å·²æ–°å¢žå’Œå·²åˆªé™¤çš„行數。
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{0} 已變更的行數。
{1} 已新增的行數。
{2} 已刪除的行數。
範例:
cm ^diffmetrics file.txt#^cs:2 file.txt#^br:/main/scm0211 \
--^format="有 {0} 個已變更ã€{1} 個已新增和 {2} 已刪除的行。"
(æ“·å–æ ¼å¼åŒ–çš„ diffmetrics çµæžœã€‚)
cm ^dm file.txt#^cs:2 file.txt#^cs:3 --^encoding=utf-8 --^ignore=^whitespaces
== CMD_DESCRIPTION_FASTEXPORT ==
以快速匯出格å¼åŒ¯å‡ºå„²å­˜åº«ã€‚
== CMD_USAGE_FASTEXPORT ==
用法:
cm ^fast-export | ^fe <å„²å­˜åº«è¦æ ¼> <快速匯出檔案>
[--^import-marks=<標記_檔案>]
[--^export-marks=<標記_檔案>]
[--^branchseparator=<字元_分隔符號>]
[--^nodata] [--^from=<變更集 ID>] [--^to=<變更集 ID>]
é¸é …:
å„²å­˜åº«è¦æ ¼ 將從中匯出資料的儲存庫。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£å„²å­˜åº«è¦æ ¼ã€‚)
快速匯出檔案 å…§å«å„²å­˜åº«è³‡æ–™çš„æª”案,格å¼ç‚º Git
快速匯出。
--^import-marks 用於增é‡åŒ¯å…¥çš„æ¨™è¨˜æª”案。此檔案
å…ˆå‰å·²ç”± '--^export-marks' åŒ¯å‡ºã€‚å°‡ä¸æœƒåŒ¯å…¥æ­¤æª”案中
æè¿°çš„變更集,
因為這些變更集先å‰å·²åŒ¯å…¥ã€‚
--^export-marks 將儲存已匯入變更集的檔案。
此檔案用於之後進行的快速匯入,å‘已匯入的變更集
發出訊號。
--^branchseparator Unity VCS 使用「/ã€åšç‚ºåˆ†æ”¯éšŽå±¤ä¸­çš„é è¨­
分隔符號。此é¸é …å…許使用字元åšç‚ºéšŽå±¤åˆ†éš”符號,
å› æ­¤ main-task-sub 在 Unity VCS 中會æç¹ªæˆ
/main/task/sub。
--^nodata 匯出儲存庫但ä¸åŒ…å«è³‡æ–™ã€‚此命令
å°æ–¼æª¢æŸ¥åŒ¯å‡ºæ˜¯å¦å°‡æ­£å¸¸åŸ·è¡Œéžå¸¸æœ‰ç”¨ã€‚
--^from 從特定變更集匯出。
--^to 匯出至特定變更集。
== CMD_HELP_FASTEXPORT ==
備註:
- è‹¥è¦å°‡ Unity VCS 儲存庫匯入至 Git,請使用命令,例如:
^cat repo.fe.00 | ^git ^fast-import --^export-marks=marks.git --^import-marks=marks.git
- 支æ´ä½¿ç”¨åŒ…å«å…ˆå‰åŒ¯å…¥ä¹‹è®Šæ›´é›†çš„æ¨™è¨˜æª”案
('--^import-marks' 和 '--^export-marks'
檔案) 進行增é‡åŒ¯å‡ºã€‚
é€™è¡¨ç¤ºåªæœ‰åœ¨å…ˆå‰å¿«é€ŸåŒ¯å‡ºä¸­æœªåŒ¯å‡ºçš„
æ–°è®Šæ›´é›†æ‰æœƒåŒ¯å‡ºã€‚
範例:
cm ^fast-export repo@localhost:8087 repo.fe.00 --^import-marks=marks.cm \
--^export-marks=marks.cm
(將本地伺æœå™¨ä¸­çš„儲存庫 'repo' 匯出至 Git 快速匯出格å¼çš„
'repo.fe.00' 檔案,並建立標記檔案,以便之後執行
增é‡åŒ¯å‡ºã€‚)
cm ^fast-export repo@localhost:8087 repo.fe.00 --^from=20
(從變更集 '20' 將本地伺æœå™¨ä¸­çš„儲存庫 'repo' 以 Git 快速匯出格å¼
匯出至 'repo.fe.00'檔案。)
== CMD_DESCRIPTION_FASTIMPORT ==
將 Git 快速匯出資料匯入儲存庫。
== CMD_USAGE_FASTIMPORT ==
用法:
cm ^fast-import | ^fi <å„²å­˜åº«è¦æ ¼> <快速匯出檔案>
[--^import-marks=<標記_檔案>]
[--^export-marks=<標記_檔案>]
[--^stats] [--^branchseparator=<字元_分隔符號>]
[--^nodata] [--^ignoremissingchangesets] [--^mastertomain]
é¸é …:
å„²å­˜åº«è¦æ ¼ 將匯入資料的
儲存庫。如果儲存庫先å‰
ä¸å­˜åœ¨ï¼Œå‰‡æœƒå»ºç«‹ä¸€å€‹å„²å­˜åº«ã€‚(使用 'cm ^help ^objectspec' 以深入瞭解
å„²å­˜åº«è¦æ ¼ã€‚)
快速匯出檔案 å…§å«å„²å­˜åº«è³‡æ–™çš„æª”案,格å¼ç‚º Git
快速匯出。
--^import-marks 用於增é‡åŒ¯å…¥çš„æ¨™è¨˜æª”案。
此檔案
å…ˆå‰å·²ç”± '--^export-marks' åŒ¯å‡ºã€‚å°‡ä¸æœƒåŒ¯å…¥æ­¤æª”案中
æè¿°çš„變更集,
因為這些變更集先å‰å·²åŒ¯å…¥ã€‚
--^export-marks 將儲存已匯入變更集的
檔案。此檔案用於之後進行的
快速匯入,å‘已匯入的
變更集發出訊號。
--^stats 列å°é—œæ–¼åŒ¯å…¥éŽç¨‹çš„一些統計資料。
--^branchseparator Unity VCS 使用「/ã€åšç‚ºåˆ†æ”¯éšŽå±¤ä¸­çš„é è¨­
分隔符號。此é¸é …å…許使用
å­—å…ƒåšç‚ºéšŽå±¤åˆ†éš”符號,因此 main-task-sub
在 Unity VCS 中會æç¹ªæˆ /main/task/sub。
--^nodata 匯入 Git 快速匯出但ä¸åŒ…å«
資料。此命令
å°æ–¼æª¢æŸ¥åŒ¯å…¥æ˜¯å¦å°‡æ­£å¸¸åŸ·è¡Œéžå¸¸æœ‰ç”¨ã€‚
--^ignoremissingchangesets æœƒæ¨æ£„無法匯入的
任何變更集,且快速匯入作業
會在無變更集的情æ³ä¸‹ç¹¼çºŒé€²è¡Œã€‚
--^mastertomain 使用 "^main" 匯入,而éžä½¿ç”¨ "^master"。
== CMD_HELP_FASTIMPORT ==
備註:
- è‹¥è¦åŒ¯å‡º git 儲存庫,請使用命令,例如:
^git ^fast-export --^all -^M --^signed-tags=^strip --^tag-of-filtered-object=^drop> ..\git-fast-export.dat
-^M é¸é …å°æ–¼åµæ¸¬ç§»å‹•的項目很é‡è¦ã€‚
- 如果指定的儲存庫ä¸å­˜åœ¨ï¼Œå‰‡æœƒå»ºç«‹è©²å„²å­˜åº«ã€‚
- 支æ´ä½¿ç”¨åŒ…å«
å…ˆå‰åŒ¯å…¥ä¹‹è®Šæ›´é›†çš„æ¨™è¨˜æª”案 ('--^import-marks' å’Œ '--^export-marks'
檔案) 進行增é‡åŒ¯å…¥ã€‚
é€™è¡¨ç¤ºåªæœ‰åœ¨
å…ˆå‰å¿«é€ŸåŒ¯å…¥ä¸­æœªåŒ¯å…¥çš„æ–°è®Šæ›´é›†æ‰æœƒåŒ¯å…¥ã€‚
範例:
cm ^fast-import mynewrepo@atenea:8084 repo.fast-export
(å°‡ 'repo.fast-export' 檔案中匯出的內容匯入伺æœå™¨
'atenea:8084' 上的 'mynewrepo' 儲存庫。)
cm ^fast-import repo@atenea:8084 repo.fast-export --^export-marks=rep.marks
(å°‡ 'repo.fast-export' 檔案中匯出的內容匯入伺æœå™¨
'atenea:8084' 上的 'repo' 儲存庫,並建立標記檔案,
以便之後執行增é‡åŒ¯å…¥ã€‚)
cm ^fast-import repo@server:8084 repo.fast-export --^import-marks=repo.marks \
--^export-marks=repo.marks
(匯入 'repo.fast-export' æª”æ¡ˆçš„å…§å®¹ã€‚åªæœ‰ä¸åœ¨æ¨™è¨˜
æª”æ¡ˆä¸­çš„æ–°è®Šæ›´é›†æ‰æœƒåŒ¯å…¥ã€‚相åŒçš„æ¨™è¨˜
æª”æ¡ˆç”¨æ–¼å†æ¬¡å„²å­˜è®Šæ›´é›†çš„æ¸…單,以便下次進行
增é‡åŒ¯å…¥ã€‚)
== CMD_DESCRIPTION_FILEINFO ==
æ“·å–工作å€ä¸­é …目的詳細資訊。
== CMD_USAGE_FILEINFO ==
用法:
cm ^fileinfo <é …ç›®_路徑>[ ...][--^fields=<欄ä½_值>[,...]]
[[--^xml | -^x [=<輸出_檔案>]] | [--^format=<字串_æ ¼å¼>]]
[--^symlink] [--^encoding=<å稱>]
é …ç›®_路徑 è¦é¡¯ç¤ºçš„項目。使用空格以分隔
項目。
使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。
é¸é …:
--^fields 以逗號分隔值的字串。此é¸é …會é¸å–è¦
é‡å°æ¯å€‹é …目列å°çš„æ¬„ä½ã€‚如需詳細資訊,
è«‹åƒé–±å‚™è¨»ã€‚
--^xml | -^x å°‡ XML æ ¼å¼çš„輸出列å°è‡³æ¨™æº–輸出。
å¯ä»¥æŒ‡å®šè¼¸å‡ºæª”案。此é¸é …
無法與 '--^format' åˆä½µã€‚
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚æ­¤é¸é …無法
與 '--^xml' åˆä½µã€‚
å¦‚æžœåŒæ™‚指定兩個é¸é …,則此 '--^format' é¸é …
優先於 '--^fields'。
--^symlink 將檔案資訊作業套用至符號連çµï¼Œè€Œä¸æ˜¯
套用至目標。
--^encoding 指定輸出編碼,例如:utf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
== CMD_HELP_FILEINFO ==
備註:
æ­¤å‘½ä»¤æœƒåˆ—å°æ¯å€‹é¸å–項目之屬性的詳細清單。
é è¨­æƒ…æ³ä¸‹ï¼Œæ¯å€‹å±¬æ€§æœƒåˆ—å°åœ¨æ–°è¡Œä¸Šã€‚
屬性清單å¯ä¿®æ”¹ç‚ºåƒ…顯示使用者需è¦çš„
屬性。這å¯ä»¥ä½¿ç”¨ '--^fields=<欄ä½_清單>' 來锿ˆï¼Œå…¶ä¸­æŽ¥å
一連串以逗號分隔的屬性åç¨±ã€‚å¦‚æ­¤ä¸€ä¾†ï¼Œåªæœƒé¡¯ç¤ºå·²æŒ‡å®š
å稱的引數。
修訂å‰ç«¯è®Šæ›´é›†ï¼š
é è¨­æƒ…æ³ä¸‹ï¼Œå·²åœç”¨æ­¤é¸é …。請注æ„,擷å–這個屬性
的速度明顯比其他屬性慢,因此,我們建議使用者
將盡å¯èƒ½å¤šçš„項目分組在一起。這å¯é¿å…執行許多
個別的 'cm ^fileinfo',以改善執行時間。
此外,此功能目å‰ç„¡æ³•ç”¨æ–¼å—æŽ§ç›®éŒ„ã€‚
您å¯ä»¥åœ¨ä¸‹æ–¹å°‹æ‰¾å¯ç”¨å±¬æ€§å稱的完整清單。
é è¨­æƒ…æ³ä¸‹ï¼Œä¸æœƒé¡¯ç¤ºæ¨™è¨˜æ˜Ÿè™Ÿ ('*') çš„å稱:
^ClientPath 該項目在ç£ç¢Ÿä¸Šçš„æœ¬åœ°è·¯å¾‘。
^RelativePath 工作å€ç›¸å°è·¯å¾‘。
^ServerPath 該項目的儲存庫路徑。
(請注æ„:此é¸é …ç›®å‰ä¸æ”¯æ´
轉æ›çš„工作å€)。
^Size 項目大å°ã€‚
^Hash 項目雜湊加總。
^Owner 項目所屬的使用者。
^RevisionHeadChangeset (*) 在分支的å‰ç«¯è®Šæ›´é›†ä¸­
載入的修訂變更集。
(è«‹åƒé–±ä¸‹æ–¹å‚™è¨»ã€‚)
^RevisionChangeset 工作å€ä¸­ç›®å‰è¼‰å…¥ä¹‹ä¿®è¨‚
的變更集。
^RepSpec è©²é …ç›®çš„å„²å­˜åº«è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解
å„²å­˜åº«è¦æ ¼ã€‚)
^Status 工作å€é …目狀態:已新增ã€å·²ç°½å‡ºã€
已刪除等。
^Type 修訂類型 (文字ã€äºŒé€²ä½ã€ç›®éŒ„ã€ç¬¦è™Ÿé€£çµ
或未知)。
^Changelist 項目所屬的變更集 (如果有的話)。
^IsLocked (*) 項目是å¦å—到ç¨ä½”簽出的
鎖定。
^LockedBy (*) ç¨ä½”簽出項目的使用者。
^LockedWhere (*) ç¨ä½”簽出項目
çš„ä½ç½®ã€‚
^IsUnderXlink 項目是å¦ä½æ–¼ Xlink
下方。
^UnderXlinkTarget 項目所在的 Xlink 目標
(如果有的話)。
^UnderXlinkPath Xlink 連çµä¹‹å„²å­˜åº«ä¸­çš„項目伺æœå™¨è·¯å¾‘
(如果有的話)。
^UnderXlinkWritable 項目所屬的 Xlink 是å¦
å¯å¯«å…¥ã€‚
^UnderXlinkRelative 項目所屬的 Xlink 是å¦
相關。
^IsXlink 項目本身是å¦ç‚º Xlink。
^XlinkTarget 如果項目是 Xlink,該項目指å‘的目標
儲存庫。
^XlinkName 項目的 Xlink å稱,如果實際
存在的話。
^XlinkWritable Xlink 項目是å¦ç‚ºå¯å¯«å…¥çš„
Xlink。
^XlinkRelative Xlink 項目是å¦ç‚ºç›¸é—œçš„
Xlink。
輸出格å¼è‡ªè¨‚化:
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^ClientPath}
{^RelativePath}
{^ServerPath}
{^Size}
{^Hash}
{^Owner}
{^RevisionHeadChangeset}
{^RevisionChangeset}
{^Status}
{^Type}
{^Changelist}
{^IsLocked}
{^LockedBy}
{^LockedWhere}
{^IsUnderXlink}
{^UnderXlinkTarget}
{^UnderXlinkPath}
{^UnderXlinkWritable}
{^UnderXlinkRelative}
{^IsXlink}
{^XlinkTarget}
{^XlinkName}
{^XlinkWritable}
{^XlinkRelative}
{^RepSpec}
請注æ„,'--^format' å’Œ '--^xml' é¸é …是互斥的,因此,
ç„¡æ³•åŒæ™‚使用這兩個é¸é …。
範例:
cm ^fileinfo file1.txt file2.txt dir/
cm ^fileinfo "New Project.csproj" --^xml
cm ^fileinfo assets.art --^fields=^ServerPath,^Size,^IsLocked,^LockedBy
cm ^fileinfo proj_specs.docx --^fields=^ServerPath,^RevisionChangeset --^xml
cm ^fileinfo samples.ogg --^format="{^ServerPath}[{^Owner}] -> {^Size}"
== CMD_DESCRIPTION_FIND ==
執行類似 SQL 的查詢,以尋找 Unity VCS 物件。
== CMD_USAGE_FIND ==
用法:
cm ^find <物件_類型>
[^where <字串_æ¢ä»¶>]
[^on ^repository '<å„²å­˜åº«è¦æ ¼>' | ^on ^repositories '<å„²å­˜åº«è¦æ ¼1>','<å„²å­˜åº«è¦æ ¼2>'[,...]]
[--^format=<字串_æ ¼å¼>] [--^dateformat=<日期_æ ¼å¼>]
[--^nototal] [--^file=<傾å°_檔案>] [--^xml]
[--^encoding=<å稱>]
物件_類型 è¦å°‹æ‰¾çš„物件類型。
使用 'cm ^help ^showfindobjects' 以瞭解如何指定
這些物件。
您也å¯ä»¥åƒé–± 'cm ^find' 指å—:
https://www.plasticscm.com/download/help/cmfind
é¸é …:
字串_æ¢ä»¶ 物件屬性上的æœå°‹æ¢ä»¶ã€‚
å„²å­˜åº«è¦æ ¼ æœå°‹å„²å­˜åº«åˆ¥åæˆ–è¦æ ¼ã€‚
在 '^on ^repositories' 的情æ³ä¸‹ï¼Œä½¿ç”¨é€—號以
åˆ†éš”å„²å­˜åº«è¦æ ¼æ¬„ä½ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
è¦æ ¼ã€‚)
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚
è«‹åƒé–± 'cm ^find' 指å—,以瞭解å¯åšç‚º
輸出格å¼å­—串的所有物件屬性:
https://www.plasticscm.com/download/help/cmfind
--^dateformat 用於輸出日期的格å¼ã€‚
--^nototal çµå°¾ä¸è¼¸å‡ºè¨˜éŒ„計數。
--^file è¦å‚¾å°çµæžœçš„æª”案。
--^xml å°‡ XML æ ¼å¼çš„輸出列å°è‡³æ¨™æº–輸出。
--^encoding 指定輸出編碼,例如:utf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
== CMD_HELP_FIND ==
備註:
如果未指定任何儲存庫,將會在工作å€ä¸­è¨­å®šçš„
儲存庫上進行æœå°‹ã€‚
當您從命令列使用比較é‹ç®—å­ (>ã€<ã€>=ã€<=) 執行查詢時,
請記ä½ï¼Œæ­¤å‘½ä»¤ä»‹é¢æœƒå°‡é€™äº›é‹ç®—å­è¦–為 IO
釿–°å°Žå‘。因此,您需è¦ä½¿ç”¨é›™å¼•號括ä½
查詢。
'cm ^find' å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ¯å€‹è¼¸å‡ºåƒæ•¸æ˜¯æ ¹æ“šå­—串加以識別,而且使用者å¯ä»¥è—‰ç”±åœ¨
'{' å’Œ '}' æ‹¬è™Ÿä¹‹é–“è¼¸å…¥åƒæ•¸è™Ÿç¢¼ä¾†å¼•ç”¨åƒæ•¸ã€‚
è¼¸å‡ºåƒæ•¸é€šå¸¸å°æ‡‰è‡³ç‰©ä»¶çš„屬性。
這些是一些有效的輸出格å¼å­—串:
--^format={^id}{^date}{^name}
--^format="{^item}#{^branch} ^with ^date {^date}"
XML 與編碼考é‡ï¼š
指定 '--^xml' é¸é …æ™‚ï¼Œå‘½ä»¤æœƒå°‡å‘½ä»¤çµæžœä»¥ XML 文字的形å¼
顯示在標準輸出中。會使用作業系統é è¨­ç·¨ç¢¼ä¾†é¡¯ç¤ºæ–‡å­—,
因此,在主控å°ä¸­å¯èƒ½æœƒä¸æ­£ç¢ºåœ°é¡¯ç¤º
éž ANSI å­—å…ƒã€‚å¦‚æžœæ‚¨å°‡å‘½ä»¤è¼¸å‡ºé‡æ–°å°Žå‘至檔案,
å°‡æœƒæ­£ç¢ºé¡¯ç¤ºã€‚ç•¶åŒæ™‚指定 '--^xml' å’Œ '--^file'
é¸é …時,é è¨­ç·¨ç¢¼å°‡æœƒæ˜¯ utf-8。
範例:
cm ^find ^revision
cm ^find ^revision "^where ^changeset=23 ^and ^owner='maria'"
cm ^find ^branch "^on ^repository 'rep1'"
cm ^find ^label "^on ^repositories 'rep1', '^rep:default@localhost:8084'"
cm ^find ^branch "^where ^parent='^br:/main' ^on ^repository 'rep1'"
cm ^find ^revision "^where ^item='^item:.'" --^format="{^item}#{^branch}"
cm ^find ^revision "^where ^item='^item:.'" --^xml --^file=c:\queryresults\revs.xml
== CMD_DESCRIPTION_FINDCHANGED ==
å–得已變更檔案的清單。此命令已棄用,並且單純為了
回溯相容性而ä¿ç•™ã€‚請改用 'cm ^status'。
== CMD_USAGE_FINDCHANGED ==
用法:
cm ^findchanged | ^fc [-^R | -^r | --^recursive] [--^checkcontent]
[--^onlychanged] [<路徑>]
é¸é …:
-^R 在目錄中éžè¿´å°‹æ‰¾ã€‚
--^checkcontent ä¾å…§å®¹æ¯”較檔案。
--^onlychanged åƒ…å°‹æ‰¾å·²è®Šæ›´çš„æª”æ¡ˆï¼›ä¸æœƒç²å¾—
簽出。
路徑 (é è¨­ï¼šç›®å‰ç›®éŒ„。)
尋找已變更檔案的åˆå§‹è·¯å¾‘。
== CMD_HELP_FINDCHANGED ==
備註:
如果未æä¾›ä»»ä½• '--^checkcontent' é¸é …,Unity VCS 會根據檔案時間戳記
尋找變更。指定 '--^checkcontent' é¸é …時,會比較檔案或
è³‡æ–™å¤¾å…§å®¹ï¼Œè€Œä¸æ˜¯ä½¿ç”¨æ™‚間戳記。
æ­¤å‘½ä»¤å°æ–¼åœ¨èˆ‡ Unity VCS 伺æœå™¨ä¸­æ–·é€£ç·šæ™‚嵿¸¬å·²è®Šæ›´çš„æª”案,
相當有用。此輸出å¯é€éŽç®¡é“傳é€è‡³ç°½å‡ºå‘½ä»¤ï¼Œ
在ç¨å¾Œæª¢æŸ¥è®Šæ›´ (è«‹åƒé–±ç¯„例)。
範例:
cm ^findchanged .
(在目å‰ç›®éŒ„中尋找已變更的檔案。)
cm ^findchanged -^R .| cm ^checkout -
(簽出已變更的元素。)
== CMD_DESCRIPTION_FINDCHECKEDOUT ==
å–得已簽出項目的清單。此命令已棄用,並且單純為了
回溯相容性而ä¿ç•™ã€‚請改用 'cm ^status'。
== CMD_USAGE_FINDCHECKEDOUT ==
用法:
cm ^findcheckouts | ^fco [--^format=<字串_æ ¼å¼>] [--^basepath]
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^basepath é–‹å§‹æœå°‹ç°½å‡ºçš„路徑。如果
未指定,會使用目å‰è·¯å¾‘。
== CMD_HELP_FINDCHECKEDOUT ==
備註:
æ­¤å‘½ä»¤å°æ–¼åœ¨å–®ä¸€æ­¥é©Ÿä¸­ç°½å…¥æˆ–å–æ¶ˆç°½å‡ºæ‰€æœ‰å·²ç°½å‡ºé …目相當有用,
å¯å°‡æ¨™æº–è¼¸å‡ºé‡æ–°å°Žå‘其他命令。
è«‹åƒé–±ç¯„例。
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{0} 日期。
{1} æ“æœ‰è€…。
{2} 工作空間資訊。
{3} 用戶端機器å稱。
{4} 項目路徑。
{5} 分支和儲存庫資訊。
範例:
cm ^findcheckouts --^format="在分支 {5} 上已變更檔案 {4} "
(尋找已簽出項目,並使用檔案路徑和分支
與儲存庫資訊來設定輸出的格å¼ã€‚)
cm ^findcheckouts --^format={4} | cm ^checkin -
(簽入所有已簽出項目。)
cm ^findcheckouts --^format={4} | cm ^undocheckout -
–消簽出所有已簽出項目。)
== CMD_DESCRIPTION_FINDPRIVATE ==
å–å¾—ç§äººé …目的清單。此命令已棄用,並且單純為了
回溯相容性而ä¿ç•™ã€‚請改用 'cm ^status'。
== CMD_USAGE_FINDPRIVATE ==
用法:
cm ^findprivate | ^fp [-^R | -^r | --^recursive] [--^exclusions] [<路徑>]
é¸é …:
-^R 在目錄中éžè¿´å°‹æ‰¾ã€‚
--^exclusions æ­¤é¸é …å…許在忽略路徑內剪下æœå°‹ï¼Œ
由檔案 ignore.conf 定義。
路徑 (é è¨­ï¼šç›®å‰ç›®éŒ„。)
尋找ç§äººæª”案的åˆå§‹è·¯å¾‘。
== CMD_HELP_FINDPRIVATE ==
備註:
如果有指定任何路徑,Unity VCS 將開始從
ç›®å‰ç›®éŒ„æœå°‹ã€‚
æ­¤å‘½ä»¤å°æ–¼åœ¨è³‡æ–™å¤¾ä¸Šæ–°å¢žç§äººé …目相當有用,é€éŽç®¡é“將輸出
傳é€è‡³æ–°å¢žå‘½ä»¤ã€‚è«‹åƒé–±ç¯„例。
範例:
cm ^findprivate .
cm ^findprivate -^R | cm ^add -
žè¿´æœå°‹ç§äººé …目並新增這些項目。)
== CMD_DESCRIPTION_GETCONFIG ==
ç²å¾—設定資訊。
== CMD_USAGE_GETCONFIG ==
用法:
cm ^getconfig [^setfileasreadonly] [^location] [^extensionworkingmode]
[^extensionprefix] [^defaultrepserver]
^setfileasreadonly 傳回å—ä¿è­·çš„æª”案是å¦ä¿æŒ
唯讀。
^location 傳回用戶端設定路徑。
^extensionworkingmode 傳回副檔å工作模å¼ã€‚
^extensionprefix 傳回設定的副檔åå‰ç½®è©žã€‚
^defaultrepserver 傳回é è¨­å„²å­˜åº«ä¼ºæœå™¨çš„
ä½ç½®ã€‚
== CMD_HELP_GETCONFIG ==
範例:
cm ^getconfig ^setfileasreadonly
== CMD_DESCRIPTION_GETFILE ==
下載指定修訂的內容。
== CMD_USAGE_GETFILE ==
用法:
cm ^getfile | ^cat <ä¿®è¨‚è¦æ ¼> [--^file=<輸出_檔案>] [--^debug]
[--^symlink] [--^raw]
ä¿®è¨‚è¦æ ¼ ç‰©ä»¶è¦æ ¼ã€‚(使用 'cm ^help ^objectspec' 以深入瞭解
è¦æ ¼ã€‚)
é¸é …:
--^file 儲存輸出的檔案。é è¨­æƒ…æ³ä¸‹ï¼Œè©²æª”案會列å°åœ¨
標準輸出上。
--^debug ä½¿ç”¨ç›®éŒ„è¦æ ¼æ™‚,此命令會顯示目錄中的
所有項目ã€é …目的修訂 ID,
ä»¥åŠæª”案系統ä¿è­·ã€‚
--^symlink 將作業套用至符號連çµï¼Œè€Œä¸æ˜¯å¥—用至
目標。
--^raw 顯示檔案的未經處ç†è³‡æ–™ã€‚
== CMD_HELP_GETFILE ==
範例:
cm ^cat myfile.txt#^br:/main
(在 'myfile.txt' 的分支 '^br:/main' 中,ç²å–最後一個修訂。)
cm ^getfile myfile.txt#^cs:3 --^file=tmp.txt
²å 'myfile.txt' 的變更集 3,並將其寫入檔案 'tmp.txt'。)
cm ^cat ^serverpath:/src/foo.c#^br:/main/task003@myrepo
²å–儲存庫 'myrepo' 中分支 '/main/task003' 的最後
一個變更集 '/src/foo.c' 的內容)
cm ^cat ^revid:1230@^rep:myrep@^repserver:myserver:8084
²å– ID 1230 的修訂。)
cm ^getfile ^rev:info\ --^debug
²å 'info' 儲存庫中的所有修訂。)
== CMD_DESCRIPTION_GETREVISION ==
在工作å€ä¸­è¼‰å…¥ä¿®è¨‚。
== CMD_USAGE_GETREVISION ==
此命令會修改工作å€ä¸­è¼‰å…¥çš„修訂,因此,會影響
未來åˆä½µã€‚
這是繼承自舊版本的進階命令,所以請謹慎使用。
用法:
cm ^getrevision <ä¿®è¨‚è¦æ ¼>
ä¿®è¨‚è¦æ ¼ ç‰©ä»¶è¦æ ¼ã€‚(使用 'cm ^help ^objectspec' 以深入瞭解
ä¿®è¨‚è¦æ ¼ã€‚)
== CMD_HELP_GETREVISION ==
範例:
cm ^getrevision file.txt#^cs:3
–å¾— 'file.txt' 的變更集 3 修訂。)
== CMD_DESCRIPTION_GETSTATUS ==
å–得項目的狀態。
== CMD_USAGE_GETSTATUS ==
這是自動化命令,目的僅é™ç”¨æ–¼è‡ªå‹•化 'cm'。
方便使用的程度並ä¸é«˜ã€‚
用法:
cm ^getstatus | ^gs <é …ç›®_路徑>[ ...][--^format=<字串_æ ¼å¼>] [--^stats]
[-^R | -^r | --^recursive]
é …ç›®_路徑 è¦å–得狀態的一或多個項目。使用雙引號
(" ") 指定å«ç©ºæ ¼çš„路徑。使用
空格分隔路徑。
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^stats 列å°é—œæ–¼å–得狀態éŽç¨‹çš„一些統計資料。
-^R 在目錄中éžè¿´é¡¯ç¤ºç‹€æ…‹ã€‚
== CMD_HELP_GETSTATUS ==
備註:
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{0} 項目路徑。
{1} 項目狀態:
0 ç§äººï¼Œ
1 已簽入,
2 已簽出。
從 stdin 讀å–輸入:
'^getstatus' 命令å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯
傳éžå–®ä¸€ç ´æŠ˜è™Ÿã€Œ-ã€ä¾†å®Œæˆã€‚
範例:cm ^getstatus -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“您使用管線以指定è¦å–得狀態的路徑。
範例:
dir /S /B *.c | cm ^getstatus --^format="路徑 {0} 狀態 {1}" -
(在 Windows 中,å–得工作å€ä¸­æ‰€æœ‰ .c 檔案的狀態。)
範例:
cm ^getstatus file1.txt file2.txt
–得檔案的狀態。)
cm ^gs info\ -^R --^format="項目 {0} 具有狀態 {1}"
–得目錄åŠå…¶é …目的狀態,並顯示
已格å¼åŒ–的輸出。)
== CMD_DESCRIPTION_GETTASKBRANCHES ==
å–得與任務連çµçš„分支。
== CMD_USAGE_GETTASKBRANCHES ==
這是自動化命令,目的僅é™ç”¨æ–¼è‡ªå‹•化 'cm'。
方便使用的程度並ä¸é«˜ã€‚
用法:
cm ^gettaskbranches | ^gtb <任務_å稱> [--^format=<字串_æ ¼å¼>]
[--^dateformat=<日期_æ ¼å¼>]
任務_å稱 任務識別碼。
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^dateformat 用於輸出日期的格å¼ã€‚
== CMD_HELP_GETTASKBRANCHES ==
備註:
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^tab} æ’入定ä½å­—元空格。
{^newline} æ’入新行。
{^name} 分支å稱。
{^owner} åˆ†æ”¯çš„æ“æœ‰è€…。
{^date} 建立分支的日期。
{^type} 分支類型 (如果是智慧型,則為 'T'ï¼Œå¦‚æžœä¸æ˜¯ï¼Œå‰‡ç‚º 'F')。
{^parent} 上層分支。
{^comment} 分支的註解。
{^repname} 存在此分支的儲存庫。
{^repserver} 伺æœå™¨å稱。
範例:
cm ^gettaskbranches 4311
cm ^gtb 4311 --^format="^br:{^name}"
cm ^gtb 4311 --^format="^br:{^name} {^date}" --^dateformat="yyyy/MM/dd HH:mm:ss"
== CMD_DESCRIPTION_GETWORKSPACEINFO ==
顯示關於工作å€é¸æ“‡å™¨çš„資訊。
== CMD_USAGE_GETWORKSPACEINFO ==
用法:
cm ^wi [<工作å€_路徑>]
é¸é …:
工作å€_路徑 機器上的工作å€è·¯å¾‘。
== CMD_HELP_GETWORKSPACEINFO ==
備註:
'^wi' å‘½ä»¤æœƒé¡¯ç¤ºå·¥ä½œå€ (儲存庫ã€åˆ†æ”¯ï¼ŒåŠ/或標籤)
的作用中設定。
範例:
cm ^wi c:\mywk
== CMD_DESCRIPTION_GETWORKSPACEFROMPATH ==
從路徑å–得工作å€è³‡è¨Šã€‚
== CMD_USAGE_GETWORKSPACEFROMPATH ==
這是自動化命令,目的僅é™ç”¨æ–¼è‡ªå‹•化 'cm'。
方便使用的程度並ä¸é«˜ã€‚
用法:
cm ^getworkspacefrompath | ^gwp <é …ç›®_路徑> [--^format=<字串_æ ¼å¼>]
é …ç›®_路徑 ç£ç¢Ÿä¸Šçš„æª”案或資料夾。
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
== CMD_HELP_GETWORKSPACEFROMPATH ==
備註:
æ­¤å‘½ä»¤æœƒé¡¯ç¤ºä½æ–¼è·¯å¾‘中的工作å€ç›¸é—œè³‡è¨Šã€‚
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{0} | {^wkname} 工作å€å稱。
{1} | {^wkpath} 工作å€è·¯å¾‘。
{2} | {^machine} 用戶端機器å稱。
{3} | {^owner} å·¥ä½œå€æ“有者。
{4} | {^guid} å·¥ä½œå€ GUID。
{^tab} æ’入定ä½å­—元空格。
{^newline} æ’入新行。
範例:
cm ^gwp c:\myworkspace\code\file1.cpp --^format="工作å€å稱: {^wkname}"
== CMD_DESCRIPTION_HELP ==
å–å¾— Unity VCS 命令的說明。
== CMD_USAGE_HELP ==
用法:
cm ^help <命令>
== CMD_HELP_HELP ==
== CMD_DESCRIPTION_IOSTATS ==
顯示關於硬體的統計資料。
== CMD_USAGE_IOSTATS ==
用法:
cm ^iostats [<儲存庫伺æœå™¨è¦æ ¼>] [<測試_清單>[ ...]]
[--^nettotalmb=<值_mb>] [--^networkiterations=<值_å覆項目>]
[--^diskdatasize=<值_大å°>] [--^disktestpath=<值_路徑>]
[--^systemdisplaytime=<值_時間>]
[--^systemdisplaytimeinterval=<值_間隔>]
é¸é …:
儲存庫伺æœå™¨è¦æ ¼ 執行網路測試的å¯ç”¨ Unity VCS
伺æœå™¨ï¼Œä¾‹å¦‚ "serverUploadTest"
åŠ/或 "serverDownloadTest"。
如果未æä¾›ä»»ä½•伺æœå™¨ï¼Œé è¨­æƒ…æ³ä¸‹ï¼Œ
此命令會嘗試與設定的伺æœå™¨
進行通訊。
(使用 'cm ^help ^objectspec' 以深入瞭解
伺æœå™¨è¦æ ¼ã€‚)
測試_清單 å¯ç”¨æ¸¬è©¦ã€‚使用空格分隔
測試欄ä½ã€‚
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^nettotalmb 表示網路測試傳輸的使用者
è³‡æ–™é‡ (以MB 為單ä½),
例如 "^serverDownloadTest" 或
"^serverUploadTest"。
它必須是介於 "4" 和 "512" 之間的值。
(é è¨­å€¼ï¼š16)
--^networkiterations 表示將執行的
"^serverDownloadTest" åŠ/或 "^serverUploadTest"
çš„å覆項目數目。
它必須是介於 "1" 和 "100" 之間的值。
(é è¨­å€¼ï¼š1)
--^diskdatasize 表示將在
"^diskTest" 上寫入然後讀å–的資料é‡ã€‚
它必須是介於 "100" 和 "4096" 之間的值。
(é è¨­å€¼ï¼š512)
--^disktestpath "^diskTest" 寫入測試檔案的
路徑。如果未æä¾›æ­¤åƒæ•¸ï¼Œ
此命令將嘗試使用系統的暫存
路徑。
--^systemdisplaytime 顯示系統資æºä½¿ç”¨ç‹€æ³çš„æ™‚é–“é–“éš”
(以秒為單ä½)。此é¸é …å¯ä¾›ä»¥ä¸‹
測試使用: "^systemNetworkUsage"
和 "^systemDiskUsage".
它必須是介於 "1" 和 "3600" 之間的值。
(é è¨­: 5 ç§’)。
--^systemdisplaytimeinterval ç³»çµ±æ•ˆèƒ½å–æ¨£ä¹‹é–“的時間間隔
(以秒為單ä½)。此é¸é …å¯ä¾›
以下測試使用:
"^systemNetworkUsage" 和 "^systemDiskUsage".
它必須是介於 "1" 和 "60" 之間的值。
(é è¨­: 1 ç§’)。
== CMD_HELP_IOSTATS ==
備註:
æ­¤å‘½ä»¤è¦æ±‚在網路速度測試 ("^serverUploadTest"
åŠ/或 "^serverDownloadTest") 中,使用å¯ç”¨çš„伺æœå™¨ã€‚
'--^diskTestPath' 必須指å‘å±¬æ–¼å°‡è¦æ¸¬è©¦çš„實體
ç£ç¢Ÿæ©Ÿã€‚如果未指定任何路徑,此命令會嘗試
使用系統é è¨­çš„æš«å­˜è·¯å¾‘。
指定路徑的ç£ç¢Ÿæ©Ÿå¿…須有足夠的空間,æ‰èƒ½åŸ·è¡Œ
測試。
命令執行期間,系統會因為執行的測試
而導致效能下é™ã€‚
å¯ç”¨çš„æ¸¬è©¦:
--^serveruploadtest (é è¨­) 測é‡å¾ž
Unity VCS 用戶端到伺æœå™¨çš„資料上傳速度。
--^serverdownloadtest (é è¨­) 測é‡å¾ž
Unity VCS 伺æœå™¨åˆ°ç”¨æˆ¶ç«¯çš„資料下載速度。
--^disktest (é è¨­) 測é‡ç£ç¢Ÿè®€å–速度與ç£ç¢Ÿ
寫入速度。
--^systemnetworkusage 顯示系統網路資æºçš„ç›®å‰
使用é‡ã€‚
(其顯示 Microsoft Windows æä¾›çš„ç¶²è·¯ä»‹é¢æ•ˆèƒ½è¨ˆæ•¸å™¨
)。
僅在 Microsoft Windows 中å¯ç”¨ã€‚
--^systemdiskusage 顯示系統實體ç£ç¢Ÿçš„ç›®å‰
使用é‡ã€‚
(其顯示 Microsoft Windows æä¾›çš„網路介é¢
效能計數器)。
僅在 Microsoft Windows 中å¯ç”¨ã€‚
範例:
cm ^iostats MYSERVER:8087 --^serveruploadtest --^serverdownloadtest --^nettotalmb=32
== CMD_DESCRIPTION_ISSUETRACKER ==
在指定的議題追蹤器中å–å¾—ã€æ›´æ–°æˆ–尋找å•題狀態。
== CMD_USAGE_ISSUETRACKER ==
用法:
cm ^issuetracker <å稱> ^status ^get <任務_id> <åƒæ•¸>[ ...]
cm ^issuetracker <å稱> ^status ^update <任務_id> <狀態> <åƒæ•¸>[ ...]
cm ^issuetracker <å稱> ^status ^find <狀態> <åƒæ•¸>[ ...]
cm ^issuetracker <å稱> ^connection ^check <åƒæ•¸>[ ...]
å稱 è¦é€£ç·šçš„議題追蹤器å稱。
ç›®å‰åƒ…æ”¯æ´ Jira。
任務_id è¦æŸ¥è©¢æˆ–更新的議題編號。
^status 議題追蹤器中的å•題有效狀態。
Jira åƒæ•¸ (皆為強制):
--^user=<使用者> è¦é©—證的使用者。
--^password=<密碼> è¦é©—證的密碼。
--^host=<url> 議題追蹤器的目標 URL。
--^projectkey=<金鑰> Jira 專案的專案金鑰。
== CMD_HELP_ISSUETRACKER ==
範例:
cm ^issuetracker jira ^status ^get 11 --^user=user@mail.es --^password=pwd \
--^host=https://user.atlassian.net --^projectkey=PRJ
–å¾— 'PRJ' 專案的議題 11 狀態。)
cm ^issuetracker jira ^status ^update 11 "完æˆ" --^user=user@mail.es \
--^password=pwd --^host=https://user.atlassian.net --^projectkey=PRJ
(å°‡ 'PRJ' 專案的議題 11 狀態更新為 '完æˆ'。)
cm ^issuetracker jira ^status ^find "完æˆ" --^user=user@mail.es --^password=pwd \
--^host=https://user.atlassian.net --^projectkey=PRJ
–å¾— 'PRJ' 專案狀態已設為 '完æˆ' 的任務 ID -)
cm ^issuetracker jira ^connection ^check --^user=user@mail.es --^password=pwd \
--^host=https://user.atlassian.net --^projectkey=PRJ
(æª¢æŸ¥è¨­å®šåƒæ•¸æ˜¯å¦æœ‰æ•ˆã€‚)
== CMD_DESCRIPTION_LICENSEINFO ==
顯示授權資訊與授權使用狀æ³ã€‚
== CMD_USAGE_LICENSEINFO ==
用法:
cm ^licenseinfo | ^li [--^server=<儲存庫伺æœå™¨è¦æ ¼>] [--^inactive] [--^active]
[--^sort=(^name|^status)]
é¸é …:
--^server 從指定的伺æœå™¨å–得授權資訊。
如果未指定任何伺æœå™¨ï¼Œè«‹åœ¨ç”¨æˆ¶ç«¯ä¸Šè¨­å®šçš„
伺æœå™¨ä¸ŠåŸ·è¡Œå‘½ä»¤ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺æœå™¨
è¦æ ¼ã€‚)
--^inactive 僅顯示 [授權使用狀æ³] 倿®µä¸­çš„éžä½œç”¨ä¸­ä½¿ç”¨è€…。
--^active 僅顯示 [授權使用狀æ³] 倿®µä¸­çš„作用中使用者。
--^sort ä¾å…¶ä¸­ä¸€å€‹æŒ‡å®šçš„æŽ’åºé¸é …來排åºä½¿ç”¨è€…:
'^name' 或 '^status'。
== CMD_HELP_LICENSEINFO ==
備註:
顯示的資æºåŒ…嫿ˆªæ­¢æ—¥æœŸã€å·²å•Ÿç”¨å’Œå·²åœç”¨
使用者等。
範例:
cm ^licenseinfo
cm ^licenseinfo --^server=myserver:8084
cm ^licenseinfo --^sort=^name
== CMD_DESCRIPTION_LINKTASK ==
將變更集連çµè‡³ä»»å‹™ã€‚
== CMD_USAGE_LINKTASK ==
這是自動化命令,目的僅é™ç”¨æ–¼è‡ªå‹•化 'cm'。
方便使用的程度並ä¸é«˜ã€‚
用法:
cm ^linktask | ^lt <è®Šæ›´é›†è¦æ ¼> <副檔å_å‰ç½®è©ž> <任務_å稱>
è®Šæ›´é›†è¦æ ¼ 連çµè‡³ä»»å‹™çš„å®Œæ•´è®Šæ›´é›†è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
è¦æ ¼ã€‚)
副檔å_å‰ç½®è©ž è¦æ­é…使用之已設定議題追蹤系統
的副檔åå‰ç½®è©žã€‚
任務_å稱 議題追蹤系統的任務識別碼。
== CMD_HELP_LINKTASK ==
範例:
cm ^lt ^cs:8@^rep:default@^repserver:localhost:8084 jira PRJ-1
== CMD_DESCRIPTION_LOCK_LIST ==
顯示伺æœå™¨ä¸Šçš„鎖定。
== CMD_USAGE_LOCK_LIST ==
用法:
cm ^lock ^list | ^ls [<ä¿®è¨‚è¦æ ¼> [ ...]] [--^server=<伺æœå™¨>]
[--^onlycurrentuser] [--^onlycurrentworkspace]
[--^ignorecase]
ä¿®è¨‚è¦æ ¼ 如果存在一或多個,當其相關項目在伺æœå™¨ä¸­
鎖定時,此命令將é‡å°æ¯å€‹æŒ‡å®šçš„修訂顯示
一個鎖定行。å¦å‰‡ï¼Œ
此命令將列出é è¨­ä¼ºæœå™¨ (或使用
'--^server' é¸é …設定的伺æœå™¨) 中所有鎖定的項目
使用
å¤šå€‹è¦æ ¼æ™‚ï¼Œè«‹ä½¿ç”¨ç©ºæ ¼ä¾†åˆ†éš”ä¿®è¨‚è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£ä¿®è¨‚è¦æ ¼ã€‚)
é¸é …:
--^server 儲存庫伺æœå™¨è¦æ ¼ã€‚
æ­¤é¸é …將覆寫從目å‰å·¥ä½œå€æˆ–
client.conf 檔案擷å–çš„é è¨­
伺æœå™¨ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解
伺æœå™¨è¦æ ¼ã€‚)
--^onlycurrentuser 篩é¸çµæžœï¼Œä¸¦åªé¡¯ç¤ºç”±ç›®å‰ä½¿ç”¨è€…
執行的鎖定。
--^onlycurrentworkspace 篩é¸çµæžœï¼Œä¸¦åªé¡¯ç¤ºåœ¨ç›®å‰å·¥ä½œå€ä¸Š
執行的鎖定 (ä¾å稱比å°)。
--^ignorecase 當使用伺æœå™¨è·¯å¾‘è¦æ ¼æ™‚,忽略路徑的
大å°å¯«å€åˆ†ã€‚æ­é…這個標誌時,此命令將é©ç”¨æ–¼
"/src/foo.c",å³ä½¿è©²ä½¿ç”¨è€…寫入的是 "/sRc/fOO.c"。
== CMD_HELP_LOCK_LIST ==
備註:
此命令將顯示目å‰åœ¨é è¨­ä¼ºæœå™¨ä¸­é­éŽ–å®šçš„é …ç›®
æ¸…å–®ã€‚æ­¤å‘½ä»¤ä¹Ÿå¯æŽ¥å—ä¿®è¨‚è¦æ ¼çš„æ¸…單;在這種情æ³ä¸‹ï¼Œ
å°‡åªæœƒé¡¯ç¤ºå±¬æ–¼æ‰€é¸é …目的鎖定。
'--^server=<伺æœå™¨>' å¯ä»¥ç”¨ä¾†è¨­å®šå°‡è¦æŸ¥è©¢çš„é è¨­ä¼ºæœå™¨ã€‚
æ­¤å‘½ä»¤æœƒé¡¯ç¤ºä¸€è¡ŒåŒ…å«æŒ‡å®šä¼ºæœå™¨ä¸­çš„å„個鎖定:
- 已鎖定項目的 GUID。
- 執行此鎖定的使用者å稱。
- 其中執行鎖定的工作å€å稱。
- 已鎖定項目的路徑 (伺æœå™¨è·¯å¾‘æ ¼å¼)。
範例:
cm ^lock ^list
cm ^lock ^list --^server=myserver:8084
cm ^lock ^ls ^serverpath:/src/foo.c#^cs:99@default@localhost:8084
cm ^lock ^list ^revid:3521@default ^itemid:2381@secondary --^onlycurrentuser
cm ^lock ^ls --^onlycurrentuser
cm ^lock ^ls --^onlycurrentuser --^onlycurrentworkspace
== CMD_DESCRIPTION_LISTUSERS ==
列出使用者和群組。
== CMD_USAGE_LISTUSERS ==
用法:
cm ^listusers | ^lu <儲存庫伺æœå™¨è¦æ ¼> [--^onlyusers] [--^onlygroups]
[--^filter= <字串_篩é¸>]
儲存庫伺æœå™¨è¦æ ¼ 儲存庫伺æœå™¨è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
é¸é …:
--^onlyusers åªåˆ—出使用者。
--^onlygroups åªåˆ—出群組。
--^filter åªåˆ—å‡ºç¬¦åˆæ‰€æŒ‡å®šç¯©é¸çš„使用者åŠ/或
群組。
== CMD_HELP_LISTUSERS ==
範例:
cm ^lu localhost:8084
(列出伺æœå™¨ä¸­çš„æ‰€æœ‰ä½¿ç”¨è€…。)
cm ^listusers localhost:8084 --^onlyusers --^filter=m
ªåˆ—出åç¨±å« "m" 伺æœå™¨ä¸­çš„使用者。)
== CMD_DESCRIPTION_LOCATION ==
傳回åç¨±å« 'cm' 的路徑。
== CMD_USAGE_LOCATION ==
用法:
cm ^location
== CMD_HELP_LOCATION ==
== CMD_DESCRIPTION_LOCK ==
這個命令å¯è®“使用者管ç†éŽ–å®šã€‚
== CMD_USAGE_LOCK ==
用法:
cm ^lock <命令> [é¸é …]
命令:
^list | ^ls
^unlock
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^lock <命令> --^usage
cm ^lock <命令> --^help
== CMD_HELP_LOCK ==
範例:
cm ^lock ^list
cm ^lock
(如果沒有引數,則å¯é¸ç”¨ '^list'。)
cm ^lock ^ls ^serverpath:/src/foo.c#^cs:99@default@localhost:8084
cm ^lock ^unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
== CMD_DESCRIPTION_LOG ==
å–得變更集中修訂的相關資訊。
== CMD_USAGE_LOG ==
用法:
cm ^log [<è®Šæ›´é›†è¦æ ¼> | <å„²å­˜åº«è¦æ ¼>] [--^from=<è®Šæ›´é›†è¦æ ¼_來æº>] [--^allbranches]
[--^ancestors] [--^csformat=<字串_æ ¼å¼>] [--^itemformat=<字串_æ ¼å¼>]
[--^xml[=<輸出_檔案>]] [--^encoding=<å稱>]
[--^repositorypaths | --^fullpaths | --^fp]
é¸é …:
è®Šæ›´é›†è¦æ ¼ 此命令將傳回æä¾›è¦æ ¼ä¹‹è®Šæ›´é›†å…§æ‰€åšçš„
æ¯é …變更。
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
è¦æ ¼ã€‚)
å„²å­˜åº«è¦æ ¼ 此命令將列出所指定儲存庫中所åšçš„
所有變更。
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
è¦æ ¼ã€‚)
--^from åˆ—å‡ºå¾žè®Šæ›´é›†è¦æ ¼ [è®Šæ›´é›†è¦æ ¼_來æº] åˆ°è®Šæ›´é›†è¦æ ¼
[è®Šæ›´é›†è¦æ ¼] 中æ¯å€‹è®Šæ›´é›†å…§æ‰€åšçš„
所有變更。
æ­¤ [è®Šæ›´é›†è¦æ ¼_來æº] 變更集ä¸åŒ…å«åœ¨
輸出內。
ç•¶å·²æä¾›å„²å­˜åº«è¦æ ¼æ™‚å³å¿½ç•¥ã€‚
--^allbranches 顯示變更集建立時所在之全部分支
便“šæŒ‡å®šé–“éš”æ‰€å»ºç«‹è®Šæ›´é›†
的相關資訊。
--^ancestors 顯示å¯é€éŽæ‰€æŒ‡å®šè®Šæ›´é›† ([è®Šæ›´é›†è¦æ ¼]) çš„
上層連çµèˆ‡åˆä½µé€£çµé€£æŽ¥ä¹‹è®Šæ›´é›†
相關資訊。如果也æä¾›èµ·å§‹è®Šæ›´é›†
([è®Šæ›´é›†è¦æ ¼_來æº]),此變更集將會åšç‚º
所有路徑的下é™ã€‚備註:當使用
æ­¤é¸é …æ™‚ï¼Œå°‡ä¸æœƒé¡¯ç¤ºè®Šæ›´é›†çš„變更。
--^csformat ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–變更集資訊。如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^itemformat ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–項目資訊。如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^xml å°‡ XML æ ¼å¼çš„輸出列å°è‡³æ¨™æº–輸出。
å¯ä»¥æŒ‡å®šè¼¸å‡ºæª”案。
--^encoding 與 '--^xml' é¸é …æ­é…使用,指定è¦åœ¨
XML 輸出中使用的編碼,亦å³ï¼šutf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^fullpaths, --^fp 如果å¯èƒ½ï¼Œæœƒå¼·åˆ¶åˆ—å°æª”案和目錄的
完整工作å€è·¯å¾‘。
--^repositorypaths 列å°å„²å­˜åº«è·¯å¾‘ (伺æœå™¨è·¯å¾‘),而éž
工作å€è·¯å¾‘。(æ­¤é¸é …會覆寫
'--^fullpaths' é¸é …)。
== CMD_HELP_LOG ==
備註:
- 如果未指定 'è®Šæ›´é›†è¦æ ¼' 也未指定任何é¸é …,該命令會顯示
æ¯å€‹åˆ†æ”¯æ–¼æœ€è¿‘一個月內所建立個別變更集的
相關資訊。
- 如果åªåŒ…å«é¸é … '--^from',該命令會顯示在變更集建立
所在的分支中,從所指定變更集變更至最近變更集之
æ¯å€‹è®Šæ›´é›†çš„相關資訊。
- 如果é¸é … '--^allbranches' ä¸å«é–“隔,該命令會擷å
如åŒåƒ…指定 'è®Šæ›´é›†è¦æ ¼' 時的
相åŒè³‡è¨Šã€‚
- 如果使用 '--^from',其輸出會包å«'è®Šæ›´é›†è¦æ ¼_來æº'+1
åŠä¾æ­¤é¡žæŽ¨çš„資訊。
- 用於顯示變更集資訊的儲存庫,å³åœ¨åŸ·è¡Œæ­¤å‘½ä»¤çš„路徑中
所載入的儲存庫。
這個命令會接å—項目的格å¼å­—串 ('--^itemformat') åŠ
變更集的格å¼å­—串 ('--^csformat')。
'--^csformat' çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^tab} æ’入定ä½å­—元空格。
{^newline} æ’入新行。
{^changesetid} 變更集號碼。
{^branch} 變更集建立時的所在分支。
{^date} 變更集的日期。
{^owner} è®Šæ›´é›†çš„æ“æœ‰è€…。
{^comment} 變更集的註解。
{^items} æ¶‰åŠæ­¤è®Šæ›´é›†çš„項目。
{^repository} 其中存在此變更集的儲存庫。
{^repserver} 伺æœå™¨å稱。
'--^itemformat' çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^tab} æ’入定ä½å­—元空格。
{^newline} æ’入新行。
{^path} 項目路徑。
{^branch} 變更集建立時的所在分支。
{^date} 變更集的日期。
{^owner} è®Šæ›´é›†çš„æ“æœ‰è€…。
{^shortstatus} 列å°çŸ­æ ¼å¼ã€‚è«‹åƒé–±å¦‚下。
{^fullstatus} 列å°é•·æ ¼å¼ã€‚è«‹åƒé–±å¦‚下。
短格å¼åŠå°æ‡‰çš„é•·æ ¼å¼ï¼š
'^A' ^Added
'^D' ^Deleted
'^M' ^Moved
'^C' ^Changed
這些是有效的輸出字串:
--^csformat="{^newline}在 {^date}建立的變更集 {^changesetid};{^tab} 已變更項目: {^items}。"
--^itemformat="{^newline}項目 {^path} 已在分支 {^branch} 中變更。"
範例:
cm ^log
(顯示æ¯å€‹åˆ†æ”¯åœ¨æœ€è¿‘一個月內所建立æ¯å€‹è®Šæ›´é›†çš„
相關資訊。)
cm ^log ^cs:16
(顯示變更集建立所在分支中之變更集 16 的
相關資訊。)
cm ^log ^cs:16 --^csformat="{^newline}變更集 {^changesetid}已建立於 \
{^date};{^tab} 已變更項目: {^items}。"
(以所指定格å¼ï¼Œé¡¯ç¤ºè³‡è¨Šã€‚)
cm ^log --^from=^cs:20 ^cs:50
(顯示從變更集 21 到變更集 50 中,æ¯å€‹è®Šæ›´é›†å…§å«
個別修訂的相關資訊。)
cm ^log --^from=^cs:20 ^cs:50 --^allbranches
(顯示儲存庫之個別分支的變更集 21 到變更集 50 中,
æ¯å€‹è®Šæ›´é›†å…§å«å€‹åˆ¥ä¿®è¨‚çš„
相關資訊。)
cm ^log ^rep:myrep@localhost:8084
(顯示指定儲存庫中所åšè®Šæ›´çš„相關資訊。
執行此命令時ä¸éœ€è¦ä»»ä½•工作å€ã€‚)
cm ^log --^from=^cs:20@^rep:mainRep@localhost:8084
(顯示變更集 21 中æ¯å€‹è®Šæ›´é›†æ‰€å…§å«ä¹‹å€‹åˆ¥ä¿®è¨‚çš„
相關資訊。執行此命令時ä¸éœ€è¦ä»»ä½•工作å€ï¼Œå› ç‚º
å·²æŒ‡å®šäº†å®Œæ•´çš„è®Šæ›´é›†è¦æ ¼ã€‚)
== CMD_DESCRIPTION_LIST ==
列出樹狀目錄的內容。
== CMD_USAGE_LIST ==
用法:
cm ^ls | ^dir [<路徑>[ ...]] [--^format=<字串_æ ¼å¼>] [--^symlink]
[--^selector[=<鏿“‡å™¨_æ ¼å¼>]] [--^tree=<物件_è¦æ ¼>]
[-^R | -^r | --^recursive]
[--^xml[=<輸出_檔案>]] [--^encoding=<å稱>]
é¸é …:
路徑 列出è¦é¡¯ç¤ºçš„路徑。使用空格分隔
路徑。
使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^symlink 將作業套用至符號連çµï¼Œè€Œä¸æ˜¯å¥—用至
目標。
--^selector å–得此作用中工作å€é¸æ“‡å™¨ä¸­çš„內容。
如已指定 [鏿“‡å™¨_æ ¼å¼],則會列出
æŒ‡å®šçš„é¸æ“‡å™¨ã€‚
這個鏿“‡å™¨å¹¾ä¹Žå·²æ£„ç”¨ï¼Œå› ç‚ºé€™äº›é¸æ“‡å™¨
自 4.x 版起已ä¸å†æ˜¯ Unity VCS 的中心部分。
--^tree 在指定的變更集或分支中,列出樹狀目錄。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
-^R éžè¿´åˆ—出。
--^xml å°‡ XML æ ¼å¼çš„輸出列å°è‡³æ¨™æº–輸出。
å¯ä»¥æŒ‡å®šè¼¸å‡ºæª”案。
--^encoding 與 '--^xml' é¸é …æ­é…使用,指定è¦åœ¨
XML 輸出中使用的編碼,亦å³ï¼šutf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
== CMD_HELP_LIST ==
備註:
- 路徑輸入å¯ä½¿ç”¨ä¸­ç¹¼å­—元。
- 實際清單ä¾å·¥ä½œå€é¸æ“‡å™¨è€Œå®šã€‚
- 此命令的輸出å¯ä¾æŒ‡å®šçš„æ ¼å¼å­—串格å¼åŒ–處ç†ã€‚
- 如果指定了--^tree' 或 --^selector' é¸é …,則指定的
路徑必須是伺æœå™¨è·¯å¾‘ (åˆç¨±ç‚º 'cm path'): /dir/file.txt,
而éžå·¥ä½œå€è·¯å¾‘: C:\Users\myuser\mywk\dir\file.txt
- 如未æä¾›ä»»ä½•路徑,則工作å€è·¯å¾‘應該是目å‰çš„
目錄。如果使用了 '--^tree' 或 '--^selector' é¸é …,則
應該是使用根目錄路徑 ("/")。
é è¨­æ ¼å¼å­—串:
"{^size,10} {^date:dd/MM/yyyy} {^date:HH:mm}\
{^type,-6} {^location,-12} {^checkout,-5} {^name}\
{^symlinktarget}"
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^size}
{^formattedsize}
{^date}
{^type}
^dir 目錄;
^txt 文字檔;
^File 檔案。
{^location} 範例:^br:branch#cset
{^checkout}
{^name}
{^changeset}
{^path}
{^repspec}
{^owner}
{^revid}
{^parentrevid}
{^itemid}
{^brid}
{^repid}
{^server}
{^symlinktarget}
{^hash}
{^chmod}
{^wkpath} å·¥ä½œå€æ ¹ç›®éŒ„的相å°è·¯å¾‘
{^branch}
{^newlocation} cset@branch
{^guid} (è§£æžæ‰€èŠ±æ™‚é–“è¼ƒé•·)
{^itemguid}
{^transformed} 顯示所轉æ›é …目上的套用è¦å‰‡
您å¯ä»¥è‡ªè¨‚ PLASTIC_LS_FORMAT 環境變數
'^ls' æ ¼å¼è¨­å®šã€‚
範例:
cm ^ls
cm ^ls c:\workspace\src
cm ^ls --^format={^name}
(僅檔å。)
cm ^ls --^symlink
(顯示符號連çµçš„相關資訊,而ä¸é¡¯ç¤ºã€Œå·²åŠ ä¸Šç¬¦è™Ÿã€çš„æª”案或目錄的
相關資訊。å¯ç”¨æ–¼ UNIX 環境。)
cm ^ls code --^selector
(顯示目å‰å·¥ä½œå€é¸æ“‡å™¨ä¸­ 'code' å­ç›®éŒ„çš„
內容。)
cm ^ls /code --^selector="^rep 'myrep' ^path '/' ^branch '/^main'"
(é¡¯ç¤ºæ‰€æŒ‡å®šé¸æ“‡å™¨ä¸Šå­ç›®éŒ„ '/code' 的內容。
請注æ„,此路徑是以伺æœå™¨æ ¼å¼æŒ‡å®šã€‚)
cm ^ls /code --^tree=44@myrep@denver:7070
(åˆ—å‡ºä½æ–¼ä¼ºæœå™¨ 'denver:7070' 儲存庫 'myrep' 變更集 44 çš„
å­ç›®éŒ„ '/code'。)
cm ^ls /code --^tree=^br:/main/scm13596@myrep@denver:7070
(列出ä½åœ¨ä¼ºæœå™¨ 'denver:7070' 儲存庫 'myrep' 分支
'/main/scm13596' 中最新變更集的å­ç›®éŒ„ '/code'。)
cm ^ls /code --^tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@myrep@denver:7070
(åˆ—å‡ºä½æ–¼ä¼ºæœå™¨ 'denver:7070' 儲存庫 'myrep'
變更集 ae1390ed-7ce9-4ec3-a155-e5a61de0dc77 的
å­ç›®éŒ„ '/code'。)
== CMD_DESCRIPTION_TRIGGER_LIST ==
在伺æœå™¨ä¸Šï¼Œåˆ—出指定類型的觸發器。
== CMD_USAGE_TRIGGER_LIST ==
用法:
cm ^trigger | ^tr ^list | ^ls [<å­é¡žåž‹-類型>] [--^server=<儲存庫伺æœå™¨è¦æ ¼>]
[--^format=<字串_æ ¼å¼>]
é¸é …:
å­é¡žåž‹-類型 觸發器執行與觸發器作業。
輸入 'cm ^showtriggertypes' 以查看觸發器
類型的清單。
--^server 在指定的伺æœå™¨ä¸Šåˆ—出觸發器。
如果未指定任何伺æœå™¨ï¼Œè«‹åœ¨ç”¨æˆ¶ç«¯ä¸Šè¨­å®šçš„
伺æœå™¨ä¸ŠåŸ·è¡Œå‘½ä»¤ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解伺æœå™¨
è¦æ ¼ã€‚)
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
== CMD_HELP_TRIGGER_LIST ==
備註:
如果未指定此類型,將列出伺æœå™¨ä¸Šçš„æ‰€æœ‰è§¸ç™¼å™¨ã€‚
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{0} 觸發器ä½ç½®ã€‚
{1} 觸發器å稱。
{2} 觸發器å稱。
{3} 觸發器å稱。
{4} 觸發器類型。
{5} 觸發器篩é¸ã€‚
範例:
cm ^trigger list after-mklabel
cm ^tr ^ls ^before-mkbranch --^server=myserver:8084
== CMD_DESCRIPTION_MANIPULATESELECTOR ==
將鏿“‡å™¨è®Šæ›´ç‚ºæ™‚間。
== CMD_USAGE_MANIPULATESELECTOR ==
這是自動化命令,目的僅é™ç”¨æ–¼è‡ªå‹•化 'cm'。
方便使用的程度並ä¸é«˜ã€‚
用法:
cm ^manipulateselector | ^ms [<工作å€_路徑> | <工作å€_è¦æ ¼>] --^atdate=<鏿“‡å™¨_日期>
工作å€_路徑 工作å€çš„路徑。
工作å€_è¦æ ¼ 工作å€è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
é¸é …:
--^atdate 傳回將é‡å»ºå·¥ä½œå€çš„鏿“‡å™¨ï¼Œ
å› å…¶å·²æœå°‹åˆ°æŒ‡å®šçš„æ—¥æœŸã€‚
== CMD_HELP_MANIPULATESELECTOR ==
備註:
如果未指定路徑或工作å€è¦æ ¼ï¼Œå‘½ä»¤å°‡ä»¥
ç›®å‰ç›®éŒ„åšç‚ºå·¥ä½œå€è·¯å¾‘。
範例:
cm ^manipulateselector c:\workspace --^atdate=yyyy-MM-ddTHH:mm:ss
cm ^manipulateselector --^atdate=yyyy-MM-ddTHH:mm:ss
cm ^manipulateselector > mySelector.txt --^atdate=yyyy-MM-ddTHH:mm:ss
cm ^manipulateselector ^wk:build_wk@BUILDER --^atdate=yyyy-MM-ddTHH:mm:ss
== CMD_DESCRIPTION_MERGE ==
åˆä½µåˆ†æ”¯èˆ‡å¦ä¸€å€‹åˆ†æ”¯ã€‚
== CMD_USAGE_MERGE ==
用法:
cm ^merge <來æº_è¦æ ¼> [--^merge] [--^cherrypicking] [--^forced]
[--^mergetype=(^onlyone|^onlysrc|^onlydst|^try|^forced)]
[--^interval-origin=<è®Šæ›´é›†è¦æ ¼> | --^ancestor=<è®Šæ›´é›†è¦æ ¼>]
[--^keepsource | --^ks] [--^keepdestination | --^kd]
[--^automaticresolution=<è¡çª-類型>[;...]]
[--^subtractive] [--^mount] [--^printcontributors]
[--^noprintoperations] [--^silent]
[(--^to=<åˆ†æ”¯è¦æ ¼> | --^destination=<åˆ†æ”¯è¦æ ¼>)[--^shelve]]
[--^no-dst-changes]
[-^c=<字串_註解> | --^commentsfile=<註解_檔案>]
[--^resolveconflict --^conflict=<索引>
--^resolutionoption=(^src|^dst|(^rename --^resolutioninfo=<字串å稱>))
--^mergeresultfile=<路徑> --^solvedconflictsfile=<路徑>]
[--^nointeractiveresolution]
[--^machinereadable [--^startlineseparator=<分隔符號>]
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
來æº_è¦æ ¼ è¦å¾žä¸­åˆä½µä¹‹ä¾†æºç‰©ä»¶çš„è¦æ ¼ï¼š
- åˆ†æ”¯è¦æ ¼ï¼š'[^br:/]br_name'
- æ¨™ç±¤è¦æ ¼ï¼š'^lb:lb_name'
- è®Šæ›´é›†è¦æ ¼ï¼š'^cs:cs_number'
- æ“±ç½®è¦æ ¼ï¼š'^sh:shelve_number'
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
é¸é …:
--^merge 執行åˆä½µã€‚å¦å‰‡ï¼Œåˆ—å°æ‰¾åˆ°çš„
è¡çªã€‚
--^cherrypicking åˆä½µåŒ…å«åœ¨ä¾†æºè®Šæ›´é›†å…§çš„
變更。如果åˆä½µä¾†æºè¦æ ¼æ˜¯å€‹æ¨™ç±¤ï¼Œ
則ä¸ä½¿ç”¨é€™å€‹é¸é …。
--^forced 如果來æºèˆ‡ç›®çš„地變更集已經連接,
則ä¸ç”¨æª¢æŸ¥ã€‚
這個é¸é …åªèƒ½ç”¨æ–¼é–“éš”åˆä½µ
å’Œæ€é¸ã€‚
--^mergetype 如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^interval-origin æŒ‡å®šè©²é¸æ“‡å“ªå€‹è®Šæ›´é›†ä¾†åšç‚º
間隔起點,使åˆä½µåƒ…處ç
在來æºè®Šæ›´é›†èˆ‡æ‰€æŒ‡å®š
間隔起點之間的ä¸åŒå…§å®¹ã€‚
--^ancestor 這是 --^interval-origin. 的別å。
--^keepsource 接å—來æºè²¢ç»è€…中,項目有è¡çªçš„
所有變更。
--^keepdestination ä¿ç•™ç›®çš„地貢ç»è€…中,項目有è¡çªçš„
變更。
--^automaticresolution 用於解決目錄è¡çªã€‚這個é¸é …
å¯è®“æ‚¨é¸æ“‡æ‡‰è‡ªå‹•é¸å
來æºè²¢ç»è€…或目的地貢ç»è€…
來解決è¡çªã€‚
使用分號來分隔è¡çªé¡žåž‹ã€‚
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^subtractive 刪除因åˆä½µæ‰€å¼•入的變更。傳éžè‡³
å‘½ä»¤çš„åƒæ•¸ (來æº_è¦æ ¼)
會用於指定è¦åˆªé™¤è®Šæ›´çš„
來æºä½ç½®ã€‚此來æºå¿…定是變更集。如果是
變更集間隔,則必須使用 '--^interval-origin'
來定義間隔起點。為了移除
變更,系統會建立全新的已簽出修訂,
其中將包å«ä¸Šä¸€å€‹é …目的內容,
åªæ˜¯ä¸åŒ…å«å·²åˆªé™¤çš„變更。
--^mount 指定儲存庫的è£è¼‰é»žã€‚
--^printcontributors 列å°å‡ºè²¢ç»è€… (基底ã€ä¾†æºèˆ‡
目的地)。
--^noprintoperations ä»¥ç„¡è¨Šæ¯æ–¹å¼è§£æ±ºåˆä½µï¼Œå®Œå…¨
ä¸é¡¯ç¤ºé—œæ–¼è§£æ±ºæ–¹æ³•的資訊。
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^to | --^destination é‹ç”¨å®Œæ•´è¡çªè§£æ±ºæ–¹æ³•,
å°‡åˆä½µç›®æ¨™ä½œæ¥­åŸ·è¡Œè‡³æ‰€æŒ‡å®šçš„分支
(é€éŽè¼¸å…¥åˆ†æ”¯è¦æ ¼æˆ– brspec)。
「åˆä½µç›®æ¨™ã€(或無工作å€åˆä½µ) 是在伺æœå™¨ç«¯
完æˆçš„åˆä½µã€‚而一般åˆä½µ
是「來æºã€åˆ†æ”¯ã€æ¨™ç±¤æˆ–變更集進行的工作å€åˆä½µï¼Œ
整個åˆä½µç›®æ¨™ä½œæ¥­æœƒå®Œå…¨
在伺æœå™¨ä¸Šå®Œæˆã€‚在一般åˆä½µä¸­ï¼Œ
ã€Œç›®çš„åœ°ã€æ˜¯æŒ‡å·¥ä½œå€ï¼Œè€Œåœ¨ã€Œåˆä½µç›®æ¨™ã€ä¸­ï¼Œ
ä¸€å®šè¦æŒ‡å®šç›®çš„地 (這樣æ‰åˆä¹Žå…¶å稱中的
「目標ã€)。
如需詳細資訊,請查看以下關於
「åˆä½µç›®æ¨™ã€åŠŸèƒ½çš„é€£çµï¼š
https://www.plasticscm.com/download/help/mergeto
--^shelve 建立包å«åˆä½µçµæžœ (加上åˆä½µè¿½è¹¤è³‡è¨Š)
çš„æ“±ç½®ï¼Œè€Œä¸æ˜¯å»ºç«‹
新的變更集。當åˆä½µä¾†æºç‚ºæ“±ç½®æ™‚,
這個é¸é …å°‡ä¸å¯ä½¿ç”¨ã€‚這個
é¸é …僅能用於 server-side-merge
ˆå為「åˆä½µç›®æ¨™ã€)。因此,必須指定 '--^to' å’Œ
'--^merge' é¸é …。
--^no-dst-changes 確定目的地貢ç»è€…沒有任何變更
(目的地變更集也是共åŒ
上層)。當目的地發生變更時,
å°‡ä¸å…許進行åˆä½µã€‚
-^c 將指定的註解套用至åˆä½µä½œæ¥­ä¸­
建立的變更集。
--^commentsfile 將指定檔案中的註解套用至åˆä½µä½œæ¥­ä¸­
建立的變更集。
--^resolveconflict (主è¦ç”±å¤–æŽ›ç¨‹å¼æ‰€ä½¿ç”¨ã€‚如需詳細資訊,請åƒé–±å‚™è¨»ã€‚)
用於解決目錄è¡çªã€‚
--^conflict æ­é… '--^resolveconflict' 標誌使用,指定
è¦è§£æ±ºè¡çªçš„索引,從 1 開始。
--^resolutionoption æ­é… '--^resolveconflict' 標誌使用,指示
解決è¡çªçš„類型。使用下列
其中一個é¸é …:'^src'ã€'^dst'ã€'^rename'。
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^resolutioninfo æ­é… '--^resolveconflict' 標誌使用,æä¾›
ç•¶ '--^resolutionoption' é¸é …為 'rename' 時
å°‡è¦ä½¿ç”¨çš„å稱。
--^mergeresultfile æ­é… '--^resolveconflict' 標誌使用,會將
ä¸åŒå‘¼å«ä¹‹é–“所造æˆçš„è¡çªè³‡è¨Š
輸出至檔案。指定的路徑
å°‡æ–¼ç¬¬ä¸€å€‹å‘¼å«æœŸé–“建立,並在後續的個別呼å«ä¸­
é€ä¸€æ›´æ–°ã€‚
--^solvedconflictsfile æ­é… '--^resolveconflict' 標誌使用,將
ä¸åŒå‘¼å«ä¹‹é–“所解決è¡çªçš„資訊
輸出至檔案。指定的
è·¯å¾‘å°‡åœ¨ç¬¬ä¸€å€‹å‘¼å«æœŸé–“建立,並在後續的個別呼å«ä¸­
é€ä¸€æ›´æ–°ã€‚
--^nointeractiveresolution (主è¦ç”±å¤–æŽ›ç¨‹å¼æ‰€ä½¿ç”¨ã€‚如需詳細資訊,請åƒé–±å‚™è¨»ã€‚)
會é¿å…æç¤ºä½¿ç”¨è€…進行手動è¡çªè§£æ±ºã€‚
如此將ä¸è§£æ±ºç›®éŒ„è¡çªã€‚
--^machinereadable (主è¦ç”±å¤–æŽ›ç¨‹å¼æ‰€ä½¿ç”¨ã€‚如需詳細資訊,請åƒé–±å‚™è¨»ã€‚)
以易於剖æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„行應如何起始。(é è¨­ï¼šç©ºçš„字串。)
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚(é è¨­ï¼šç©ºçš„字串。)
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,指定
應如何分隔欄ä½ã€‚(é è¨­ï¼š
空格。)
== CMD_HELP_MERGE ==
備註:
這個命令å¯ç”¨ä¾†åˆä½µå…©å€‹åˆ†æ”¯ä¹‹é–“的變更,或是標籤與分支
之間的變更。åˆä½µçš„目的地一定是個分支。
åˆä½µä¾†æºæœƒä»¥å¼•æ•¸æ–¹å¼æŒ‡å®šã€‚
目的地是工作å€çš„ç›®å‰å…§å®¹ã€‚
例如,若è¦é¡¯ç¤ºå°‡å¾žåˆ†æ”¯ task001 åˆä½µè‡³ä¸»è¦åˆ†æ”¯
çš„å…ƒç´ ï¼Œé¸æ“‡å™¨å¿…須指å‘主è¦åˆ†æ”¯ï¼Œå·¥ä½œå
一定會更新,並接著:
cm ^merge ^br:/task001
è‹¥è¦ç¢ºå¯¦å¯¦é𛿭¤åˆä½µï¼Œå‰‡è¦åŠ ä¸Š '--^merge' é¸é …:
cm ^merge ^br:/task001 --^merge
è‹¥è¦å®šç¾©åˆä½µä¾†æºï¼Œå¯ä»¥ä½¿ç”¨ä¸‹åˆ—è¦æ ¼ï¼š
- åˆ†æ”¯è¦æ ¼ (brspec):
[^br:/]br_name
範例:^br:/main/task001
(上é¢ç¯„例是執行從此分支中的最新變更集所進行的åˆä½µä½œæ¥­ã€‚)
- æ¨™ç±¤è¦æ ¼ (lbspec):
^lb:lb_name
範例:^lb:BL001
(從標記的變更集進行åˆä½µã€‚)
- è®Šæ›´é›†è¦æ ¼ï¼š
^cs:cs_number
範例:^cs:25
(從指定的變更集內容進行åˆä½µã€‚)
- æ“±ç½®è¦æ ¼ (shspec):
^sh:shelve_number
範例:^sh:2
(從指定的擱置內容進行åˆä½µã€‚)
è‹¥è¦è‡ªå‹•解決目錄è¡çªï¼Œè«‹ä½¿ç”¨ '--^automaticresolution' é¸é …,
並在指定è¡çªé¡žåž‹å¾ŒæŒ‡å®šå¿…須在åˆä½µä½œæ¥­æœŸé–“
é¸å–的貢ç»è€… (ä¾†æºæˆ–目的地)。
(使用分號 (;) 來分隔個別的「è¡çªé¡žåž‹-è²¢ç»è€…ã€é…å°ã€‚)
例如:
cm ^merge ^cs:2634 --^merge --^automaticresolution=^eviltwin-src;^changedelete-src
(從變更集 2634 進行的åˆä½µä½œæ¥­ï¼Œå¯ä»¥è§£æ±º "^eviltwin" 與
"^changedelete" è¡çªï¼Œå› é€™å€‹ä½œæ¥­æœƒåœ¨å…©é‚Šéƒ½ä¿ç•™ä¾†æº ("-^src")
è²¢ç»è€…。)
- 接在è¡çªé¡žåž‹ä¹‹å¾Œçš„ "-^src" 後綴,將會指示åˆä½µå‘½ä»¤ä¿ç•™
來æºè²¢ç»è€…變更。
- 如果是 "-^dst" 後綴,則將ä¿ç•™ç›®çš„地貢ç»è€…變更。
䏋颿˜¯åˆä½µå‘½ä»¤å¯æ”¯æ´çš„è¡çªé¡žåž‹æ¸…單:
"^movedeviltwin"ã€"^eviltwin"ã€"^changedelete"ã€"^deletechange"ã€"^movedelete"ã€
"^deletemove"ã€"^loadedtwice"ã€"^addmove"ã€"^moveadd"ã€"^divergentmove",
"^cyclemove"ã€"^all".
"^all" 值會覆寫其他的é¸é …。在下é¢ç¯„例中,
將忽略 "^eviltwin-dst"。
cm ^merge ^br:/main/task062 --^merge --^automaticresolution=^all-src;^eviltwin-dst
請查看下é¢é€£çµï¼Œä»¥æ·±å…¥çž­è§£åˆä½µè¡çªï¼š
https://www.plasticscm.com/download/help/directorymerges
䏋颿˜¯ '--^mergetype' çš„å¯ç”¨é¸é …:
^onlyone åœ¨åªæœ‰ä¸€å€‹è²¢ç»è€…修改éŽé …目時
自動åˆä½µã€‚
^onlysrc åœ¨åªæœ‰ä¾†æºè²¢ç»è€…修改éŽé …目時
自動åˆä½µã€‚
^onlydst åœ¨åªæœ‰ç›®çš„地貢ç»è€…修改éŽé …目時
自動åˆä½µã€‚
^try åœ¨åªæœ‰ä¸€å€‹è²¢ç»è€…修改éŽç¨‹å¼ç¢¼çš„è¡çªç‰‡æ®µ
(個別è¡çª) 時自動åˆä½µã€‚
^forced 一律嘗試解決所有éžè‡ªå‹•è¡çªã€‚
下é¢åˆ—出主è¦ç”±å¤–掛程å¼èˆ‡æ•´åˆä½œæ¥­æ‰€ä½¿ç”¨çš„é¸é …:
- '--^resolveconflict' å¯è§£æ±ºç›®éŒ„è¡çªã€‚這時也必須使用
下列é¸é …:
- '--^conflict' 是所è¦è§£æ±ºè¡çªçš„索引,
從 1 開始。
- '--^resolutionoption' 指示è¦ä½¿ç”¨çš„è¡çªè§£æ±º
方法。å¯é¸å–的解決方法如下:
- '^src' å¯ä¿ç•™ä¾†æºè®Šæ›´ï¼Œä¸¦æ¨æ£„
目的地變更
- '^dst' å¯ä¿ç•™ç›®çš„åœ°è®Šæ›´ï¼Œä¸¦æ¨æ£„
來æºè®Šæ›´
- '^rename' (僅在è¡çªé¡žåž‹æ”¯æ´é€™å€‹è§£æ±ºæ–¹æ³•時
é©ç”¨) å¯å°‡ç›®çš„åœ°é‡æ–°å‘½åæˆæ­é…
'--^resolutioninfo' é¸é …所æä¾›çš„æŒ‡å®šå稱。
- '--^resolutioninfo' å¯æä¾›å°‡ç”¨æ–¼ '^rename' 解決方法
çš„å稱
- '--^mergeresultfile' 與 '--^solvedconflictsfile',都å¯ç”¨æ–¼
儲存ä¸åŒå‘¼å«ä¹‹é–“çš„åˆä½µè³‡è¨Šã€‚
- '--^nointeractiveresolution' 坿Œ‡ç¤ºåˆä½µä¸è¦æ±‚使用者進行
手動è¡çªè§£æ±ºæ–¹æ³•。
- '--^machinereadable' å’Œ '--^startlineseparator'ã€'--^endlineseparator'ã€
'--^fieldseparator' ç­‰é¸é …,å¯å°‡è¼¸å‡ºåˆ—å°æˆé›»è…¦å¯è®€å–çš„
æ ¼å¼ (易於剖æžçš„)。
範例:
cm ^merge --^machinereadable --^startlineseparator=start@_@line \
--^endlineseparator=new@_@line --^fieldseparator=def#_#sep \
--^mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp \
--^solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp \
--^resolveconflict --^conflict=1 --^resolutionoption=rename \
--^resolutioninfo=目錄_目的地 ^br:/main/task --^merge
範例:
cm ^merge ^br:/task001
(ä¸åˆä½µï¼Œåªåˆ—å°å‡ºè¦åˆä½µçš„項目。)
cm ^merge ^br:/task001 --^merge
(執行從分支 'task001' 進行的åˆä½µã€‚)
cm ^merge ^cs:5 --^merge --^cherrypicking --^interval-origin=^cs:2
(從變更集間隔 [2,5] æ€é¸ã€‚)
cm ^merge ^cs:8 --^merge --^subtractive --^keepdestination
(從變更集 8 削減åˆä½µï¼Œä¿ç•™ç›®çš„地中有è¡çªçš„
元素變更。)
cm ^merge ^br:/main/task001 --^to=^br:/main --^merge -^c="æ•´åˆå¼æ–° UI"
(執行伺æœå™¨ç«¯åˆä½µï¼Œåˆå「åˆä½µç›®æ¨™ã€ï¼Œå°‡å¾žåˆ†æ”¯ 'task001' åˆä½µè‡³
分支 'main',並設定註解。)
cm ^merge ^br:/main/task001 --^to=^br:/main --^merge --^shelve
(執行從分支 'task001' 進行伺æœå™¨ç«¯åˆä½µè‡³åˆ†æ”¯ 'main',並在擱置上
ä¿ç•™çµæžœã€‚)
cm ^merge ^sh:2 --^to=^br:/main --^merge --^no-dst-changes
ªæœ‰åœ¨çµæžœæ˜¯å¾žç›®å‰ 'main' å‰ç«¯æ‰€å»ºç«‹æ™‚,æ‰å°‡æ“±ç½® 2 套用
至 'main'。)
== CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
建立新屬性。
== CMD_USAGE_ATTRIBUTE_CREATE ==
用法:
cm ^attribute | ^att ^create | ^mk <屬性_å稱>
屬性_å稱 屬性å稱
== CMD_HELP_ATTRIBUTE_CREATE ==
範例:
cm ^attribute ^create 狀態
(建立屬性 '狀態'。)
cm ^att ^mk æ•´åˆ
(建立屬性 'æ•´åˆ'。)
== CMD_DESCRIPTION_BRANCH ==
å¯è®“使用者管ç†åˆ†æ”¯ã€‚
== CMD_USAGE_BRANCH ==
用法:
cm ^branch | ^br <命令> [é¸é …]
命令:
^create | ^mk
^delete | ^rm
^rename
^history
^showmain
^showmerges
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^branch <命令> --^usage
cm ^branch <命令> --^help
== CMD_HELP_BRANCH ==
範例:
cm ^branch /main/scm21345
cm ^branch ^create /main/scm21345
cm ^branch ^delete /main/scm21345
cm ^branch ^rename /main/scm21345 scm21346
cm ^branch ^history /main/scm21345
cm ^branch ^showmain
cm ^branch ^showmerges file.txt
== CMD_DESCRIPTION_BRANCH_CREATE ==
建立新分支。
== CMD_USAGE_BRANCH_CREATE ==
用法:
cm ^branch | ^br [^create | ^mk] <åˆ†æ”¯è¦æ ¼>
[--^changeset=<è®Šæ›´é›†è¦æ ¼> | --^label=<æ¨™ç±¤è¦æ ¼>]
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
åˆ†æ”¯è¦æ ¼ 新分支的åç¨±æˆ–è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£åˆ†æ”¯è¦æ ¼ã€‚)
é¸é …:
--^changeset 用作新分支起點的變更集。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è®Šæ›´é›†è¦æ ¼ã€‚)
--^label 用作新分支起點的標籤。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£æ¨™ç±¤è¦æ ¼ã€‚)
-^c 將指定的文字填入新分支的
註解欄ä½ã€‚
-^commentsfile 將所指定檔案的內容填入
新分支的註解欄ä½ã€‚
== CMD_HELP_BRANCH_CREATE ==
備註:
è‹¥è¦å»ºç«‹æœ€ä¸Šå±¤åˆ†æ”¯ï¼Œè«‹æŒ‡å®šä¸å«ä»»ä½•階層的å稱。
例如:
cm ^br /dev
å¦‚æžœæœªæŒ‡å®šé¸æ“‡æ€§åƒæ•¸ '--^changeset',新分支的基底將是
上層分支的最後一個變更集。如果新分支
是最上層分支,則使用的基底變更集將會是 cset 0。
您å¯ä»¥ä½¿ç”¨ '-^c' 或 '-^m' 切æ›ä¾†æŒ‡å®šè¨»è§£ï¼š
cm ^branch /main/task001 -^c="這是註解"
cm ^branch /main/task001 -^m "這是註解"
設定 PLASTICEDITOR 環境變數,以指定è¦ç”¨ä¾†è¼¸å…¥è¨»è§£
的編輯器。如果已經設定 PLASTICEDITOR 環境變數,
且註解是空的,編輯器將自動啟動,並å…許您
指定註解。
範例:
cm ^branch task001
cm ^branch ^create task001
cm ^branch ^mk task001
cm ^br ^mk task001
(在目å‰å·¥ä½œå€çš„儲存庫中,建立最上層的分支
'task001'。)
cm ^branch ^br:/task001/task002@
(建立 'task002' 來åšç‚º 'task001' 的下層分支。)
cm ^br /main/task001@myrep@myserver:8084 -^c="我的註解"
(建立 'task001' 分支åšç‚ºå„²å­˜åº« 'myrep@myserver:8084'
中 'main' 的下層分支,加上 '我的註解'。)
cm ^branch ^br:/main/task001 --^changeset=2837 -^commentsfile=commenttask001.txt
(建立 'task001' 分支åšç‚º 'main' 的下層分支,基底為 'changeset=2837',
並將註解套用至 'commenttask001.txt' 檔案。)
== CMD_DESCRIPTION_BRANCH_DELETE ==
刪除一或多個分支。
== CMD_USAGE_BRANCH_DELETE ==
用法:
cm ^branch | ^br ^delete | ^rm <åˆ†æ”¯è¦æ ¼>[ ...]
åˆ†æ”¯è¦æ ¼ è¦åˆªé™¤çš„分支。使用空格分隔分支。
(使用 'cm ^help ^objectspec' 以深入瞭解分支
è¦æ ¼ã€‚)
== CMD_HELP_BRANCH_DELETE ==
備註:
此命令刪除一或多個分支。
範例:
cm ^branch ^delete /main/task001
(刪除屬於目å‰å·¥ä½œå€ä¸­å„²å­˜åº«å…§ 'main' 的下層分支,
å稱為 'task001' 的分支。)
cm ^br ^rm main/task002 /main/task012@reptest@myserver:8084
(刪除目å‰å·¥ä½œå€ä¹‹å„²å­˜åº«å…§çš„分支 '/main/task002',
以åŠå„²å­˜åº« 'reptest@myserver:8084' 內的分支 '/main/task012'。)
== CMD_DESCRIPTION_BRANCH_RENAME ==
釿–°å‘½å分支。
== CMD_USAGE_BRANCH_RENAME ==
用法:
cm ^branch | ^br ^rename <åˆ†æ”¯è¦æ ¼> <æ–°_å稱>
åˆ†æ”¯è¦æ ¼ è¦é‡æ–°å‘½å的分支。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£åˆ†æ”¯è¦æ ¼ã€‚)
æ–°_å稱 分支的新å稱。
== CMD_HELP_BRANCH_RENAME ==
備註:
æ­¤å‘½ä»¤æœƒé‡æ–°å‘½å分支。
範例:
cm ^branch ^rename /main/task0 task1
(將分支 '/main/task0' 釿–°å‘½åæˆ '/main/task1'。)
cm ^br ^rename ^br:/main@reptest@server2:8084 secondary
(將儲存庫 'reptest' 的分支 'main' 釿–°å‘½åæˆ 'secondary'。)
== CMD_DESCRIPTION_BRANCH_HISTORY ==
顯示分支的歷å²è¨˜éŒ„。
== CMD_USAGE_BRANCH_HISTORY ==
用法:
cm ^branch | ^br ^history <åˆ†æ”¯è¦æ ¼> [--^dateformat=<日期_æ ¼å¼>]
[--^machinereadable]
åˆ†æ”¯è¦æ ¼ è¦ä¿å­˜å…¶æ­·å²è¨˜éŒ„çš„åˆ†æ”¯è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£åˆ†æ”¯è¦æ ¼ã€‚)
é¸é …:
--^dateformat 用於輸出日期的格å¼ã€‚
--^machinereadable 以易於剖æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
== CMD_HELP_BRANCH_HISTORY ==
範例:
cm ^branch ^history ^br:/main/scm001@myrepository@myserver:8084
(顯示 'myserver' 伺æœå™¨ä¸Šï¼Œ'myrepository' 儲存庫之分支 '/main/scm001'
的歷å²è¨˜éŒ„。)
cm ^br ^history main --^dateformat="yyyy, dd MMMM" --^machinereadable
(以指定日期格å¼èˆ‡æ˜“於剖æžçš„æ ¼å¼ï¼Œé¡¯ç¤ºç›®å‰å„²å­˜åº«
之 'main' 分支的歷å²è¨˜éŒ„。)
== CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
顯示儲存庫的主è¦åˆ†æ”¯ã€‚
這是自動化命令,目的僅é™ç”¨æ–¼è‡ªå‹•化 'cm'。
儲存庫的主è¦åˆ†æ”¯å¾ˆæœ‰å¯èƒ½æ˜¯ '/main'。
== CMD_USAGE_BRANCH_SHOWMAIN ==
用法:
cm ^branch | ^br ^showmain [<å„²å­˜åº«è¦æ ¼>] [--^encoding=<å稱>]
[--^format=<æ ¼å¼_字串>] [--^dateformat=<日期_æ ¼å¼>]
å„²å­˜åº«è¦æ ¼ 其中將顯示主è¦åˆ†æ”¯çš„
å„²å­˜è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£å„²å­˜åº«è¦æ ¼ã€‚)
é¸é …:
--^encoding 指定è¦ç”¨æ–¼è¼¸å‡ºçš„編碼,
例如:utf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^dateformat 用於輸出日期的格å¼ã€‚
== CMD_HELP_BRANCH_SHOWMAIN ==
備註:
這個命令會顯示儲存庫的主è¦åˆ†æ”¯ã€‚
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^id} 分支 ID。
{^comment} 註解。
{^date} 日期。
{^name} å稱。
{^owner} æ“æœ‰è€…。
{^parent} 上層分支å稱。
{^repository} 儲存庫。
{^repname} 儲存庫å稱。
{^repserver} 伺æœå™¨ã€‚
{^changeset} 分支的å‰ç«¯è®Šæ›´é›†ã€‚
範例:
cm ^branch ^showmain
(顯示目å‰å·¥ä½œå€ä¹‹å„²å­˜åº«çš„主è¦åˆ†æ”¯ã€‚)
cm ^branch ^showmain repo@server:8084
(顯示伺æœå™¨ 'server:8084' 內,儲存庫 'repo' çš„
主è¦åˆ†æ”¯ã€‚)
cm ^br ^showmain --^dateformat="yyyy, dd MMMM" --^encoding=utf8
(以指定的日期格å¼é¡¯ç¤ºå„²å­˜åº«çš„主è¦åˆ†æ”¯ï¼Œ
且輸出的編碼為 utf8。)
cm ^br ^showmain --^format="{^id} - {^name}"
(顯示儲存庫的主è¦åˆ†æ”¯ï¼Œä¸”åªåˆ—å°å…¶ ID 與å稱。)
== CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
顯示待åˆä½µçš„分支。
== CMD_USAGE_BRANCH_SHOWMERGES ==
這是自動化命令,目的僅é™ç”¨æ–¼è‡ªå‹•化 'cm'。
方便使用的程度並ä¸é«˜ã€‚
用法:
cm ^branch | ^br ^showmerges <項目_路徑>[ ...]
[--^format=<æ ¼å¼_字串>]
[--^dateformat=<日期_æ ¼å¼>]
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^dateformat 用於輸出日期的格å¼ã€‚
== CMD_HELP_BRANCH_SHOWMERGES ==
備註:
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^id} 分支 ID。
{^comment} 註解。
{^date} 日期。
{^name} å稱。
{^owner} æ“æœ‰è€…。
{^parent} 上層分支å稱。
{^parentid} 上層分支 ID。
{^repid} 儲存庫 ID。
{^repository} 儲存庫。
{^repname} 儲存庫å稱。
{^repserver} 儲存庫伺æœå™¨ã€‚
範例:
cm ^branch ^showmerges file.txt
(é¡¯ç¤ºæ¶‰åŠ 'file.txt' å¾…åˆä½µä½œæ¥­çš„分支。)
cm ^branch ^showmerges file.txt --^format="{^date} {^name}" --^dateformat="yyMMdd"
(顯示涉åŠåˆä½µä½œæ¥­çš„分支,並以指定的日期格å¼ï¼Œ
åªåˆ—å°æ—¥æœŸèˆ‡å稱。)
== CMD_DESCRIPTION_REPOSITORY ==
å¯è®“使用者管ç†å„²å­˜åº«ã€‚
== CMD_USAGE_REPOSITORY ==
用法:
cm ^repository | ^repo <命令> [é¸é …]
命令:
^create | ^mk
^delete | ^rm
^list | ^ls
^rename
^add
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^repository <命令> --^usage
cm ^repository <命令> --^help
== CMD_HELP_REPOSITORY ==
範例:
cm ^repository
cm ^repository ^list
cm ^repository 新儲存庫
cm ^repository ^create 新儲存庫
cm ^repository ^rename 舊å稱 æ–°å稱
cm ^repository ^add C:\repo\
== CMD_DESCRIPTION_REPOSITORY_CREATE ==
在伺æœå™¨ä¸Šå»ºç«‹å„²å­˜åº«ã€‚
== CMD_USAGE_REPOSITORY_CREATE ==
用法:
cm ^repository | ^repo <儲存庫_å稱>
cm ^repository | ^repo <儲存庫伺æœå™¨è¦æ ¼> <儲存庫_å稱>[ ...]
cm ^repository | ^repo [^create | ^mk] <儲存庫_å稱>
儲存庫伺æœå™¨è¦æ ¼ 儲存庫伺æœå™¨è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺æœå™¨
è¦æ ¼ã€‚)
儲存庫_å稱 新儲存庫或多個儲存的å稱或多個å稱。
使用空格分隔儲存庫å稱。
== CMD_HELP_REPOSITORY_CREATE ==
範例:
cm ^repository MyRep
cm ^repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
cm ^repo ^create Rep01
cm ^repo ^mk 清單
== CMD_DESCRIPTION_REPOSITORY_DELETE ==
從伺æœå™¨ä¸­åˆªé™¤å„²å­˜åº«ã€‚
== CMD_USAGE_REPOSITORY_DELETE ==
用法:
cm ^repository | ^repo ^delete | ^rm <å„²å­˜åº«è¦æ ¼>
é¸é …:
å„²å­˜åº«è¦æ ¼ å„²å­˜åº«è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£å„²å­˜åº«è¦æ ¼ã€‚)
== CMD_HELP_REPOSITORY_DELETE ==
備註:
從儲存庫伺æœå™¨ä¸­åˆªé™¤å„²å­˜åº«ã€‚
資料並未從資料庫後端中移除,但已拔除連線,
因此無法å†å­˜å–。
(之後å¯é‡æ–°é€£æŽ¥è³‡æ–™ï¼Œè«‹åƒé–± 'cm ^repository ^add'。)
範例:
cm ^repository ^delete myrepository@^repserver:myserver:8084
cm ^repository ^rm myrepository@myserver:8084
cm ^repo ^rm myrepository
== CMD_DESCRIPTION_REPOSITORY_LIST ==
列出伺æœå™¨ä¸Šçš„儲存庫。
== CMD_USAGE_REPOSITORY_LIST ==
用法:
cm ^repository | ^repo [^list | ^ls] [<儲存庫伺æœå™¨è¦æ ¼>] [--^format=<字串_æ ¼å¼>]
é¸é …:
儲存庫伺æœå™¨è¦æ ¼ 儲存庫伺æœå™¨è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫伺æœå™¨
è¦æ ¼ã€‚)
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
== CMD_HELP_REPOSITORY_LIST ==
備註:
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{^repid} | {0} 儲存庫識別碼。
{^repname} | {1} 儲存庫å稱。
{^repserver} | {2} 伺æœå™¨å稱。
{^repowner} | {3} å„²å­˜åº«æ“æœ‰è€…。
{^repguid} | {4} 儲存庫的唯一識別碼。
{^tab} æ’入定ä½å­—元空格。
{^newline} æ’入新行。
如果格å¼åƒæ•¸å€¼æ˜¯ '^TABLE',輸出將使用
資料表格å¼èˆ‡ {^repid}ã€{^repname} å’Œ {^repserver} 等欄ä½å°å‡ºã€‚
範例:
cm ^repository
(列出所有儲存庫。)
cm ^repository ^list localhost:8084 --^format="{1, -20} {3}"
(在 20 個空格中寫入儲存庫å稱,é å·¦å°é½Šï¼ŒæŽ¥è‘—接上空白,
å†å¯«å…¥å„²å­˜åº«æ“有者。)
cm ^repository ^ls localhost:8084 --^format="{^repname, -20} {^repowner}"
(如先å‰ç¯„例方å¼ï¼Œå¯«å…¥å稱。)
cm ^repo ^ls localhost:8084 --^format=^TABLE
(使用資料格å¼ï¼Œä»¥åŠå„²å­˜åº« IDã€å„²å­˜åº«å稱ã€å„²å­˜åº«ä¼ºæœå™¨
å稱欄ä½ï¼Œå¯«å…¥å„²å­˜åº«çš„æ¸…單。)
== CMD_DESCRIPTION_REPOSITORY_RENAME ==
釿–°å‘½å儲存庫。
== CMD_USAGE_REPOSITORY_RENAME ==
用法:
cm ^repository | ^repo ^rename [<å„²å­˜åº«è¦æ ¼>] <æ–°_å稱>
å„²å­˜åº«è¦æ ¼ è¦é‡æ–°å‘½å的儲存庫。
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
è¦æ ¼ã€‚)
æ–°_å稱 儲存庫的新å稱。
== CMD_HELP_REPOSITORY_RENAME ==
備註:
æ­¤å‘½ä»¤æœƒé‡æ–°å‘½å儲存庫。
å¦‚æžœæœªæŒ‡å®šå„²å­˜æ ¼è¦æ ¼ï¼Œå°‡ç›´æŽ¥ä½¿ç”¨ç›®å‰å„²å­˜åº«ã€‚
範例:
cm ^repository ^rename development
(ç›®å‰çš„å„²å­˜åº«å°‡é‡æ–°å‘½åæˆç‚º 'development'。)
cm ^repo ^rename ^rep:default@SERVER:8084 development
('SERVER' 上的 'default' å„²å­˜åº«å°‡é‡æ–°å‘½å為 'development'。)
== CMD_DESCRIPTION_REPOSITORY_ADD ==
以新增資料庫方å¼ï¼Œé€£æŽ¥ç¾æœ‰çš„儲存庫。
== CMD_USAGE_REPOSITORY_ADD ==
用法:
cm ^repository | ^repo ^add <資料庫_檔案> <儲存庫_å稱> <儲存庫伺æœå™¨è¦æ ¼>
資料庫_檔案 在資料庫後端之資料庫檔案的å稱。
儲存庫_å稱 儲存庫的å稱。
儲存庫伺æœå™¨è¦æ ¼ 儲存庫伺æœå™¨è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
伺æœå™¨è¦æ ¼ã€‚)
== CMD_HELP_REPOSITORY_ADD ==
備註:
å°‡ç¾æœ‰çš„å„²å­˜åº«è³‡æ–™åº«é‡æ–°é€£æŽ¥è‡³ä¼ºæœå™¨ã€‚
範例:使用 'cm ^repository ^delete' 命令後,使用 '^add' 命令,
將儲存庫從一部伺æœå™¨ä¸­ç§»å‹•到其他伺æœå™¨ï¼Œæˆ–æ˜¯é‡æ–°é‚„原
å°å­˜çš„儲存庫。
範例:
cm ^repository ^add rep_27 myrepository myserver:8084
== CMD_DESCRIPTION_TRIGGER_CREATE ==
建立在伺æœå™¨ä¸Šçš„æ–°è§¸ç™¼å™¨ã€‚
== CMD_USAGE_TRIGGER_CREATE ==
用法:
cm ^trigger | ^tr ^create | ^mk <å­é¡žåž‹-類型> <æ–°_å稱> <指令碼_路徑>
[--^position=<æ–°_ä½ç½®>]
[--^filter=<字串_篩é¸>]
[--^server=<儲存庫伺æœå™¨è¦æ ¼>]
å­é¡žåž‹-類型 觸發器執行與觸發器作業。
輸入 'cm ^showtriggertypes' 以查看觸發器
類型的清單。
æ–°_å稱 新觸發器的å稱。
指令碼_路徑 è¦åŸ·è¡Œä¹‹æŒ‡ä»¤ç¢¼æ‰€åœ¨çš„伺æœå™¨çš„
ç£ç¢Ÿè·¯å¾‘。如果命令行開頭為 "^webtrigger",
觸發器將視為 Web 觸發器。如需
如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
é¸é …:
--^position 指定觸發器的新ä½ç½®ã€‚
æ­¤ä½ç½®ä¸å¾—由其他相åŒé¡žåž‹çš„觸發器
使用。
--^filter 僅檢查符åˆå·²æŒ‡å®šç¯©é¸æ¢ä»¶çš„項目。
--^server 建立在所指定伺æœå™¨ä¸Šçš„觸發器。
如果未指定任何伺æœå™¨ï¼Œè«‹åœ¨ç”¨æˆ¶ç«¯ä¸Šè¨­å®šçš„
伺æœå™¨ä¸ŠåŸ·è¡Œå‘½ä»¤ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
伺æœå™¨è¦æ ¼ã€‚)
== CMD_HELP_TRIGGER_CREATE ==
備註:
Web 觸發器:藉由輸入 "^webtrigger <目標-uri>"
åšç‚ºè§¸ç™¼å™¨å‘½ä»¤ï¼Œä»¥å»ºç«‹ Web 觸發器。在此情æ³ä¸‹ï¼Œè§¸ç™¼å™¨å°‡å°æ‡‰æŒ‡å®šçš„ URI 來執行
POST æŸ¥è©¢ï¼Œå…¶ä¸­è¦æ±‚本文包å«å…·æœ‰è§¸ç™¼å™¨
環境變數的 JSON å­—å…¸ï¼Œä»¥åŠæŒ‡å‘字串陣列
的 INPUT 金鑰。
範例:
cm ^trigger ^create ^after-setselector "BackupMgr" "/path/to/script" --^position=4
cm ^tr ^mk ^before-mklabel new "/path/to/script" --^server=myserver:8084
cm ^tr ^mk ^after-mklabel Log "/path/to/script" --^filter="^rep:myRep,LB*"
ªæœ‰ç•¶æ¨™ç±¤å稱以 'LB' 為開頭,且建立所在儲存庫å為
'myRep' æ™‚ï¼Œé€™å€‹è§¸ç™¼å™¨æ‰æœƒåŸ·è¡Œã€‚)
cm ^tr ^mk ^after-checkin NotifyTeam "^webtrigger http://myserver.org/api"
== CMD_DESCRIPTION_MOVE ==
ç§»å‹•æˆ–é‡æ–°å‘½å檔案或目錄。
== CMD_USAGE_MOVE ==
用法:
cm ^move | ^mv <來æº_路徑> <目的地_路徑> [--^format=<字串_æ ¼å¼>]
[--^errorformat=<字串_æ ¼å¼>]
來æº_路徑 來æºé …目路徑。
目的地_路徑 目的地項目路徑。
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^errorformat ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–錯誤訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
== CMD_HELP_MOVE ==
備註:
é€™å€‹å‘½ä»¤æœƒç§»å‹•æˆ–é‡æ–°å‘½å儲存庫中的項目。
變更也是在本機檔案系統中完æˆã€‚
如果來æºè·¯å¾‘是檔案,則目的地路徑å¯èƒ½ç‚ºæª”案或
目錄。在第一個情æ³ä¸­ï¼Œæœƒé‡æ–°å‘½å檔案;å¦å‰‡ï¼Œæœƒ
移動項目。
如果來æºè·¯å¾‘是個目錄,目的地路徑必須是目錄。
è¦ç§»å‹•æˆ–é‡æ–°å‘½å的項目必須存在。
æ ¼å¼ï¼š
{0} 來æºè·¯å¾‘ (åŒæ™‚é©ç”¨æ–¼ '--^format' å’Œ '--^errorformat')
{1} 目的地路徑 (åŒæ™‚é©ç”¨æ–¼ '--^format' å’Œ '--^errorformat')
範例:
cm ^move file.txt file.old
(釿–°å‘½å項目。)
cm ^mv .\file.old .\oldFiles
(將 'file.old' 移動到 'oldFiles'。)
cm ^move .\src .\src2
(釿–°å‘½å目錄。)
== CMD_DESCRIPTION_LABEL ==
å¯è®“ä½¿ç”¨è€…ç®¡ç†æ¨™ç±¤ã€‚
== CMD_USAGE_LABEL ==
用法:
cm ^label | ^lb <命令> [é¸é …]
命令:
^create | ^mk
^delete | ^rm
^rename
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^label <命令> --^usage
cm ^label <命令> --^help
== CMD_HELP_LABEL ==
範例:
cm ^label 我的新標籤 ^cs:42
('^create' å‘½ä»¤æ˜¯é¸æ“‡æ€§ã€‚)
cm ^label ^rename 我的新標籤 新標籤å稱
cm ^label ^delete 新標籤å稱
== CMD_DESCRIPTION_LABEL_CREATE ==
將標籤套用至變更集,並視需è¦å»ºç«‹æ¨™ç±¤ã€‚
== CMD_USAGE_LABEL_CREATE ==
用法:
cm ^label [^create] <åˆ†æ”¯è¦æ ¼> [<è®Šæ›´é›†è¦æ ¼> | <工作å€_路徑>]
[--^allxlinkedrepositories]
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
åˆ†æ”¯è¦æ ¼ 新標籤å稱。
(使用 'cm ^help ^objectspec' 以深入瞭解標籤
è¦æ ¼ã€‚)
è®Šæ›´é›†è¦æ ¼ 標籤變更集的åç¨±æˆ–å®Œæ•´è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
è¦æ ¼ã€‚)
工作å€_路徑 標籤工作å€çš„路徑。(å·¥ä½œå€æ‰€æŒ‡å‘çš„
變更集將加註標籤。)
é¸é …:
--^allxlinkedrepositories 建立在所有 Xlink 連çµå„²å­˜åº«ä¸­çš„æ–°æ¨™ç±¤ã€‚
-^c 將指定的註解套用至新標籤。
-^commentsfile 將指定檔案中的註解套用至
新標籤。
== CMD_HELP_LABEL_CREATE ==
備註:
設定 PLASTICEDITOR 環境變數,以指定è¦è¼¸å…¥
註解的編輯器。
範例:
cm ^label ^create ^lb:BL001 ^cs:1203 -^commentsfile=commentlb001.txt
(建立變更集 1203 所連接的標籤 'BL001',並套用在
'commentlb001.txt' 檔案中的註解。)
cm ^label BL002 ^cs:1203 -^c="åˆæ¬¡ç™¼è¡Œ"
(建立標籤 'BL002',å«è¨»è§£ï¼Œä¸¦é€£æŽ¥è‡³è®Šæ›´é›† 1203。)
== CMD_DESCRIPTION_LABEL_DELETE ==
刪除一或多個標籤。
== CMD_USAGE_LABEL_DELETE ==
用法:
cm ^label ^delete <æ¨™ç±¤è¦æ ¼>[ ...]
æ¨™ç±¤è¦æ ¼ è¦åˆªé™¤çš„æ¨™ç±¤ã€‚使用空格分隔標籤。
(使用 'cm ^help ^objectspec' 以深入瞭解標籤
è¦æ ¼ã€‚)
== CMD_HELP_LABEL_DELETE ==
備註:
此命令刪除一或多個標籤。
範例:
cm ^label ^delete ^lb:BL001
(刪除標籤 'BL001'。)
cm ^label ^delete ^lb:BL001 ^lb:BL002@reptest@server2:8084
(刪除標籤 'BL001' 和 'BL002'。)
== CMD_DESCRIPTION_LABEL_RENAME ==
釿–°å‘½å標籤。
== CMD_USAGE_LABEL_RENAME ==
用法:
cm ^label ^rename <æ¨™ç±¤è¦æ ¼> <æ–°_å稱>
æ¨™ç±¤è¦æ ¼ è¦é‡æ–°å‘½å的標籤。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£æ¨™ç±¤è¦æ ¼ã€‚)
æ–°_å稱 新增標籤的å稱。
== CMD_HELP_LABEL_RENAME ==
備註:
æ­¤å‘½ä»¤æœƒé‡æ–°å‘½å標籤。
範例:
cm ^label ^rename ^lb:BL001 BL002
(將標籤 'BL001' 釿–°å‘½åæˆ 'BL002'。)
== CMD_DESCRIPTION_OBJECTSPEC ==
æè¿°å¦‚ä½•å¯«å…¥ç‰©ä»¶è¦æ ¼ã€‚
== CMD_USAGE_OBJECTSPEC ==
用法:
cm ^objectspec
å¯å–å¾—æ‰€æœ‰é—œæ–¼å¦‚ä½•å»ºç«‹ç‰©ä»¶è¦æ ¼çš„資訊。
== CMD_HELP_OBJECTSPEC ==
多種 Unity VCS å‘½ä»¤éƒ½æœƒå°‡ã€Œç‰©ä»¶è¦æ ¼ã€ç•¶åšè¼¸å…¥ï¼Œä»¥ä¾¿åƒè€ƒè‡³
指定的物件 (通常是分支ã€è®Šæ›´é›†ã€å„²å­˜åº«ç­‰)。
這份文件說明ä¸åŒçš„å¯ç”¨ã€Œè¦æ ¼ã€ï¼ŒåŠå…¶
建置方å¼ã€‚
æ¯ç¨®è¦æ ¼é¡žåž‹éƒ½æœƒä»¥å”¯ä¸€æ¨™ç±¤åšç‚ºé–‹é ­ï¼Œä¾‹å¦‚ "^rep:" 或 "^cs:"。這個標籤
必須專為接å—ä¸€èˆ¬ç‰©ä»¶è¦æ ¼çš„命令建立,例如,
"cm ^setowner 物件_è¦æ ¼"ï¼Œä½†åªæŽ¥å—å–®ä¸€é¡žåž‹è¦æ ¼çš„命令,例如
"cm ^getfile 修訂_è¦æ ¼"ï¼Œç¶“å¸¸æœƒç•¥éŽæ­¤æ¨™ç±¤ã€‚
-- 儲存庫伺æœå™¨è¦æ ¼ (repserverspec) --
^repserver:name:port
範例:
cm ^repo ^list ^repserver:skull:8084
cm ^repo ^list skull:8084
快速筆記:
æˆ‘å€‘å°‡æ­¤é¡žè¦æ ¼ç¨±ç‚ºã€Œå„²å­˜åº«ä¼ºæœå™¨è¦æ ¼ã€ï¼Œè€Œä¸å…‰åªæ˜¯
「伺æœå™¨è¦æ ¼ã€ï¼ŒåŽŸå› å¦‚ä¸‹ã€‚å¾ˆä¹…ä»¥å‰ï¼Œæˆ‘們有ä¸åŒçš„工作å€å’Œå„²å­˜åº«
伺æœå™¨ï¼Œè€Œæ²¿ç”¨äº†ç•¶æ™‚çš„å‘½åæ–¹å¼ã€‚
-- å„²å­˜åº«è¦æ ¼ (repspec) --
^rep:rep_name@[儲存庫伺æœå™¨è¦æ ¼]
範例:
cm ^showowner ^rep:codice@localhost:6060
(在這個範例中,必須使用 "^rep:",因為 ^showowner ä¸åªå‡†è¨±å„²å­˜åº«
ä¹Ÿå‡†è¨±å…¶ä»–é¡žåž‹çš„ç‰©ä»¶ã€‚æ‰€ä»¥æœƒè¦æ±‚使用者指明
物件類型。)
-- åˆ†æ”¯è¦æ ¼ (brspec) --
^br:[/]br_name[@repspec]
範例:
cm ^switch ^br:/main@^rep:plastic@^repserver:skull:9095
(這時並ä¸éœ€è¦ "^br:"ã€"^rep" å’Œ "^repserver",因此
命令准許更短的形å¼ï¼š
"cm ^switch main@plastic@skull:9095"。)
cm ^find ^revisions "^where ^branch='^br:/main/task001'"
備註:
分支並ä¸å¼·åˆ¶ä½¿ç”¨åˆå§‹ç¬¦è™Ÿ '/'。我們習慣以 /mainã€
/main/task001 (便­¤é¡žæŽ¨) æ–¹å¼ï¼ŒæŒ‡å®šæ‰€æœ‰åˆ†æ”¯ã€‚如今,我們å用
è¼ƒçŸ­çš„æ ¼å¼ mainã€main/task001,使命令更為簡潔。
-- è®Šæ›´é›†è¦æ ¼ --
^cs:cs_number|cs_GUID[@repspec]
變更集的號碼或 GUID å¯é€²è¡ŒæŒ‡å®šã€‚
範例:
cm ^ls /code --^tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070
-- æ¨™ç±¤è¦æ ¼ (labelspec) --
^lb:lb_name[@repspec]
範例:
cm ^switch ^lb:RELEASE2.0
cm ^switch ^lb:RELEASE1.4@myrep@MYSERVER:8084
-- ä¿®è¨‚è¦æ ¼ --
ä¿®è¨‚è¦æ ¼åˆ†ç‚ºå¤šç¨®é¡žåž‹ï¼š
^rev:item_path[#(åˆ†æ”¯è¦æ ¼|è®Šæ›´é›†è¦æ ¼|æ¨™ç±¤è¦æ ¼]
^rev:^serverpath:item_path#(åˆ†æ”¯è¦æ ¼|變更集_è¦æ ¼|標籤_è¦æ ¼)
^rev:^revid:rev_id[@rep_spec]
^rev:^itemid:item_id#(分支_è¦æ ¼|變更集_è¦æ ¼|標籤_è¦æ ¼)
範例:
cm ^diff ^rev:readme.txt#^cs:19 ^rev:readme.txt#^cs:20
cm ^diff ^serverpath:/doc/readme.txt#^cs:19@myrepo \
^serverpath:/doc/readme.txt#^br:/main@myrepo@localhost:8084
cm ^cat ^revid:1230@^rep:myrep@^repserver:myserver:8084
-- é …ç›®è¦æ ¼ --
^item:path
很少使用。
範例:
cm ^find ^revision "^where ^item='^item:.'"
-- å±¬æ€§è¦æ ¼ --
^att:att_name[@repspec]
範例:
cm ^attribute ^set ^att:merged@code@doe:8084 ^cs:25@code@doe:8084 完æˆ
-- æ“±ç½®è¦æ ¼ --
^sh:sh_number[@repspec]
範例:
cm ^diff ^sh:2 ^sh:4
-- 工作å€è¦æ ¼ --
^wk:name@clientmachine
很少使用,僅套用到與工作å€ç›¸é—œçš„命令。å¯ç”¨æ–¼
便“šå稱和機器 (而ä¸ä¾æ“šè·¯å¾‘) 來指定工作å€ã€‚
範例:
cm ^showselector ^wk:codebase@modok
快速筆記:
這些是éŽåŽ»ä½¿ç”¨ Plastic SCM 2.x æ™‚æ‰€å»ºç«‹çš„è¦æ ¼ï¼Œç•¶æ™‚使用
「工作å€ä¼ºæœå™¨ã€ä½œç‚ºé›†ä¸­å„²å­˜å·¥ä½œå€ä¸­ç¹¼è³‡æ–™
的方å¼ã€‚ç¾åœ¨é€™äº›æ–¹æ³•已因效能因素而棄用。
== CMD_DESCRIPTION_PARTIAL ==
在局部工作å€ä¸­åŸ·è¡Œå‘½ä»¤ã€‚
== CMD_USAGE_PARTIAL ==
用法:
cm ^partial <命令> [é¸é …]
命令:
^configure
^add
^undo
^co | ^checkout
^unco | ^undocheckout
^ci | ^checkin
^mv | ^move
^rm | ^remove
^stb | ^switch
^upd | ^update
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^partial <命令> --^usage
cm ^partial <命令> --^help
== CMD_HELP_PARTIAL ==
範例:
cm ^partial ^configure +/background-blue.png
cm ^partial ^update landscape-1024.png
cm ^partial ^checkin eyes-green.png eyes-black.png
== CMD_DESCRIPTION_PARTIAL_ADD ==
將項目新增至版本控制。
== CMD_USAGE_PARTIAL_ADD ==
用法:
cm ^partial ^add [-^R | -^r | --^recursive] [--^silent] [--^parents]
[--^ignorefailed] [--^skipcontentcheck] <項目_路徑>[ ...]
é …ç›®_路徑 è¦æ–°å¢žçš„項目。使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。使用空格分隔路徑。
使用 * 以新增目å‰ç›®éŒ„的所有內容。
é¸é …:
-^R éžè¿´æ–°å¢žé …目。
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^parents 包括作業中所指定項目的
上層目錄。
--^ignorefailed 如果無法新增項目,新增作業將會在沒有項目的情æ³ä¸‹ï¼Œ
繼續進行新增作業。請注æ„:如果無法新增目錄
ï¼Œå‰‡ä¸æœƒæ–°å¢žå…¶å…§å®¹ã€‚
--^skipcontentcheck 當擴充功能ä¸è¶³ä»¥å°‡æª”案設為文字
æˆ–äºŒé€²ä½æ™‚,將é è¨­ç‚ºäºŒé€²ä½ï¼Œè€Œä¸æ˜¯
æª¢æŸ¥å…§å®¹ä¾†åµæ¸¬é¡žåž‹ã€‚
== CMD_HELP_PARTIAL_ADD ==
備註:
æ–°å¢žé …ç›®çš„è¦æ±‚:
- è¦æ–°å¢žä¹‹é …目的上層目錄必須是先å‰å·²æ–°å¢žçš„目錄。
範例:
cm ^partial ^add pic1.png pic2.png
(新增項目 'pic1.png' 和 'pic2.png'。)
cm ^partial ^add c:\workspace\picture.png
(在路徑 'c:\workspace' 中新增項目 'picture.png'。)
cm ^partial ^add -^R c:\workspace\src
žè¿´æ–°å¢ž 'src'。)
cm ^partial ^add --^parents samples\design01.png
(新增 'design01.png' 檔案和 'samples' 上層資料夾。)
cm ^partial ^add -^R *
žè¿´æ–°å¢žç›®å‰ç›®éŒ„的所有內容。)
== CMD_DESCRIPTION_PARTIAL_CHECKIN ==
在此儲存庫中儲存變更。
== CMD_USAGE_PARTIAL_CHECKIN ==
用法:
cm ^partial ^checkin | ^ci [<項目_路徑>[ ...]]
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
[--^all | -^a] [--^applychanged] [--^keeplock]
[--^symlink] [--^ignorefailed]
é¸é …:
é …ç›®_路徑 è¦ç°½å…¥çš„項目。使用雙引號 (" ") 指定
å«ç©ºæ ¼çš„路徑。使用空格分隔
路徑。
使用 . 將簽入套用至目å‰ç›®éŒ„。
-^c 指定簽入作業中所建立變更集
的註解。
-^commentsfile 將指定檔案的註解套用至
簽入作業中建立的變更集。
--^all | -^a 在指定路徑上,從本地進行變更ã€ç§»å‹•和刪除
的項目也包括在內。
--^applychanged 將簽入作業套用至工作å€ä¸­åµæ¸¬åˆ°
的變更項目,以åŠç°½å‡º
項目。
--^keeplock 在簽入作業後繼續ä¿ç•™éŽ–å®šå·²éŽ–å®šçš„
項目。
--^symlink 將簽入作業套用至符號連çµï¼Œè€Œä¸æ˜¯
套用至目標。
--^ignorefailed 任何無法套用的變更 (因無法擷å–鎖定
- åˆå為ç¨ä½”簽出,或因本地變更
與伺æœå™¨è®Šæ›´å­˜åœ¨è¡çª) 已魿¨æ£„,
因此簽入作業會繼續執行,
但ä¸åŒ…å«é€™äº›è®Šæ›´ã€‚
== CMD_HELP_PARTIAL_CHECKIN ==
備註:
- 如果未指定 <é …ç›®_路徑>,簽入將涉åŠå·¥ä½œå€ä¸­
所有暫止的變更。
- 此簽入作業一律從指定路徑éžè¿´å¥—用。
- è‹¥è¦ç°½å…¥é …目:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
- 必須簽出項目。
- 如果項目已變更,但未簽出,則ä¸ä¸€å®šè¦æœ‰ '--^applychanged' 標誌
ï¼Œé™¤éž <é …ç›®_路徑> 是目錄,或包å«
è¬ç”¨å­—å…ƒ ('*')。
修訂內容應該與先å‰ä¿®è¨‚ä¸åŒï¼Œæ‰èƒ½
簽入。
設定 PLASTICEDITOR 環境變數,以指定è¦è¼¸å…¥
註解的編輯器。
從 stdin 讀å–輸入:
命令 '^partial ^checkin' å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯
傳éžå–®ä¸€ç ´æŠ˜è™Ÿã€Œ-ã€ä¾†å®Œæˆã€‚
範例:cm ^partial ^checkin -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“您使用管線以指定è¦ç°½å…¥çš„æª”案。
範例:
dir /S /B *.c | cm ^partial ^checkin --^all -
(在 Windows 中,簽入工作å€ä¸­æ‰€æœ‰ .c 檔案。)
範例:
cm ^partial ^checkin figure.png landscape.png
(套用簽入到 'figure.png' 和 'landscape.png' 已簽出檔案。)
cm ^partial ^checkin .-^commentsfile=mycomment.txt
(套用簽入到目å‰çš„目錄,並從 'mycomment.txt' 檔案設定
註解。)
cm ^partial ^ci background.png -^c="我的註解" --^keeplock
(套用簽入到 'background.png',包括註解,並ä¿ç•™
鎖定狀態。)
cm ^partial ^checkin --^applychanged
(套用簽入到工作å€ä¸­çš„æ‰€æœ‰æš«æ­¢è®Šæ›´ã€‚)
cm ^partial ^checkin é€£çµ --^symlink
(å¥—ç”¨ç°½å…¥åˆ°é€£çµæª”案,而éžç›®æ¨™ï¼›é©ç”¨æ–¼
UNIX 環境。)
cm ^partial ^checkin .--^ignorefailed
(套用簽入到目å‰çš„目錄,因此忽略無法套用的
變更。)
== CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
將檔案標示為準備好修改。
== CMD_USAGE_PARTIAL_CHECKOUT ==
用法:
cm ^partial ^checkout | ^co [<é …ç›®_路徑>[ ...]] [--^resultformat=<字串_æ ¼å¼>]
[--^silent] [--^ignorefailed]
é¸é …:
é …ç›®_路徑 è¦ç°½å‡ºçš„項目。使用雙引號 (" ") 指定
å«ç©ºæ ¼çš„路徑。使用空格分隔
路徑。
使用 . 將簽出套用至目å‰ç›®éŒ„。
--^resultformat ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出
çµæžœè¨Šæ¯ã€‚
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^ignorefailed 如果無法鎖定項目 (無法執行ç¨ä½”簽出),
則會在沒有項目的情æ³ä¸‹ï¼Œ
繼續進行簽出作業。
== CMD_HELP_PARTIAL_CHECKOUT ==
備註:
è‹¥è¦ç°½å‡ºé …目:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
- 必須簽入項目。
如果在伺æœå™¨ä¸Šå·²è¨­å®šéŽ–å®š (lock.conf 存在)ï¼Œé‚£éº¼æ¯æ¬¡åœ¨è·¯å¾‘上
發生簽出時,Unity VCS 會檢查其是å¦ç¬¦åˆä»»ä½•è¦å‰‡ï¼Œå¦‚果符åˆï¼Œ
該路徑會處於ç¨ä½”簽出 (已鎖定),如此一來,就沒有人
å¯ä»¥åŒæ™‚簽出。
您å¯ä»¥ä½¿ç”¨ 'cm ^lock ^list' 以å–得伺æœå™¨ä¸­çš„æ‰€æœ‰éŽ–å®šã€‚
æŸ¥çœ‹ã€Šç®¡ç†æŒ‡å—》以瞭解鎖定的é‹ä½œæ–¹å¼ï¼š
https://www.plasticscm.com/download/help/locking
範例:
cm ^partial ^checkout pic1.png pic2.png
(簽出檔案 'pic1.png' 和 'pic2.png'。)
cm ^partial ^co *.png
(簽出所有 png 檔案。)
cm ^partial ^checkout .
(簽出目å‰ç›®éŒ„。)
cm ^partial ^checkout -^R c:\workspace\src
žè¿´ç°½å‡º 'src' 資料夾。)
== CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
å…許é€éŽå°‡é …ç›®è¼‰å…¥å·¥ä½œå€æˆ–å¾žå…¶ä¸­å–æ¶ˆè¼‰å…¥ï¼Œé€²è¡Œå·¥ä½œå€è¨­å®šã€‚
== CMD_USAGE_PARTIAL_CONFIGURE ==
用法:
cm ^partial ^configure <+|-路徑>[ ...][--^silent] [--^ignorefailed]
[--^ignorecase] [--^restorefulldirs]
路徑 è¦è¼‰å…¥æˆ–å–æ¶ˆè¼‰å…¥çš„路徑。使用雙引號 (" ")
指定å«ç©ºæ ¼çš„路徑。使用空格分隔
路徑。
路徑開頭必須為 "/"。
é¸é …:
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^ignorefailed ç•¥éŽéŽç¨‹ä¸­çš„æ‰€æœ‰éŒ¯èª¤ã€‚䏿­£ç¢ºçš„路徑
䏿œƒé€ æˆå‘½ä»¤åœæ­¢åŸ·è¡Œã€‚
--^ignorecase 忽略路徑的大å°å¯«å€åˆ†ã€‚æ­é…這個標誌時,'^configure'
å°‡é©ç”¨æ–¼ "/Data/Textures",å³ä½¿ä½¿ç”¨è€…是寫入
"/data/teXtures"。
--^restorefulldirs é‡è¨­ç„¡æ•ˆçš„目錄設定 (發生在
éžå±€éƒ¨ä½œæ¥­åŸ·è¡Œæ–¼å±€éƒ¨å·¥ä½œå€ä¸­æ™‚)。
在這個清單中的目錄將會完全設定
(完整檢查),這表示進行更新時,這些目錄都將
自動下載全新內容。
é€™å€‹ä½œæ¥­ä¸æœƒä¸‹è¼‰ä»»ä½•檔案,而是僅
還原在局部工作å€ä¸Šçš„
目錄設定。
== CMD_HELP_PARTIAL_CONFIGURE ==
備註:
此命令應該會執行éžè¿´ä½œæ¥­ã€‚
範例:
cm ^partial ^configure +/landscape_grey.png
(載入項目 'landscape_grey.png'。)
cm ^partial ^configure -/landscape_black.png
–消載入項目 'landscape_black.png'。)
cm ^partial ^configure +/soft -/soft/soft-black.png
(載入所有 'soft' 目錄下層項目,但 'soft-black.png' 除外。)
cm ^partial ^configure -/
–消載入整個工作å€ã€‚)
cm ^partial ^configure -/ +/
(載入整個工作å€ã€‚)
cm ^partial ^configure -/figure-64.png --^ignorefailed
–消載入 'figure-64.png' 項目,å³ä½¿å…¶å·²ç¶“å–æ¶ˆè¼‰å…¥ã€‚)
cm ^partial ^configure +/ --^restorefulldirs
(將所有目錄設æˆè‡ªå‹•下載新內容。)
cm ^partial ^configure +/src/lib --^restorefulldirs
(僅將 '/src/lib' åŠå…¶å­ç›®éŒ„設æˆè‡ªå‹•下載
新內容。)
== CMD_DESCRIPTION_PARTIAL_MOVE ==
ç§»å‹•æˆ–é‡æ–°å‘½å檔案或目錄。
== CMD_USAGE_PARTIAL_MOVE ==
用法:
cm ^partial ^move | ^mv <來æº_路徑> <目的地_路徑> [--^format=<字串_æ ¼å¼>]
來æº_路徑 來æºé …目路徑。
目的地_路徑 目的地項目路徑。
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
== CMD_HELP_PARTIAL_MOVE ==
備註:
é€™å€‹å‘½ä»¤æœƒç§»å‹•æˆ–é‡æ–°å‘½å儲存庫中的項目。
變更也是在本機檔案系統中完æˆã€‚
如果來æºè·¯å¾‘是檔案,則目的地路徑å¯èƒ½ç‚ºæª”案或
目錄。在第一個情æ³ä¸­ï¼Œå°‡æœƒé‡æ–°å‘½å檔案;å¦å‰‡ï¼Œå°‡
移動項目。
如果來æºè·¯å¾‘是個目錄,目的地路徑必須是目錄。
è¦ç§»å‹•æˆ–é‡æ–°å‘½å的項目必須存在。
æ ¼å¼ï¼š
{0} 來æºè·¯å¾‘。
{1} 目的地路徑。
範例:
cm ^partial ^move file.png file-blue.png
(釿–°å‘½å項目。)
cm ^partial ^mv .\file-blue.png .\blueFiles
(將 'file-blue.png' 移到 'blueFiles'。)
cm ^partial ^move .\design .\marketing
(釿–°å‘½å目錄。)
== CMD_DESCRIPTION_PARTIAL_REMOVE ==
從版本控制刪除檔案或目錄。
== CMD_USAGE_PARTIAL_REMOVE ==
用法:
cm ^partial ^remove | ^rm <項目_路徑>[ ...][--^nodisk]
é …ç›®_路徑 è¦ç§»é™¤çš„項目路徑。使用雙引號 (" ")
指定å«ç©ºæ ¼çš„路徑。使用空格分隔
路徑。
é¸é …:
--^nodisk 從版本控制移除,但將項目ä¿ç•™åœ¨ç£ç¢Ÿä¸Šã€‚
== CMD_HELP_PARTIAL_REMOVE ==
備註:
會從ç£ç¢Ÿåˆªé™¤é …目。會從原始程å¼ç¢¼æŽ§åˆ¶çš„上層目錄中
移除已移除的項目。
è¦æ±‚:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
範例:
cm ^partial ^remove src
(移除 'src'。如果 'src' æ˜¯ç›®éŒ„ï¼Œçµæžœå°‡èˆ‡ä¸‹é¢å‘½ä»¤ç›¸åŒï¼š
cm ^partial ^remove -^R src。)
cm ^partial ^remove c:\workspace\pic01.png --^nodisk
(å°‡ 'pic01.png' 從版本控制中移除,但ä¿ç•™æ–¼ç£ç¢Ÿä¸­ã€‚)
== CMD_DESCRIPTION_PARTIAL_SWITCH ==
將分支設定為工作分支。
== CMD_USAGE_PARTIAL_SWITCH ==
用法:
cm ^switch <分支_è¦æ ¼> [--^report | --^silent] [--^workspace=<路徑>]
(設定工作分支,並更新工作å€ã€‚)
cm ^switch <分支_è¦æ ¼> --^configure <+|-路徑>[ ...][--^silent]
[--^ignorefailed] [--^ignorecase] [--^workspace=<路徑>]
(設定工作分支,並使工作å€è¨­å®šçš„åŸ·è¡Œå¦‚åŒ 'cm
^partial ^configure' 命令。)
分支_è¦æ ¼ åˆ†æ”¯è¦æ ¼ã€‚(使用 'cm ^help ^objectspec' 以深入瞭解
åˆ†æ”¯è¦æ ¼ã€‚)
路徑 è¦è¼‰å…¥æˆ–å–æ¶ˆè¼‰å…¥çš„路徑。使用雙引號 (" ")
指定å«ç©ºæ ¼çš„路徑。使用空格
分隔路徑。路徑開頭必須為 "/"。
é¸é …:
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^report åœ¨å‘½ä»¤å®Œæˆæ™‚列å°å·²å¥—用變更
的清單。使用 '--^silent' 時將會覆寫這個設定。
這個é¸é …僅é©ç”¨æ–¼æœªæŒ‡å®š '--^configure' é¸é …
的情æ³ã€‚
--^configure 在工作å€åˆ†æ”¯æ›´æ–°å¾Œ
設定 (載入 / å–æ¶ˆè¼‰å…¥é …ç›®) 工作å€ã€‚查看 'cm ^partial
^configure --^help' 以瞭解如何指定這些è¦è¨­å®šçš„
路徑。
--^ignorefailed ç•¥éŽè¨­å®šéŽç¨‹ä¸­æ‰€å‡ºç¾çš„æ‰€æœ‰éŒ¯èª¤ã€‚
䏿­£ç¢ºçš„è·¯å¾‘ä¸æœƒé€ æˆå‘½ä»¤åœæ­¢åŸ·è¡Œã€‚
--^ignorecase 忽略路徑的大å°å¯«å€åˆ†ã€‚æ­é…這個標誌時,é¸é …
'--^configure' å°‡é©ç”¨æ–¼ "/Data/Textures",å³ä½¿ä½¿ç”¨è€…
寫入的是 "/data/teXtures"。
--^workspace=路徑 å·¥ä½œå€æ‰€åœ¨ä½ç½®çš„路徑。
== CMD_HELP_PARTIAL_SWITCH ==
備註:
此命令å¯è®“使用者更新工作分支。在更新
åˆ†æ”¯ä¹‹å¾Œï¼Œæ­¤å‘½ä»¤æœƒå°‡å·¥ä½œå€æ›´æ–°æˆæ–°åˆ†æ”¯ï¼Œå¦‚åŒ
'cm ^partial ^update' 命令所執行方å¼ã€‚ä¸éŽï¼Œå¦‚果已指定 '--^configure' é¸é …,
此命令就å¯è®“您使用新分支設定來
設定工作å€ï¼Œå¦‚åŒ 'cm ^partial ^configure' 命令所執行方å¼ã€‚
範例:
cm ^switch ^br:/main/task
(å°‡ /main/task 設為工作分支,並更新工作å€ã€‚)
cm ^switch ^br:/main/task --^configure +/art/images
(å°‡ /main/task 設為工作分支,並設定工作å€å¯
載入 /art/images 資料夾。)
== CMD_DESCRIPTION_PARTIAL_UNDOCHECKOUT ==
復原項目的簽出。
== CMD_USAGE_PARTIAL_UNDOCHECKOUT ==
用法:
cm ^partial ^undocheckout | ^unco <項目_路徑>[ ...][--^silent]
é …ç›®_路徑 è¦å¥—用作業的項目。使用雙引號 (" ")
指定å«ç©ºæ ¼çš„路徑。使用空格
分隔路徑。
使用 . 將作業套用至目å‰ç›®éŒ„。
é¸é …:
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
== CMD_HELP_PARTIAL_UNDOCHECKOUT ==
備註:
å¦‚æžœé …ç›®å·²ç°½å‡ºï¼Œè€Œä¸”æ‚¨ä¸æƒ³å°‡å…¶ç°½å…¥ï¼Œæ‚¨å¯ä»¥ä½¿ç”¨æ­¤å‘½ä»¤å¾©åŽŸ
簽出。檔案和資料夾皆å¯å–消
簽出。項目將更新為簽出å‰çš„狀態。
è¦æ±‚:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
- 必須簽出項目。
範例:
cm ^partial ^undocheckout .
(復原目å‰ç›®éŒ„中的簽出。)
cm ^partial ^undocheckout pic1.png pic2.png
cm ^unco c:\workspace\design01.png
(å¾©åŽŸæ‰€é¸æª”案的簽出。)
== CMD_DESCRIPTION_PARTIAL_UNDO ==
復原工作å€ä¸­çš„變更。
== CMD_USAGE_PARTIAL_UNDO ==
用法:
cm ^partial ^undo [<路徑>[ ...]] [--^symlink] [-^r | --^recursive]
[<篩é¸>[ ...]]
[--^silent | --^machinereadable [--^startlineseparator=<分隔符號>]
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
路徑 è¦å¥—用作業之檔案或目錄的
路徑。使用雙引號 (" ") 指定
å«ç©ºæ ¼çš„路徑。使用空格
分隔路徑。
如果未指定路徑,復原作業é è¨­æœƒ
使用目å‰ç›®éŒ„中的
所有檔案。
ç¯©é¸ å°‡æŒ‡å®šçš„ä¸€æˆ–å¤šå€‹ç¯©é¸å¥—用至指定的
路徑。使用空格分隔篩é¸ã€‚如需詳細資訊,請åƒé–±
<篩é¸ï¼žä¸€ç¯€ã€‚
é¸é …:
--^symlink 將復原作業套用至符號連çµï¼Œè€Œä¸æ˜¯
套用至目標。
-^r 以éžè¿´æ–¹å¼åŸ·è¡Œå¾©åŽŸã€‚
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^machinereadable 以易於剖æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„行應如何起始。
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,指定
應如何分隔欄ä½ã€‚
篩é¸ï¼š
如果未指定標誌,會ä¾é è¨­å¾©åŽŸæ‰€æœ‰è®Šæ›´ï¼Œä½†
å¯ä½¿ç”¨ä¸‹åˆ—一或多個標誌篩é¸è·¯å¾‘。
如果檔案或目錄符åˆä¸€æˆ–多個指定的變更類型,
將會復原所述之檔案或目錄上的所有變更。
例如,如果您指定 '--^checkedout' 和 '--^moved',若檔案
已簽出且移動,則會復原這兩項變更。
--^checkedout é¸å–已簽出的檔案和目錄。
--^unchanged é¸å–未變更內容的檔案。
--^changed é¸å–已在本地變更或簽出的檔案和
目錄。
--^deleted é¸å–已刪除的檔案和目錄。
--^moved é¸å–已移動的檔案和目錄。
--^added é¸å–已新增的檔案和目錄。
== CMD_HELP_PARTIAL_UNDO ==
備註:
^undo 命令具有å±éšªæ€§ - 它會以無法回復的方å¼å¾©åŽŸå·¥ä½œã€‚
^undo 作業完æˆå¾Œï¼Œå‰‡ç„¡æ³•復原å—其影響的檔案和
目錄的先å‰ç‹€æ…‹ã€‚如果未在引數中
指定路徑,é è¨­å°‡å¾©åŽŸç›®å‰ç›®éŒ„中的所有變更,
但䏿˜¯ä»¥éžè¿´æ–¹å¼é€²è¡Œã€‚
é€™äº›ç­‰åŒæ–¼å¾ž /src 目錄執行:
/src
|- file.txt
|- code.cs
\- /test
|- test_a.py
\- test_b.py
cm ^partial ^undo
cm ^partial ^undo *
cm ^partial ^undo file.txt code.cs /test
cm ^partial ^undo .
cm ^partial ^undo /src file.txt code.cs
è‹¥è¦ä»¥éžè¿´çš„æ–¹å¼é€²è¡Œä½œæ¥­ï¼Œæ‚¨å¿…須指定 '-^r' 標誌。
復原目錄下的所有變更 (包括影響到
目錄本身的變更):
cm ^partial ^undo dirpath -^r
如果目錄路徑是工作å€è·¯å¾‘,將會復原工作å€ä¸­çš„
所有變更。
範例:
cm ^partial ^undo .-^r
(以éžè¿´æ–¹å¼å¾©åŽŸç›®å‰ç›®éŒ„中的所有變更。如果已從
工作å€çš„æ ¹ç›®éŒ„執行,則會復原整個工作å€ä¸­çš„æ‰€æœ‰è®Šæ›´ã€‚)
cm ^partial ^co file.txt
cm ^partial ^undo file.txt
(復原 file.txt 的簽出。)
^echo ^content >> file.txt
cm ^partial ^undo file.txt
(復原 file.txt 的本地變更。)
cm ^partial ^undo src
(復原 src 目錄åŠå…¶ä¸­æª”案的變更。)
cm ^partial ^undo src/*
(復原 src 中所包å«å„個檔案與目錄的變更,而
完全ä¸å½±éŸ¿ src。)
cm ^partial ^undo *.cs
(復原在目å‰ç›®éŒ„中,與 *.cs 相符的æ¯å€‹æª”案或目錄的
變更。)
cm ^partial ^undo *.cs -^r
(復原在目å‰ç›®éŒ„與底下æ¯å€‹ç›®éŒ„中,
與 *.cs 相符的æ¯å€‹æª”案或目錄。)
cm ^partial ^co file1.txt file2.txt
^echo ^content >> file1.txt
cm ^partial ^undo --^unchanged
(復原未變更 file2.txt 的簽出,因此忽略本地變更的
file1.txt。)
^echo ^content >> file1.txt
^echo ^content >> file2.txt
cm ^partial ^co file1.txt
cm ^partial ^undo --^checkedout
(復原已簽出檔案 file1.txt 中的變更,因此忽略 file2.txt,因為這個檔案
並未簽出。)
cm ^partial ^add file.txt
cm ^partial ^undo file.txt
(復原新增 file.txt çš„å‹•ä½œï¼Œå› è€Œä½¿å…¶å†æ¬¡æˆç‚ºç§äººæª”案。)
^rm file1.txt
^echo ^content >> file2.txt
cm ^partial ^add file3.txt
cm ^partial ^undo --^deleted --^added *
(復原 file1.txt 刪除動作和 file3.txt 新增動作,而忽略 file2.txt
變更。)
== CMD_DESCRIPTION_PARTIAL_UPDATE ==
更新局部的工作å€ï¼Œä»¥åŠä¸‹è¼‰æœ€æ–°çš„變更。
== CMD_USAGE_PARTIAL_UPDATE ==
用法:
cm ^partial ^update [<項目_路徑>[ ...]] [--^changeset=<數目>]
[--^silent | --^report] [--^dontmerge]
é …ç›®_路徑 è¦æ›´æ–°çš„項目。使用雙引號 (" ") 指定
å«ç©ºæ ¼çš„路徑。使用空格分隔
路徑。
使用 . 將更新套用至目å‰ç›®éŒ„。
如未指定任何路徑,則目å‰å±€éƒ¨çš„工作å
會完整ç²å¾—更新。
é¸é …:
--^changeset æ›´æ–°å±€éƒ¨å·¥ä½œå€æˆç‰¹å®šè®Šæ›´é›†ã€‚
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^report åœ¨å‘½ä»¤å®Œæˆæ™‚列å°å·²å¥—用變更
的清單。使用 '--^silent' 時將會覆寫這個設定。
--^dontmerge 䏿œƒåˆä½µæª”案è¡çªï¼Œåªæ˜¯ç•¥éŽã€‚
其他的變更隨å³é©ç•¶å¥—用。這個é¸é …
å¯ç”¨æ–¼è‡ªå‹•化作業,å…除使用者互動。
== CMD_HELP_PARTIAL_UPDATE ==
備註:
命令 '^partial ^update' æœƒæ›´æ–°éŽæ™‚的檔案。
此命令應該會執行éžè¿´ä½œæ¥­ã€‚
使用 '--^changeset' é¸é …時,如果所有的指定路徑都是在åŒä¸€ Xlink
下的檔案,則å¯åœ¨ Xlink 連çµå„²å­˜åº«ä¸­çš„æŒ‡å®šè®Šæ›´é›†ä¸­ï¼Œ
æœå°‹è¦ä¸‹è¼‰çš„版本。
範例:
cm ^partial ^update
(æ›´æ–°ç›®å‰å±€éƒ¨å·¥ä½œå€çš„æ‰€æœ‰å…§å®¹ã€‚)
cm ^partial ^update .
(更新所有目å‰ç›®éŒ„下層項目。)
cm ^partial ^update backgroud-blue.png
(更新項目 'backgroud-blue.png'。)
cm ^partial ^update soft_black.png soft-grey.png
(更新項目 'soft_black.png' 和 'soft-grey.png'。)
cm ^partial ^update src --^report
(更新所有 'src' 目錄下層項目,並於最後列å°å‡º
套用的變更清單。)
cm ^partial ^update src --^changeset=4
(將所有 'src' 目錄下層項目更新æˆå…¶åœ¨è®Šæ›´é›† 4 中
所載入的內容。)
cm ^partial ^update xlink/first.png --^changeset=4
(å°‡ 'xlink/first.png' 項目更新æˆå…¶åœ¨ Xlink 連çµå„²å­˜åº«è®Šæ›´é›† 4 中
所載入的內容。
== CMD_DESCRIPTION_PATCH ==
å¾žè¦æ ¼ä¸­ç”¢ç”Ÿä¿®è£œæª”案,或將產生的修補檔案套用到目å‰
工作å€ã€‚
== CMD_USAGE_PATCH ==
用法:
cm ^patch <來æº_è¦æ ¼> [<來æº_è¦æ ¼>] [--^output=<輸出_檔案>]
[--^tool=<差異比å°_çš„_路徑>]
產生修補檔案,其中包å«åˆ†æ”¯ã€è®Šæ›´é›†çš„差異,
或變更集之間的差異。這個檔案也會追蹤
æ–‡å­—æª”å’ŒäºŒé€²ä½æª”案的差異。
cm ^patch --^apply <修補_檔案> [--^tool=<修補_的_路徑>]
å…許在目å‰å·¥ä½œå€ä¸­å¥—用所產生修補檔案
的內容。
來æº_è¦æ ¼ è®Šæ›´é›†æˆ–åˆ†æ”¯çš„å®Œæ•´è¦æ ¼ã€‚(使用
'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
輸出_檔案 è¦å„²å­˜ä¿®è£œå…§å®¹çš„æª”案。如果未指定任何檔案,
修補內容將會列å°åˆ°æ¨™æº–輸出。
修補_檔案 è¦å¥—用於目å‰å·¥ä½œå€çš„修補檔案。
é¸é …:
--^output 設定修補命令的輸出檔案。
--^tool 設定è¦ä½¿ç”¨çš„æ‡‰ç”¨ç¨‹å¼ (å·®ç•°æ¯”å°æˆ–修補)。
== CMD_HELP_PATCH ==
é™åˆ¶ï¼š
å¦‚æžœå·²æœ‰è¼¸å‡ºä¿®è£œæª”æ¡ˆï¼Œè©²å‘½ä»¤å°‡ä¸æœƒè¦†å¯«æ­¤æª”案。
套用修補時,如果修改的檔案ä¸åœ¨ç£ç¢Ÿä¸Šï¼Œ
命令將䏿œƒåœ¨å…¶ä¸­å¥—用變更。
é‡è¦ï¼š
這個命令需è¦ä½¿ç”¨å·®ç•°æ¯”å° (Diff) 和修補 (Patch) 工具,公開æä¾›æ–¼
http://gnuwin32.sourceforge.net/packages/patch.htm 和
http://gnuwin32.sourceforge.net/packages/diffutils.htm
安è£å®Œæˆä¹‹å¾Œï¼Œå»ºè­°åœ¨ PATH 環境變數中
新增其路徑。
範例:
cm ^patch ^cs:4@default@localhost:8084
(在主控å°ä¸Šä»¥çµ±ä¸€æ ¼å¼åˆ—å°å‡º cset 4 的差異。)
cm ^patch ^br:/main --^output=file.patch
(產生修補檔案åŠåˆ†æ”¯ "main" 的差異。)
cm ^patch ^br:/main --^output=file.patch --^tool=C:\gnu\diff.exe
(åŠŸèƒ½å¦‚å‰æ‰€è¿°ï¼Œä½†ä½¿ç”¨ custom exe。)
cm ^patch ^cs:2@default ^cs:4@default
(在主控å°ä¸Šä»¥çµ±ä¸€æ ¼å¼åˆ—å°å‡º csets 2 å’Œ 4 之間的差異。)
cm ^patch --^apply file.patch --^tool=C:\gnu\patch.exe
(使用 custom exe,將 'file.patch' 中的修補套用到本地工作å€ã€‚)
== CMD_DESCRIPTION_QUERY ==
執行 SQL æŸ¥è©¢ã€‚éœ€è¦ SQL 儲存ä½ç½®ã€‚
== CMD_USAGE_QUERY ==
用法:
cm ^query <sql_命令> [--^outputfile=<輸出_檔案>]
[--^solveuser=<欄_å>[,...]]
[--^solvepath=<欄_å>[,...]]
[--^columnwidth=<值>] [--^nocolumnname]
[--^columnseparator=<分隔符號>] [--^repository=<å稱>]
sql_命令 è¦åŸ·è¡Œçš„ sql 查詢。
é¸é …:
--^outputfile å°‡çµæžœå¯«å…¥è¼¸å‡ºæª”案。
--^solveuser 將指定的欄ä½è¨­ç‚º [使用者å稱] 欄ä½ã€‚查詢
解譯器會將這些欄ä½çš„資料å‡å®š
為使用者,並將因此嘗試進行解æžã€‚
--^solvepath 將指定的欄ä½è¨­ç‚º [é …ç›® ID] 欄ä½ã€‚查詢解譯器
將嘗試將項目 ID è§£æžç‚ºæª”案系統
路徑。
--^columnwidth 指定æ¯å€‹æ¬„的寬度以格å¼åŒ–輸出。
--^nocolumnname ä¸åˆ—å°æ¬„å。
--^columnseparator 使用字元åšç‚ºæ¬„分隔符號,而ä¸ä½¿ç”¨å®šä½å­—å…ƒ (\t)。
--^repository è¦æŸ¥è©¢çš„儲存庫。
== CMD_HELP_QUERY ==
備註:
此命令å¯è®“使用者在伺æœå™¨è³‡æ–™åº«ä¸­åŸ·è¡Œ SQL 查詢。
為寫入 SQL 查詢,請使用下列兩個é å…ˆå®šç¾©çš„函數來管ç
使用者和路徑:
- '^SolveUser(<使用者å稱>)':將使用者å稱解æžç‚º Unity VCS æ ¼å¼ã€‚
- '^SolvePath(<路徑>)':將ç£ç¢Ÿè·¯å¾‘è§£æžç‚ºé …ç›® ID。
此外,您å¯ä»¥ä½¿ç”¨é¸é …以人類å¯è®€çš„æ ¼å¼é¡¯ç¤ºæŸ¥è©¢çµæžœã€‚
您å¯ä»¥ä½¿ç”¨ '--^solveuser=<欄_å>' å’Œ
'--^solvepath=<欄_å>' é¸é …,指定查詢解譯器
必須轉æ›ç‚ºå¯è®€æ–‡å­—的欄。您å¯ä»¥æŒ‡å®šå¤šå€‹æ¬„å,
並使用逗號分隔。
範例:
cm ^query "^SELECT * ^FROM ^revision" --^columnwidth=25 --^repository=reptest
(從 'reptest' 儲存庫的 '修訂' 表格擷å–資料)
cm ^query "^SELECT b.^sname ^as 分支_å稱, o.^dtimestamp ^as 日期 ^from ^branch b, \
^object o, ^seid s ^where b.^iobjid=o.^iobjid ^and o.^fidowner=s.^iseidid ^and \
s.^scode='^SolveUser(john)'" --^outputfile=query.txt
(è¼¸å‡ºè‡³ä»¥æ“æœ‰è€… 'john' åšç‚ºåˆ†æ”¯çš„æª”案。)
cm ^query "^select r.^iobjid, r.^fiditem ^as 路徑, s.^scode ^as 使用者å稱 ^FROM \
^revision r, ^object o, ^seid s ^WHERE r.^iobjid=o.^iobjid ^and \
o.^fidowner=s.^iseidid ^and o.^dtimestamp>2014/04/25" \
--^solveuser=使用者å稱 --^solvepath=路徑 --^repository=reptest@server2:9095
(從所é¸å„²å­˜åº«æ“·å–所é¸è³‡æ–™ã€‚)
cm ^query "^SELECT * ^FROM ^revision ^WHERE ^fiditem=^SolvePath(c:\mywkpath\info)"
(æ“·å–路徑 'info' 的所有修訂資料。)
== CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
刪除一或多個屬性。
== CMD_USAGE_ATTRIBUTE_DELETE ==
用法:
cm ^attribute | ^att ^delete | ^rm <屬性_è¦æ ¼>[ ...]
屬性_è¦æ ¼ è¦åˆªé™¤çš„屬性。使用空格分隔
屬性。
(使用 'cm ^help ^objectspec' 以深入瞭解屬性
è¦æ ¼ã€‚)
== CMD_HELP_ATTRIBUTE_DELETE ==
備註:
此命令會移除一或多個屬性。
範例:
cm ^attribute ^delete ^att:狀態
(刪除 '狀態' 屬性。)
cm ^att ^rm 狀態 ^att:æ•´åˆ@reptest@server2:8084
(刪除 '狀態' å’Œ 'æ•´åˆ' 屬性。)
== CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
å–æ¶ˆè¨­å®šç‰©ä»¶çš„屬性。
== CMD_USAGE_ATTRIBUTE_UNSET ==
用法:
cm ^attribute | ^att ^unset <屬性_è¦æ ¼> <物件_è¦æ ¼>
屬性_è¦æ ¼ å±¬æ€§è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
ä»¥æ·±å…¥çž­è§£å±¬æ€§è¦æ ¼ã€‚)
物件_è¦æ ¼ è¦ç§»é™¤å±¬æ€§çš„物件
è¦æ ¼ã€‚å¯åœ¨ä¸‹åˆ—項目上設定屬性:分支ã€è®Šæ›´é›†ã€
æ“±ç½®é›†ã€æ¨™ç±¤ã€é …目和修訂。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
== CMD_HELP_ATTRIBUTE_UNSET ==
備註:
æ­¤å‘½ä»¤æœƒå–æ¶ˆè¨­å®šå…ˆå‰åœ¨ç‰©ä»¶ä¸Šæ‰€è¨­å®šçš„屬性。它
䏿œƒåˆªé™¤å±¬æ€§ç‰©ä»¶æœ¬èº«ã€‚
範例:
cm ^attribute ^unset ^att:狀態 ^br:/main/SCM105
(從 'main/SCM105' 分支移除 '狀態' 屬性實ç¾ã€‚)
cm ^att ^unset ^att:æ•´åˆ@reptest@localhost:8084 ^cs:25@reptest@localhost:8084
(從變更集 25 移除 'æ•´åˆ' 屬性實ç¾ï¼Œå…¨éƒ¨éƒ½åœ¨
'reptest' 儲存庫中。)
== CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
釿–°å‘½å屬性。
== CMD_USAGE_ATTRIBUTE_RENAME ==
用法:
cm ^attribute | ^att ^rename <屬性_è¦æ ¼> <æ–°_å稱>
屬性_è¦æ ¼ è¦é‡æ–°å‘½å的屬性。(使用 'cm ^help ^objectspec' 以深入
çž­è§£å±¬æ€§è¦æ ¼ã€‚)
æ–°_å稱 屬性的新å稱。
== CMD_HELP_ATTRIBUTE_RENAME ==
備註:
æ­¤å‘½ä»¤æœƒé‡æ–°å‘½å屬性。
範例:
cm ^attribute ^rename ^att:狀態 ç‹€æ³
(å°‡ '狀態' å±¬æ€§é‡æ–°å‘½å為 'ç‹€æ³'。)
== CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
編輯屬性的註解。
== CMD_USAGE_ATTRIBUTE_EDIT ==
用法:
cm ^attribute | ^att ^edit <屬性_è¦æ ¼> <æ–°_註解>
屬性_è¦æ ¼ è¦è®Šæ›´å…¶è¨»è§£çš„屬性。(使用 'cm ^help ^objectspec'
ä»¥æ·±å…¥çž­è§£å±¬æ€§è¦æ ¼ã€‚)
æ–°_註解 屬性的新註解。您也å¯ä»¥ç‚ºå±¬æ€§æŒ‡å®š
é è¨­çš„值清單。
== CMD_HELP_ATTRIBUTE_EDIT ==
備註:
此命令會變更屬性的註解。
è‹¥è¦ç‚ºå±¬æ€§æŒ‡å®šé è¨­çš„值清單,您åªéœ€è¦åœ¨å±¬æ€§è¨»è§£ä¸­
加入類似以下的一行:
'é è¨­: 第一個值, "第二個值", 第 3 個值, "最後一個值"'。
範例:
cm ^attribute ^edit ^att:狀態 "CI 管線中的分支狀態。"
(編輯 '狀態' 屬性的註解。)
cm ^attribute ^edit ^att:狀態 "分支狀態。é è¨­ï¼šæœªè§£æ±ºã€å·²è§£æ±ºã€å·²æª¢é–±"
(編輯 '狀態' 屬性的註解。也會指定值的
清單。因此,當您將 '狀態' 屬性設定為物件時,您å¯ä»¥é¸å
下列其中一個值:"未解決"ã€"已解決" 或 "已檢閱"。)
== CMD_DESCRIPTION_REPLICATE ==
警告:此命令已棄用。
請使用 'cm ^pull' (ç­‰åŒæ–¼ '^replicate') å’Œ 'cm ^push' (ç­‰åŒæ–¼
'^replicate --^push')。
== CMD_USAGE_REPLICATE ==
== CMD_HELP_REPLICATE ==
== CMD_DESCRIPTION_PULL ==
從å¦ä¸€å€‹å„²å­˜åº«æå–分支。
== CMD_USAGE_PULL ==
用法:
cm ^pull <來æº_分支_è¦æ ¼> <目的地_儲存庫_è¦æ ¼>
[--^preview] [--^nodata] [轉譯é¸é …]
[--^user=<使用者_å稱> [--^password=<密碼>] | 授權é¸é …]
(直接 server-to-server 複寫。從儲存庫æå–分支。)
cm ^pull <目的地_儲存庫_è¦æ ¼> --^package=<套件_檔案> [授權é¸é …]
(套件型複寫。在目的地儲存庫中匯入套件。)
cm ^pull ^hydrate <目的地_分支_è¦æ ¼> [<來æº_儲存庫_è¦æ ¼>]
[--^user=<使用者_å稱> [--^password=<密碼>] | 授權é¸é …]
(引入先å‰
使用 '--^nodata' 複寫之分支的所有變更集的éºå¤±è³‡æ–™ã€‚如果沒有指定è¦å–得資料的儲存庫,
Unity VCS 會嘗試使用「複寫來æºã€(已複寫
分支的來æº))。
cm ^pull ^hydrate <目的地_變更集_è¦æ ¼> [<來æº_儲存庫_è¦æ ¼>]
[--^user=<使用者_å稱> [--^password=<密碼>] | 授權é¸é …]
(引入先å‰ä½¿ç”¨
'--^nodata' 複寫之變更集的éºå¤±è³‡æ–™ã€‚如果沒有指定è¦å–得資料的儲存庫,Unity VCS 會嘗試
使用「複寫來æºã€)。
來æº_分支_è¦æ ¼ è¦å¾žé ç«¯å„²å­˜åº«æå–的分支。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£åˆ†æ”¯è¦æ ¼ã€‚)
目的地_分支_è¦æ ¼ è¦åˆæˆçš„分支。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£åˆ†æ”¯è¦æ ¼ã€‚)
目的地_變更集_è¦æ ¼ è¦åˆæˆçš„變更集。
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
è¦æ ¼ã€‚)
目的地_儲存庫_è¦æ ¼ 目的地儲存庫。
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
è¦æ ¼ã€‚)
--^package 指定è¦é‡å°å¥—件型複寫匯入的先å‰å»ºç«‹
的套件檔案。
在沒有直接網路連線的情æ³ä¸‹ï¼Œå¯ç”¨åœ¨
伺æœå™¨ä¹‹é–“移動資料。
è«‹åƒç…§ 'cm ^push' 以建立套件檔案。
é¸é …:
--^preview æä¾›æœ‰é—œå°‡æå–哪些變更的資訊,但實際上
䏿œƒåŸ·è¡Œä»»ä½•變更。此é¸é …很é©åˆç”¨æ–¼
åœ¨è¤‡å¯«è®Šæ›´å‰æª¢æŸ¥å°‡å‚³è¼¸
的資料。
--^nodata 複寫分支變更,而ä¸è¤‡å¯«
資料。此é¸é …ä¸å¯èˆ‡å¥—ä»¶
複寫æ­é…使用。
轉譯é¸é … 如需詳細資訊,請åƒé–±ï¼œè½‰è­¯é¸é …>一節。
--^user, --^password 如果來æºå’Œç›®çš„地的驗證模å¼
ä¸åŒä¸”沒有å¯å°ç›®çš„地進行驗證的設定檔時,
所è¦ä½¿ç”¨çš„èªè­‰ã€‚
é©—è­‰é¸é … 如需詳細資訊,請åƒé–±
<驗證é¸é …>一節。
轉譯é¸é …:
--^trmode=(^copy|^name|^table --^trtable=<轉譯_表格_檔案>)
來æºå’Œç›®çš„地儲存庫å¯èƒ½æœƒä½¿ç”¨ä¸åŒçš„é©—è­‰
模å¼ã€‚'--^trmode' é¸é …坿Œ‡å®šå¦‚何將使用者å稱從
來æºè½‰è­¯è‡³ç›®çš„地。'--^trmode' 必須是下列其中
一個值:
^copy (é è¨­)ã€‚è¡¨ç¤ºåªæœƒè¤‡è£½ä½¿ç”¨è€…識別碼。
^name 表示將按å稱比å°ä½¿ç”¨è€…識別碼。
^table 使用 '--^trtable' é¸é …中指定的轉譯表格
(è«‹åƒé–±ä¸‹æ–¹)。
--^trtable=<轉譯_表格_檔案>
如果轉譯模å¼ç‚º '表格',轉譯表格則為包å«
<舊å稱;æ–°å稱> (æ¯è¡Œä¸€å€‹) æ ¼å¼çš„æ–‡å­—行檔案。當
分支寫入至目的地儲存庫時,來æºå„²å­˜åº«ä¸­ '舊å稱'
所識別之使用者所建立的物件將設定至目的地上
具有 'æ–°å稱' 的使用者。
é©—è­‰é¸é …:
您å¯ä½¿ç”¨ä¸‹åˆ—兩種模å¼ä¹‹ä¸€æŒ‡å®šé©—證資料:
1) ä½¿ç”¨é©—è­‰åƒæ•¸ï¼š--^authmode=<模å¼> --^authdata=<資料>
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
範例:
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
'--^authdata' 這一行是 client.conf 檔案和 profiles.conf 檔案中 <^SecurityConfig> 項目
的內容。您å¯å¾ž Unity VCS GUI çš„ [喜好設定] 下的複寫
設定檔索引標籤,輕鬆產生 profiles.conf
檔案。
如果您使用的是 ^UPWorkingMode,å¯ä»¥ç›´æŽ¥æŒ‡å®šï¼š
--^authmode=^UPWorkingMode --^user=<使用者> --^password=<密碼>
2) 驗證檔案,其中é‡å°å„個連線的目標伺æœå™¨æ‚¨å¯èƒ½
有ä¸åŒçš„æª”案,包括該伺æœå™¨çš„èªè­‰ã€‚
--^authfile=<驗證_檔案>
æ­¤æª”æ¡ˆåŒ…å« 2 行:
行 1) æ˜¯æ¨¡å¼ (如 '--^authmode' 所述)
行 2) 是驗證資料 (如 '--^authdata' 所述)
== CMD_HELP_PULL ==
備註:
'^pull' 命令能夠在來æºå„²å­˜åº«èˆ‡ç›®çš„地儲存庫之間
複寫分支 (åŠå…¶è®Šæ›´é›†)。
儲存庫å¯ä½æ–¼ä¸åŒçš„伺æœå™¨ã€‚
複寫作業分æˆå…©ç¨®ï¼š'^push' å’Œ '^pull'。
'^pull' ä½œæ¥­æ˜¯æŒ‡è¤‡å¯«ä½œæ¥­æœƒè¦æ±‚å°‡
來自來æºå„²å­˜åº«çš„資料儲存至目的地儲存庫。
用戶端將連線至目的地儲存庫,並且將從該主機
建立與來æºå„²å­˜åº«çš„連線,以擷å
鎖定目標的資料。æå–期間,它是將
連線至來æºçš„目的地伺æœå™¨ã€‚
é›–ç„¶åœ¨ä¸€èˆ¬åˆ†æ•£å¼æ¡ˆä¾‹ä¸­ï¼Œé–‹ç™¼äººå“¡æœƒå°‡è³‡æ–™å¾žå…¶æœ¬æ©Ÿä¼ºæœå™¨
推é€è‡³ä¸»è¦ä¼ºæœå™¨ï¼Œä½†é–‹ç™¼äººå“¡å¯èƒ½ä¹Ÿæœƒæƒ³è¦å¾žä¸»è¦ä¼ºæœå™¨
æå–最新儲存庫更新。
è‹¥å°å…©å€‹è¤‡å¯«çš„儲存庫上的相åŒåˆ†æ”¯
åŒæ™‚進行了變更,複寫å¯ä»¥è§£æ±ºæ­¤é¡žæƒ…æ³ï¼š
- 推é€ï¼šå¦‚果您嘗試將資料推é€è‡³å„²å­˜åº«ï¼Œè€Œç•¶ä¸­çš„變更比您傳é€çš„
è®Šæ›´è¦æ–°ï¼Œç³»çµ±å°‡è¦æ±‚您æå–最新變更ã€è§£æ±ºåˆä½µä½œæ¥­ï¼Œ
æœ€å¾Œå†æ¬¡å˜—試推é€ã€‚
- æå–:æ¯ç•¶æ‚¨å¾žé ç«¯åˆ†æ”¯æå–變更集時,它們會直接連çµè‡³
其上層變更集。如果您æå–的變更集
䏿˜¯åˆ†æ”¯ä¸­æœ€å¾Œä¸€å€‹è®Šæ›´é›†çš„下層項目,則會出ç¾å¤šæ¨™é ­
案例。分支將有多個「標頭ã€ï¼Œæˆ–在分支上有
最後一個變更集。您必須先åˆä½µå…©å€‹ã€Œæ¨™é ­ã€ï¼Œ
æ‰èƒ½å†æ¬¡æŽ¨é€ã€‚
æå–å¯åœ¨å…©ç¨®æ¨¡å¼ä¸‹é‹ä½œï¼š
1) 伺æœå™¨ä¹‹é–“的直接通訊:目的地伺æœå™¨å°‡å¾žä¾†æº
伺æœå™¨æ“·å–資料,自動為指定的分支
åŒæ­¥è³‡æ–™ã€‚
2) 使用推é€å’Œ '--^package' é¸é …匯入先å‰ç”¢ç”Ÿçš„套件。
æ¨¡å¼ 1) æœƒè¦æ±‚使用者執行命令以接å—é ç«¯ä¼ºæœå™¨çš„驗證,
無論是使用client.conf 檔案中的é è¨­é©—è­‰ã€
指定 '--^authmode' 和 '--^authdata' 修飾詞或是
'--^authmode' å’Œ '--^user' å’Œ '--^password' (如果驗證模å¼ç‚º
^UPWorkingMode。)
æ¨¡å¼ 2) æœƒè¦æ±‚使用先å‰ä½¿ç”¨æŽ¨é€
命令產生的套件檔案。
請注æ„,æå–複寫會以間接的方å¼é‹ä½œã€‚執行時,
å‘½ä»¤æœƒè¦æ±‚目的地儲存庫連線至來æºä¸¦
å–得所é¸åˆ†æ”¯ã€‚
ä¸éŽï¼Œé€™å¯ç›´æŽ¥ä½¿ç”¨æŽ¨é€å‘½ä»¤å®Œæˆã€‚
這會讓命令將所é¸åˆ†æ”¯å¾žä¾†æºè¤‡å¯«è‡³
目的地。
範例:
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084
(å°‡ 'main' 分支從 'remoteserver' æå–至 'myserver'。在本例中,
會使用相åŒçš„驗證模å¼è¨­å®šé€™å…©å€‹ä¼ºæœå™¨ã€‚)
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 \
--^authmode=^LDAPWorkingMode --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(與之å‰ä¸€æ¨£ï¼Œæå–相åŒçš„分支,但ç¾åœ¨é ç«¯ä¼ºæœå™¨å·²è¨­å®šç‚º
é€éŽ Active Directory 驗證使用者。例如,我正從 Linux 電腦
連線至設定為使用 Active Directory æ•´åˆæ¨¡å¼çš„
Windows 伺æœå™¨ã€‚我會指定我的 Active Directory 使用者和加密的
密碼,並以 LDAP å½¢å¼å°‡å®ƒå‚³éžè‡³ä¼ºæœå™¨ã€‚)
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 \
--^authmode=^UPWorkingMode --^user=dave --^password=mysecret
å–相åŒçš„分支,但ç¾åœ¨ä½¿ç”¨è€…是在é ç«¯ä¼ºæœå™¨ä¸Šé€²è¡Œé©—證,
善加利用
Unity VCS 所包å«çš„使用者/密碼資料庫。)
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 --^nodata
(å°‡ 'main' 分支從 'remoteserver' 複寫至 'myserver',但ä¸åŒ…å«è³‡æ–™ã€‚)
cm ^pull ^hydrate ^br:/main@projectx@myserver:8084 projectx@remoteserver:8084
(é€éŽå¾žé ç«¯ä¼ºæœå™¨å–得資料,
åˆæˆ 'main' 分支中的所有變更集。)
cm ^pull ^hydrate ^cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
(é€éŽå¾žé ç«¯ä¼ºæœå™¨å–得資料,
ï¼Œåˆæˆ 'myserver' 中的變更集 122169。)
== CMD_DESCRIPTION_PUSH ==
將分支推é€è‡³å¦ä¸€å€‹å„²å­˜åº«ã€‚
== CMD_USAGE_PUSH ==
用法:
cm ^push <來æº_分支_è¦æ ¼> <目的地_儲存庫_è¦æ ¼>
[--^preview] [轉譯é¸é …]
[--^user=<使用者_å稱> [--^password=<密碼>] | 授權é¸é …]
(直接 server-to-server 複寫。從儲存庫推é€åˆ†æ”¯ã€‚)
cm ^push <來æº_分支_è¦æ ¼> --^package=<套件_檔案> [授權é¸é …]
(å¥—ä»¶åž‹è¤‡å¯«ã€‚åœ¨åŒ…å«æ‰€é¸åˆ†æ”¯çš„來æºä¼ºæœå™¨ä¸­
建立複寫套件。)
來æº_分支_è¦æ ¼ è¦æŽ¨é€è‡³é ç«¯å„²å­˜åº«çš„分支。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£åˆ†æ”¯è¦æ ¼ã€‚)
目的地_儲存庫_è¦æ ¼ 目的地儲存庫。
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
è¦æ ¼ã€‚)
--^package 指定è¦é‡å°å¥—件型複寫匯出
複寫套件的路徑。
在沒有直接網路連線的情æ³ä¸‹ï¼Œ
å¯ç”¨åœ¨ä¼ºæœå™¨ä¹‹é–“移動資料。
é¸é …:
--^preview æä¾›æœ‰é—œå°‡æŽ¨é€å“ªäº›è®Šæ›´çš„資訊,
ä½†å¯¦éš›ä¸Šä¸æœƒåŸ·è¡Œä»»ä½•變更。此é¸é …
很é©åˆç”¨ä¾†åœ¨è¤‡å¯«è®Šæ›´å‰
檢查將傳輸的資料。
轉譯é¸é … 如需詳細資訊,請åƒé–±ï¼œè½‰è­¯é¸é …>一節。
--^user, --^password 如果來æºå’Œç›®çš„地的驗證模å¼
ä¸åŒä¸”沒有å¯å°ç›®çš„地進行驗證的設定檔時,
所è¦ä½¿ç”¨çš„èªè­‰ã€‚
é©—è­‰é¸é … 如需詳細資訊,請åƒé–±
<驗證é¸é …>一節。
轉譯é¸é …:
--^trmode=(^copy|^name|^table --^trtable=<轉譯_表格_檔案>)
來æºå’Œç›®çš„地儲存庫å¯èƒ½æœƒä½¿ç”¨ä¸åŒçš„é©—è­‰
模å¼ã€‚'--^trmode' é¸é …坿Œ‡å®šå¦‚何將使用者å稱
從來æºè½‰è­¯è‡³ç›®çš„地。'--^trmode' 必須是下列
其中一個值:
^copy (é è¨­)ã€‚è¡¨ç¤ºåªæœƒè¤‡è£½ä½¿ç”¨è€…識別碼。
^name 表示將按å稱比å°ä½¿ç”¨è€…識別碼。
^table 使用 '--^trtable' é¸é …中指定的轉譯表格
(è«‹åƒé–±ä¸‹æ–¹)。
--^trtable=<轉譯_表格_檔案>
如果轉譯模å¼ç‚º '表格',轉譯表格則為包å«
<舊å稱;æ–°å稱> (æ¯è¡Œä¸€å€‹) æ ¼å¼çš„æ–‡å­—行檔案。當
分支寫入至目的地儲存庫時,來æºå„²å­˜åº«ä¸­ '舊å稱'
所識別之使用者所建立的物件將設定至目的地上
具有 'æ–°å稱' 的使用者。
é©—è­‰é¸é …:
您å¯ä½¿ç”¨ä¸‹åˆ—兩種模å¼ä¹‹ä¸€æŒ‡å®šé©—證資料:
1) ä½¿ç”¨é©—è­‰åƒæ•¸ï¼š--^authmode=<模å¼> --^authdata=<資料>
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
範例:
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
'--^authdata' 這一行是 client.conf 檔案和 profiles.conf 檔案中 <^SecurityConfig> 項目
的內容。您å¯å¾ž Unity VCS GUI çš„ [喜好設定] 下的複寫
設定檔索引標籤,輕鬆產生 profiles.conf
檔案。
如果您使用的是 ^UPWorkingMode,å¯ä»¥ç›´æŽ¥æŒ‡å®šï¼š
--^authmode=^UPWorkingMode --^user=<使用者> --^password=<密碼>
2) 驗證檔案,其中é‡å°å„個連線的目標伺æœå™¨æ‚¨å¯èƒ½
有ä¸åŒçš„æª”案,包括該伺æœå™¨çš„èªè­‰ã€‚
--^authfile=<驗證_檔案>
æ­¤æª”æ¡ˆåŒ…å« 2 行:
行 1) æ˜¯æ¨¡å¼ (如 '--^authmode' 所述)
行 2) 是驗證資料 (如 '--^authdata' 所述)
== CMD_HELP_PUSH ==
備註:
'^push' 命令能夠在來æºå„²å­˜åº«èˆ‡ç›®çš„地儲存庫之間
複寫分支 (åŠå…¶è®Šæ›´é›†)。
儲存庫å¯ä½æ–¼ä¸åŒçš„伺æœå™¨ã€‚
複寫作業分æˆå…©ç¨®ï¼š'^push' å’Œ '^pull'。
'^push' 作業是指複寫作業會將資料
從來æºå„²å­˜åº«å‚³é€è‡³ç›®çš„地儲存庫。在此案例中,
用戶端將連線至來æºå„²å­˜åº«ï¼Œå–å¾—è¦è¤‡å¯«çš„資料,
然後將該資料傳é€è‡³ç›®çš„地儲存庫。å‰è€… (來æº)
必須連線至目的地,而後者 (目的地)
䏿œƒå°‡æœ¬èº«é€£ç·šè‡³ä¾†æºã€‚
åœ¨ä¸€èˆ¬çš„åˆ†æ•£å¼æ¡ˆä¾‹ä¸­ï¼Œé–‹ç™¼äººå“¡æœƒå°‡è³‡æ–™å¾žå…¶æœ¬æ©Ÿä¼ºæœå™¨
推é€è‡³ä¸»è¦ä¼ºæœå™¨ã€‚此外,開發人員å¯èƒ½ä¹Ÿæœƒæƒ³è¦å¾žä¸»è¦ä¼ºæœå™¨
æå–最新的儲存庫更新。
è‹¥å°å…©å€‹è¤‡å¯«çš„儲存庫上的相åŒåˆ†æ”¯åŒæ™‚
進行了變更,複寫å¯ä»¥è§£æ±ºæ­¤é¡žæƒ…æ³ã€‚
- 推é€ï¼šå¦‚果您嘗試將資料推é€è‡³å„²å­˜åº«ï¼Œè€Œç•¶ä¸­çš„變更比您傳é€
çš„è®Šæ›´è¦æ–°ï¼Œç³»çµ±å°‡è¦æ±‚您æå–最新變更ã€è§£æ±ºåˆä½µä½œæ¥­ï¼Œ
æœ€å¾Œå†æ¬¡å˜—試推é€ã€‚
- æå–:æ¯ç•¶æ‚¨å¾žé ç«¯åˆ†æ”¯æå–變更集時,它們會直接連çµè‡³
其上層變更集。如果您æå–的變更集
䏿˜¯åˆ†æ”¯ä¸­æœ€å¾Œä¸€å€‹è®Šæ›´é›†çš„下層項目,則會出ç¾å¤šæ¨™é ­
案例。分支將有多個「標頭ã€ï¼Œæˆ–在分支上有
最後一個變更集。您必須先åˆä½µå…©å€‹ã€Œæ¨™é ­ã€ï¼Œ
æ‰èƒ½å†æ¬¡æŽ¨é€ã€‚
推é€å¯åœ¨å…©ç¨®æ¨¡å¼ä¸‹é‹ä½œï¼š
1) 伺æœå™¨ä¹‹é–“的直接通訊:原始伺æœå™¨æœƒå°‡è³‡æ–™
傳é€è‡³ç›®çš„地伺æœå™¨ï¼Œè‡ªå‹•為
æŒ‡å®šçš„åˆ†æ”¯åŒæ­¥è³‡æ–™ã€‚
2) 匯出套件模å¼ï¼šç”¨æˆ¶ç«¯åªæœƒé€£ç·šè‡³ä¾†æºä¸¦
產生複寫套件,å–得指定分支的
è³‡æ–™å’Œä¸­ç¹¼è³‡æ–™ã€‚ä¸æœƒä½¿ç”¨ '--^package' 修飾詞。
這兩種模å¼éƒ½æœƒè¦æ±‚使用者執行命令以接å
伺æœå™¨çš„驗證,無論是使用 client.conf
檔案中的é è¨­é©—證或是指定 '--^authmode' å’Œ '--^authdata' 修飾詞。
^push 複寫會以直接的方å¼é‹ä½œã€‚執行時,此命令
會將所é¸åˆ†æ”¯å¾žä¾†æºè¤‡å¯«è‡³ç›®çš„地,而ä¸
è¦æ±‚目的地儲存庫連線至來æºå’Œå–å¾—
所é¸åˆ†æ”¯ (å¦‚åŒæå–æ‰€åŸ·è¡Œçš„動作)。
範例:
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084
(將 'main' 分支從 'myserver' 複寫至 'remoteserver'。在本例中,
會使用相åŒçš„驗證模å¼è¨­å®šé€™å…©å€‹ä¼ºæœå™¨ã€‚)
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084 \
--^authmode=^LDAPWorkingMode --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(與之å‰ä¸€æ¨£ï¼Œè¤‡å¯«ç›¸åŒçš„分支,但ç¾åœ¨é ç«¯ä¼ºæœå™¨å·²è¨­å®šç‚º
é€éŽ Active Directory 驗證使用者。例如,我正從 Linux 電腦
連線至設定為使用 Active Directory æ•´åˆæ¨¡å¼çš„
Windows 伺æœå™¨ã€‚我會指定我的 Active Directory 使用者和加密的
密碼,並以 LDAP å½¢å¼å°‡å®ƒå‚³éžè‡³ä¼ºæœå™¨ã€‚)
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084 \
--^authmode=^UPWorkingMode --^user=dave --^password=mysecret
(複寫相åŒçš„分支,但ç¾åœ¨ä½¿ç”¨è€…是在é ç«¯ä¼ºæœå™¨ä¸Šé€²è¡Œé©—證,
善加利用
Unity VCS 所包å«çš„使用者/密碼資料庫。)
== CMD_DESCRIPTION_CLONE ==
複製é ç«¯å„²å­˜åº«ã€‚
== CMD_USAGE_CLONE ==
用法:
cm ^clone <來æº_儲存庫_è¦æ ¼> [<目的地_儲存庫_è¦æ ¼> | <目的地_儲存庫伺æœå™¨_è¦æ ¼>]
[--^user=<使用者_å稱> [--^password=<密碼>] | 授權é¸é …]
[轉譯é¸é …]
(直接 repository-to-repository 複製。)
cm ^clone <來æº_儲存庫_è¦æ ¼> --^package=<套件_檔案>
[--^user=<使用者_å稱> [--^password=<密碼>] | 授權é¸é …]
(複製至中繼套件,之後å¯é€éŽ
æå–至目的地儲存庫的方å¼åŒ¯å…¥ã€‚)
來æº_儲存庫_è¦æ ¼ 複製作業的來æºå„²å­˜åº«ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
è¦æ ¼ã€‚)
目的地_儲存庫_è¦æ ¼ 複製作業的目的地儲存庫。如果存在
儲存庫,則它必須是空的。如果儲存庫ä¸å­˜åœ¨ï¼Œå‰‡æœƒ
建立儲存庫。
如果未指定儲存庫,此命令會使用使用者的
é è¨­å„²å­˜åº«ä¼ºæœå™¨ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
è¦æ ¼ã€‚)
目的地_儲存庫伺æœå™¨_è¦æ ¼ 複製作業的目的地儲存庫伺æœå™¨ã€‚
如果有一個儲存庫的å稱與
目的地儲存庫伺æœå™¨ä¸­çš„ <來æº_儲存庫_è¦æ ¼> 相åŒï¼Œå‰‡å®ƒ
必須是空的。如果沒有儲存庫,則會建立儲存庫。
如果未指定儲存庫,此命令會使用使用者的
é è¨­å„²å­˜åº«ä¼ºæœå™¨ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解儲存庫
伺æœå™¨è¦æ ¼ã€‚)
é¸é …:
--^user, --^password 如果來æºå’Œç›®çš„地的驗證模å¼
ä¸åŒä¸”沒有å¯å°ç›®çš„地進行驗證的設定檔時,
所è¦ä½¿ç”¨çš„èªè­‰ã€‚
--^package 將指定的儲存庫匯出至套件檔案,
è€Œä¸æ˜¯åŒ¯å‡ºè‡³å„²å­˜åº«ã€‚
在沒有直接網路連線的情æ³ä¸‹ï¼Œå¯ç”¨åœ¨
伺æœå™¨ä¹‹é–“移動資料。
產生的套件必須é€éŽæå–命令
匯入。
轉譯é¸é … 如需詳細資訊,請åƒé–±ï¼œè½‰è­¯é¸é …>一節。
é©—è­‰é¸é … 如需詳細資訊,請åƒé–±
<驗證é¸é …>一節。
轉譯é¸é …:
--^trmode=(^copy|^name|^table --^trtable=<轉譯_表格_檔案>)
來æºå’Œç›®çš„地儲存庫å¯èƒ½æœƒä½¿ç”¨ä¸åŒçš„é©—è­‰
模å¼ã€‚'--^trmode' é¸é …坿Œ‡å®šå¦‚何將使用者å稱從
來æºè½‰è­¯è‡³ç›®çš„地。'--^trmode' 必須是下列其中
一個值:
^copy (é è¨­)ã€‚è¡¨ç¤ºåªæœƒè¤‡è£½ä½¿ç”¨è€…識別碼。
^name 表示將按å稱比å°ä½¿ç”¨è€…識別碼。
^table 使用 '--^trtable' é¸é …中指定的轉譯表格
(è«‹åƒé–±ä¸‹æ–¹)。
--^trtable=<轉譯_表格_檔案>
如果轉譯模å¼ç‚º '表格',轉譯表格則為包å«
<舊å稱;æ–°å稱> (æ¯è¡Œä¸€å€‹) æ ¼å¼çš„æ–‡å­—行檔案。當
分支寫入至目的地儲存庫時,來æºå„²å­˜åº«ä¸­ '舊å稱'
所識別之使用者所建立的物件將設定至目的地上
具有 'æ–°å稱' 的使用者。
é©—è­‰é¸é …:
您å¯ä½¿ç”¨ä¸‹åˆ—兩種模å¼ä¹‹ä¸€æŒ‡å®šé©—證資料:
1) ä½¿ç”¨é©—è­‰åƒæ•¸ï¼š--^authmode=<模å¼> --^authdata=<資料>
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
範例:
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
'--^authdata' 這一行是 client.conf 檔案和 profiles.conf 檔案中 <^SecurityConfig> 項目
的內容。您å¯å¾ž Unity VCS GUI çš„ [喜好設定] 下的複寫
設定檔索引標籤,輕鬆產生 profiles.conf
檔案。
如果您使用的是 ^UPWorkingMode,å¯ä»¥ç›´æŽ¥æŒ‡å®šï¼š
--^authmode=^UPWorkingMode --^user=<使用者> --^password=<密碼>
2) 驗證檔案,其中é‡å°å„個連線的目標伺æœå™¨æ‚¨å¯èƒ½
有ä¸åŒçš„æª”案,包括該伺æœå™¨çš„èªè­‰ã€‚
--^authfile=<驗證_檔案>
æ­¤æª”æ¡ˆåŒ…å« 2 行:
行 1) æ˜¯æ¨¡å¼ (如 '--^authmode' 所述)
行 2) 是驗證資料 (如 '--^authdata' 所述)
== CMD_HELP_CLONE ==
備註:
複製命令能夠將分支 (åŠå…¶è®Šæ›´é›†ã€æ¨™ç±¤ã€å±¬æ€§ã€æª¢é–±
等項目) 從來æºå„²å­˜åº«è¤‡å¯«è‡³ç›®çš„地
儲存庫。儲存庫å¯ä½æ–¼ä¸åŒçš„伺æœå™¨ã€‚
å¯äº‹å…ˆå»ºç«‹ç›®çš„地儲存庫,但如果它包å«
å…ˆå‰çš„資料,複製作業將會失敗。
è¤‡è£½ä½œæ¥­ä¸æœƒè¤‡è£½å„²å­˜åº«å­æ¨¡çµ„ï¼Œä¹Ÿä¸æœƒè¤‡è£½
Xlink 下的儲存庫。
範例:
cm ^clone awesomeProject@tardis@cloud
(將 'awesomeProject' 儲存庫從 'tardis@cloud' 組織複製至
具有相åŒå稱的本機儲存庫。)
cm ^clone repo@server.home:9095 repo-local
(å°‡ 'repo' 從 'server.home:9095' 複製至使用者的é è¨­
儲存庫伺æœå™¨çš„ 'repo-local'。)
cm ^clone project@192.168.111.130:8084 ^repserver:192.168.111.200:9095
(將 'project' 儲存庫從 '192.168.111.130:8084' 複製至
'project@192.168.111.200:9095'。)
cm ^clone project@ldapserver:8084 --authfile=credentials.txt \
--^trmode=table --^trtable=table.txt
(根據é ç«¯å„²å­˜åº«ä½¿ç”¨é©—證檔案
從 'ldapserver:8084' 複製 'project' 儲存庫,並按照指定的轉譯表格
轉譯使用者。)
cm ^clone project@server.home:9095 --^package=project.plasticpkg
cm ^repository ^create project@mordor.home:8084
cm ^pull --^package=project.plasticpkg project@mordor.home:8084
(將 'project' 儲存庫從 'server.home:9095' 複製至
'project.plasticpkg' 套件,這之後會é€éŽæå–至
'mordor.home:8084' çš„ 'porject' 儲存庫的方å¼åŒ¯å…¥ã€‚)
== CMD_DESCRIPTION_REVERT ==
將項目還原為先å‰ä¿®è¨‚。
== CMD_USAGE_REVERT ==
用法:
cm ^revert <ä¿®è¨‚è¦æ ¼>
ä¿®è¨‚è¦æ ¼ 包å«å°‡åœ¨å·¥ä½œå€ä¸­è¼‰å…¥ä¹‹å…§å®¹çš„修訂的
è®Šæ›´é›†è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解修訂
è¦æ ¼ã€‚)
== CMD_HELP_REVERT ==
備註:
必須簽入項目。
範例:
cm ^revert dir#^cs:0
cm ^revert C:\mywks\dir\file1.txt#23456
== CMD_DESCRIPTION_HISTORY ==
顯示檔案或目錄的歷程記錄。
== CMD_USAGE_HISTORY ==
用法:
cm ^history | ^hist <é …ç›®_路徑>[ ...][--^long | --^format=<字串_æ ¼å¼>]
[--^symlink] [--^xml[=<輸出_檔案>]] [--^encoding=<å稱>]
項目_路徑 項目路徑。使用空格分隔路徑。使用
雙引號 (" ") 指定å«ç©ºæ ¼çš„路徑。
路徑也å¯ä»¥æ˜¯ä¼ºæœå™¨è·¯å¾‘修訂。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
é¸é …:
--^long 顯示其他資訊。
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^symlink 將歷程記錄作業套用至符號連çµï¼Œè€Œä¸æ˜¯
套用至目標。
--^xml å°‡ XML æ ¼å¼çš„輸出列å°è‡³æ¨™æº–輸出。
å¯ä»¥æŒ‡å®šè¼¸å‡ºæª”案。
--^encoding 與 '--^xml' é¸é …æ­é…使用,指定è¦åœ¨
XML 輸出中使用的編碼,亦å³ï¼šutf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
== CMD_HELP_HISTORY ==
備註:
此命令會顯示指定項目的修訂清單和標籤ã€åˆ†æ”¯ï¼Œ
ä»¥åŠæ¯å€‹ä¿®è¨‚的註解資訊。
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{0} | {^date} 日期。
{1} | {^changesetid} 變更集號碼。
{2} | {^branch} 分支。
{4} | {^comment} 註解。
{5} | {^owner} æ“æœ‰è€…。
{6} | {^id} 修訂 ID。
{7} | {^repository} 儲存庫。
{8} | {^server} 伺æœå™¨ã€‚
{9} | {^repspec} å„²å­˜åº«è¦æ ¼ã€‚
{^tab} æ’入定ä½å­—元空格。
{^newline} æ’入新行。
範例:
cm ^history file1.txt "file 2.txt"
cm ^hist c:\workspace --^long
(顯示所有資訊。)
cm ^history é€£çµ --^symlink
(將歷程記錄作業套用至 '連çµ' 檔案,而éžå¥—用至目標;
此功能é©ç”¨æ–¼ UNIX 環境。)
cm ^history ^serverpath:/src/foo/bar.c#^br:/main/task001@myserver
(從指定分支的伺æœå™¨è·¯å¾‘中擷å–修訂版本歷程記錄。)
== CMD_DESCRIPTION_REVISION_TREE ==
顯示項目的修訂樹。
== CMD_USAGE_REVISION_TREE ==
用法:
cm ^tree <路徑> [--^symlink]
路徑 項目路徑。
é¸é …:
--^symlink å°‡ä½œæ¥­å¥—ç”¨è‡³é€£çµæª”æ¡ˆï¼Œè€Œä¸æ˜¯å¥—用至目標。
== CMD_HELP_REVISION_TREE ==
範例:
cm ^tree fichero1.txt
cm ^tree c:\workspace
cm ^tree é€£çµ --^symlink
(å°‡ä½œæ¥­å¥—ç”¨è‡³é€£çµæª”æ¡ˆï¼Œè€Œä¸æ˜¯å¥—用至目標;此功能é©ç”¨æ–¼
UNIX 環境。)
== CMD_DESCRIPTION_REMOVE ==
å¯è®“使用者刪除檔案和目錄。
== CMD_USAGE_REMOVE ==
用法:
cm ^remove | ^rm <命令> [é¸é …]
命令:
^controlled (é¸ç”¨)
^private
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^remove <命令> --^usage
cm ^remove <命令> --^help
== CMD_HELP_REMOVE ==
範例:
cm ^remove \path\controlled_file.txt
cm ^remove ^private \path\private_file.txt
== CMD_DESCRIPTION_REMOVE_CONTROLLED ==
從版本控制刪除檔案或目錄。
== CMD_USAGE_REMOVE_CONTROLLED ==
用法:
cm ^remove | ^rm <é …ç›®_路徑>[ ...][--^format=<字串_æ ¼å¼>]
[--^errorformat=<字串_æ ¼å¼>] [--^nodisk]
é …ç›®_路徑 è¦ç§»é™¤çš„項目路徑。使用雙引號 (" ") 指定
å«ç©ºæ ¼çš„路徑。使用空格分隔
路徑。
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出進度
訊æ¯ã€‚如需詳細資訊,請åƒé–±ç¯„例。
--^errorformat ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–錯誤訊æ¯
(如果有的話)。如需詳細資訊,請åƒé–±ç¯„例。
--^nodisk 從版本控制移除,但將項目ä¿ç•™åœ¨
ç£ç¢Ÿä¸Šã€‚
== CMD_HELP_REMOVE_CONTROLLED ==
備註:
會從ç£ç¢Ÿåˆªé™¤é …目。會從原始程å¼ç¢¼æŽ§åˆ¶çš„上層目錄中
移除已移除的項目。
è¦æ±‚:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
從 stdin 讀å–輸入:
'^remove' 命令å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯å‚³éžå–®ä¸€
破折號「-ã€ä¾†å®Œæˆã€‚
範例:cm ^remove -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“您使用管線指定è¦ç§»é™¤çš„æª”案。
範例:
dir /S /B *.c | cm ^remove -
(在 Windows 中,移除工作å€ä¸­çš„æ‰€æœ‰ .c 檔案。)
範例:
cm ^remove src
(移除 'src'。如果 'src' 是目錄,這會與
'cm ^remove -^R src' 相åŒã€‚)
cm ^remove c:\workspace\file.txt --^format="{0} - 已移除" \
--^errorformat="{0} - 移除時發生錯誤"
(從版本控制和ç£ç¢Ÿä¸­ç§»é™¤ 'file.txt';如果作業æˆåŠŸï¼Œå‰‡å¯«å…¥
"c:\workspace\file.txt - ^REMOVED",或如果作業失敗,則寫入
"c:\workspace\file.txt - ^ERROR ^REMOVING"。)
cm ^remove c:\workspace\file.txt --^nodisk
(從版本控制移除 'file.txt',但將它ä¿ç•™åœ¨ç£ç¢Ÿä¸Šã€‚)
== CMD_DESCRIPTION_REMOVE_PRIVATE ==
刪除ç§äººæª”案或目錄。
警告:使用此命令刪除的檔案會永久刪除,而且無法
復原。建議您使用 '--^dry-run' é¸é …檢查
哪些檔案會å—到此命令影響。
== CMD_USAGE_REMOVE_PRIVATE ==
用法:
cm ^remove | ^rm ^private <路徑>[ ...][-^R | -^r | --^recursive] [--^ignored]
[--^verbose] [--^dry-run]
路徑 è¦ç§»é™¤çš„æª”案或目錄的路徑。使用雙
引號 (" ") 指定å«ç©ºæ ¼çš„路徑。使用
空格分隔路徑。
é¸é …:
--^r 以éžè¿´çš„æ–¹å¼å¾žå—控目錄內
刪除ç§äººæª”案。
--^ignored åŒæ™‚刪除忽略和隱匿的檔案和目錄。
--^verbose åˆ—å°æ‰€æœ‰å—影響的路徑。
--^dry-run 執行此命令,而ä¸åœ¨ç£ç¢Ÿä¸Šé€²è¡Œä»»ä½•變更。
== CMD_HELP_REMOVE_PRIVATE ==
備註:
如果路徑是ç§äººæª”案或目錄,則會從ç£ç¢Ÿä¸­å°‡å…¶åˆªé™¤ã€‚
å¦‚æžœè·¯å¾‘æ˜¯å—æŽ§æª”æ¡ˆï¼Œæ­¤å‘½ä»¤æœƒå¤±æ•—ã€‚
å¦‚æžœè·¯å¾‘æ˜¯å—æŽ§ç›®éŒ„ï¼Œé™¤éžæ‚¨
指定 '-^r' é¸é … (如此一來,將會刪除指定目錄下的所有ç§äººæª”案和
目錄),å¦å‰‡æ­¤å‘½ä»¤æœƒå¤±æ•—。
範例:
cm ^remove ^private ç§äºº_目錄
(刪除 'ç§äºº_目錄'。)
cm ^remove ^private c:\workspace\嗿ާ_目錄
(失敗,因為 '嗿ާ_目錄' 䏿˜¯ç§äººç›®éŒ„。)
cm ^remove ^private -^r c:\workspace\嗿ާ_目錄
(刪除 '嗿ާ_目錄' 下的所有ç§äººæª”案和目錄。)
cm ^rm ^private --^dry-run --^verbose c:\workspace\嗿ާ_目錄 -^r
(顯示å—到刪除 '嗿ާ_目錄' 下的ç§äººæª”案所影響的
所有路徑 (實際上未刪除任何項目)。)
cm ^rm ^private --^verbose c:\workspace\嗿ާ_目錄 -^r
(顯示å—到刪除 '嗿ާ_目錄' 下的ç§äººæª”案所影響的
所有路徑 (執行刪除動作)。)
== CMD_DESCRIPTION_TRIGGER_DELETE ==
刪除觸發器。
== CMD_USAGE_TRIGGER_DELETE ==
用法:
cm ^trigger | ^tr ^delete | ^rm <å­é¡žåž‹-類型> <ä½ç½®_號碼>
[--^server=<儲存庫伺æœå™¨è¦æ ¼>]
å­é¡žåž‹-類型 觸發器執行與觸發器作業。
輸入 'cm ^showtriggertypes' 以查看觸發器
類型的清單。
ä½ç½®_號碼 建立觸發器時指派給它的ä½ç½®ã€‚
é¸é …:
--^server 在指定的伺æœå™¨ä¸Šåˆªé™¤è§¸ç™¼å™¨ã€‚
如果未指定任何伺æœå™¨ï¼Œè«‹åœ¨ç”¨æˆ¶ç«¯ä¸Šè¨­å®šçš„
伺æœå™¨ä¸ŠåŸ·è¡Œå‘½ä»¤ã€‚
== CMD_HELP_TRIGGER_DELETE ==
範例:
cm ^trigger ^delete ^after-setselector 4
cm ^tr ^rm ^after-setselector 4
== CMD_DESCRIPTION_ATTRIBUTE_SET ==
在指定的物件上設定屬性。
== CMD_USAGE_ATTRIBUTE_SET ==
用法:
cm ^attribute | ^att ^set <屬性_è¦æ ¼> <物件_è¦æ ¼> <屬性_值>
屬性_è¦æ ¼ å±¬æ€§è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
ä»¥æ·±å…¥çž­è§£å±¬æ€§è¦æ ¼ã€‚)
物件_è¦æ ¼ è¦è¨­å®šå±¬æ€§çš„ç‰©ä»¶è¦æ ¼ã€‚
å¯åœ¨ä¸‹åˆ—項目上設定屬性:分支ã€è®Šæ›´é›†ã€
æ“±ç½®é›†ã€æ¨™ç±¤ã€é …目和修訂。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
屬性_值 è¦å°ç‰©ä»¶è¨­å®šçš„屬性值。
== CMD_HELP_ATTRIBUTE_SET ==
備註:
å¯åœ¨ç‰©ä»¶ä¸Šè¨­å®šå±¬æ€§ï¼Œä»¥å„²å­˜æ­¤ç‰©ä»¶çš„
其他資訊。
å¯åœ¨ä¸‹åˆ—物件上設定屬性:分支ã€è®Šæ›´é›†ã€
æ“±ç½®é›†ã€æ¨™ç±¤ã€é …目和修訂。
範例:
cm ^attribute ^set ^att:狀態 ^br:/main/SCM105 未解決
(使用 '未解決' 值將 '狀態' 屬性設定為 'SCM105' 分支。)
cm ^att ^set ^att:æ•´åˆ@reptest@server2:8084 ^lb:LB008@reptest@server2:8084 是
(在 'reptest' 儲存庫中以 '是' 值將 'æ•´åˆ' 屬性設定為
標籤 'LB008' 。)
== CMD_DESCRIPTION_SETOWNER ==
è¨­å®šç‰©ä»¶çš„æ“æœ‰è€…。
== CMD_USAGE_SETOWNER ==
用法:
cm ^setowner | ^sto --^user=<使用者_å稱> | --^group=<群組> <物件_è¦æ ¼>
--^user 使用者åç¨±ã€‚ç‰©ä»¶çš„æ–°æ“æœ‰è€…。
--^group 群組åç¨±ã€‚ç‰©ä»¶çš„æ–°æ“æœ‰è€…。
物件_è¦æ ¼ è¦è¨­å®šæ–°æ“æœ‰è€…çš„ç‰©ä»¶è¦æ ¼ã€‚
å¯åœ¨ä¸‹åˆ—ç‰©ä»¶ä¸Šè¨­å®šæ“æœ‰è€…:
儲存庫伺æœå™¨ã€å„²å­˜åº«ã€åˆ†æ”¯ã€è®Šæ›´é›†ã€
標籤ã€é …ç›®ã€ä¿®è¨‚和屬性。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
== CMD_HELP_SETOWNER ==
備註:
ç‰©ä»¶æ“æœ‰è€…å¯ç‚ºä½¿ç”¨è€…或群組。
å¯åœ¨ä¸‹åˆ—ç‰©ä»¶ä¸Šè¨­å®šæ“æœ‰è€…:儲存庫伺æœå™¨ã€
儲存庫ã€åˆ†æ”¯ã€è®Šæ›´é›†ã€æ¨™ç±¤ã€é …ç›®ã€ä¿®è¨‚和屬性。
範例:
cm ^setowner --^user=john ^repserver:localhost:8084
(å°‡ 'john' 設定為儲存庫伺æœå™¨æ“有者。)
cm ^sto --^group=development ^rep:mainRep@PlasticServer:8084
(å°‡ 'development' 群組設定為 'mainRep' å„²å­˜åº«çš„æ“æœ‰è€…。)
== CMD_DESCRIPTION_SETSELECTOR ==
將鏿“‡å™¨è¨­å®šç‚ºå·¥ä½œå€ã€‚
== CMD_USAGE_SETSELECTOR ==
此命令已棄用。它的存在是為了回溯相容性,
但在 Unity VCS 4.0 ä¸­å¤§å¤šå·²æ£„ç”¨é¸æ“‡å™¨ã€‚鏿“‡å™¨ä»
存在是為了指定工作分支或變更集,但舊è¦å‰‡
篩é¸è·¯å¾‘的功能已ä¸å†å—到支æ´ã€‚
用法:
cm ^setselector | ^sts [--^file=<鏿“‡å™¨_檔案>] [--^ignorechanges]
[--^forcedetailedprogress] [<工作å€_路徑> | <工作å€_è¦æ ¼>]
é¸é …:
--^file è¦å¾žä¸­è¼‰å…¥é¸æ“‡å™¨çš„æª”案。
--^ignorechanges å¦‚æžœåœ¨æ›´æ–°å·¥ä½œå€æ™‚嵿¸¬åˆ°
暫止的變更,則忽略顯示的暫止
變更警告訊æ¯ã€‚
--^forcedetailedprogress 強制顯示詳細進度,å³ä½¿åœ¨æ¨™æº–輸出
釿–°å°Žå‘的情æ³ä¸‹äº¦ç„¶ã€‚
工作å€_路徑 è¦è¨­å®šé¸æ“‡å™¨çš„工作å€è·¯å¾‘。
工作å€_è¦æ ¼ 工作å€è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
以深入瞭解工作å€è¦æ ¼ã€‚)
== CMD_HELP_SETSELECTOR ==
備註:
此命令會設定工作å€çš„鏿“‡å™¨ã€‚
工作å€éœ€è¦è³‡è¨Šæ‰èƒ½å¾žå„²å­˜åº«è¼‰å…¥ä¿®è¨‚。
為å–得此資訊,Unity VCS æœƒä½¿ç”¨é¸æ“‡å™¨ã€‚
é€éŽé¸æ“‡å™¨ï¼Œæ‚¨å¯ä»¥å¾žæŒ‡å®šçš„分支ã€
標籤或變更集載入修訂。
如果未指定è¦è¼‰å…¥é¸æ“‡å™¨çš„æª”案,則會執行é è¨­çš„作業
系統編輯器。
ç¯„ä¾‹é¸æ“‡å™¨ï¼š
^repository "^default" // 工作中儲存庫
^path "/" // è¦å‰‡å°‡å¥—用至根目錄
^branch "/^main" // 從 ^br:/^main å–得最新修訂
^checkout "/^main" // 將簽出置於分支 ^br:/^main 上
範例:
cm ^sts
(開啟è¦å¥—用的目å‰é¸æ“‡å™¨æª”案。)
cm ^sts ^wk:workspace_projA@reptest
(開啟è¦å¥—ç”¨çš„æŒ‡å®šé¸æ“‡å™¨æª”案。)
cm ^setselector --^file=c:\selectors\sel.xml
(在目å‰å·¥ä½œå€ä¸­è¨­å®šæŒ‡å®šçš„鏿“‡å™¨æª”案。)
cm ^setselector --^file=c:\selectors\sel.xml ^wk:MyWorkspace
(在所é¸å·¥ä½œå€ä¸­è¨­å®šæŒ‡å®šçš„鏿“‡å™¨æª”案。)
== CMD_DESCRIPTION_SHELVE ==
擱置已簽出項目的內容。
== CMD_USAGE_SHELVE ==
此命令已棄用。請改用 'cm ^shelveset'。
用法:
cm ^shelve [<項目_路徑>+] [--^all] [--^dependencies]
[-^c=字串_註解 | -^commentsfile=<註解_檔案>]
[--^encoding=å稱] [--^comparisonmethod=比較_方法]
(擱置內容。)
cm ^shelve --^apply=<擱置_è¦æ ¼> [--^mount]
(套用已儲存的擱置集。)
--^apply 還原指定擱置集的擱置內容。
æ“±ç½®è¦æ ¼ï¼šæŸ¥çœ‹ 'cm ^help ^objectspec'。
cm ^shelve --^delete=<擱置_è¦æ ¼>
(移除已儲存的擱置集。)
--^delete 移除指定的擱置集。
æ“±ç½®é›†è¦æ ¼ï¼šæŸ¥çœ‹ 'cm ^help ^objectspec'。
é¸é …:
é …ç›®_路徑 è¦æ“±ç½®çš„é …ç›® (以空格分隔)。å¯ä½¿ç”¨å¼•號 (")
來指定å«ç©ºæ ¼çš„路徑。
--^all 指定路徑上在本地變更ã€ç§»å‹•和刪除的項目
也會包括在內。
--^dependencies å°‡æœ¬åœ°è®Šæ›´ç›¸ä¾æ€§åŒ…å«åœ¨
è¦æ“±ç½®çš„項目中。
-^c 將指定註解套用至已建立的擱置集。
-^commentsfile 將指定檔案中的註解套用至已建立的
擱置集。
--^encoding 指定輸出編碼,例如:utf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^comparisonmethod 設定比較方法。如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
--^mount 指定儲存庫的è£è¼‰é»žã€‚
== CMD_HELP_SHELVE ==
備註:
如果未指定 <é …ç›®_路徑> 也未指定任何é¸é …,擱置將包å«
工作å€ä¸­æ‰€æœ‰æš«æ­¢çš„變更。
擱置作業一律會從指定路徑以éžè¿´æ–¹å¼å¥—用。
æ“±ç½®é …ç›®çš„è¦æ±‚:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
- 項目必須簽出或變更 (必須使用 --^all é¸é …)。
比較方法:
^ignoreeol 忽略行尾差異。
^ignorewhitespaces 忽略空格差異。
^ignoreeolwhitespaces 忽略行尾和空格差異。
^notignore 嵿¸¬è¡Œå°¾å’Œç©ºæ ¼å·®ç•°ã€‚
設定 PLASTICEDITOR 環境變數,以指定è¦è¼¸å…¥
註解的編輯器。
範例:
cm ^shelve -^c="我的註解"
(擱置目å‰å·¥ä½œå€ä¸­æ‰€æœ‰æš«æ­¢çš„變更,包括
註解。)
cm ^shelve file1.txt "file 2.txt" -^commentsfile=commentshelve.txt
(æ“±ç½®æ‰€é¸æš«æ­¢çš„變更並套用
commentshelve.txt 檔案中的註解。)
cm ^shelve --^apply=^sh:3
(套用已儲存的擱置集。)
cm ^shelve --^delete=^sh:3
(移除已儲存的擱置集。)
cm ^status --^short --^changelist=暫止_待_檢閱 | cm ^shelve -
(擱置用戶端變更清單。
以上命令會列出å為 '暫止_å¾…_檢閱' 變更清單中
çš„è·¯å¾‘ï¼Œä¸”æ­¤è·¯å¾‘æ¸…å–®æœƒé‡æ–°å°Žå‘至
擱置命令的輸入。)
== CMD_DESCRIPTION_SHELVESET ==
å¯è®“ä½¿ç”¨è€…ç®¡ç†æ“±ç½®é›†ã€‚
== CMD_USAGE_SHELVESET ==
用法:
cm ^shelveset <命令> [é¸é …]
命令:
^create | ^mk
^delete | ^rm
^apply
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^shelveset <命令> --^usage
cm ^shelveset <命令> --^help
== CMD_HELP_SHELVESET ==
範例:
cm ^shelveset ^create -^c="我的註解"
cm ^shelveset ^delete ^sh:3
cm ^shelve ^apply ^sh:3
== CMD_DESCRIPTION_SHELVESET_CREATE ==
擱置暫止的變更。
== CMD_USAGE_SHELVESET_CREATE ==
用法:
cm ^shelveset ^create | ^mk [<項目_路徑>[ ...]] [--^all] [--^dependencies]
[-^c=<字串_註解> | -^commentsfile=<註解_檔案>]
é¸é …:
é …ç›®_路徑 è¦æ“±ç½®çš„項目。使用空格分隔使用者å稱。
使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。
--^all 指定路徑上在本地變更ã€ç§»å‹•和刪除的項目
也會包括在內。
--^dependencies å°‡æœ¬åœ°è®Šæ›´ç›¸ä¾æ€§åŒ…å«åœ¨
è¦æ“±ç½®çš„項目中。
-^c 將指定註解套用至已建立的擱置。
-^commentsfile 將指定檔案中的註解套用至已建立的
擱置。
== CMD_HELP_SHELVESET_CREATE ==
'^shelveset ^create' 命令會將已簽出項目的內容儲存在
儲存庫內。如此一來,內容就會å—到ä¿è­·ï¼Œè€Œä¸éœ€è¦
簽入檔案。
備註:
如果未指定 <é …ç›®_路徑> 或任何é¸é …,擱置集將
包å«å·¥ä½œå€ä¸­æ‰€æœ‰æš«æ­¢çš„變更。
'^shelveset ^create' 作業一律會從指定路徑以éžè¿´æ–¹å¼
套用。
æ“±ç½®é …ç›®çš„è¦æ±‚:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
- 項目必須簽出或變更 (必須使用 '--^all' é¸é …)。
設定 PLASTICEDITOR 環境變數,以指定è¦è¼¸å…¥
註解的編輯器。
範例:
cm ^shelveset ^create -^c="我的註解"
(擱置目å‰å·¥ä½œå€ä¸­æ‰€æœ‰æš«æ­¢çš„變更,包括
註解。)
cm ^shelveset file1.txt "file 2.txt" -^commentsfile=commentshelve.txt
(æ“±ç½®æ‰€é¸æš«æ­¢çš„變更並套用 'commentshelve.txt' 檔案中
的註解。請注æ„,'^create' 為é è¨­å­å‘½ä»¤ã€‚)
cm ^status --^short --^changelist=暫止_待_檢閱 | cm ^shelveset -
(擱置用戶端變更清單。
以上命令會列出å為 '暫止_å¾…_檢閱' 變更清單中
çš„è·¯å¾‘ï¼Œä¸”æ­¤è·¯å¾‘æ¸…å–®æœƒé‡æ–°å°Žå‘至
'^shelveset' 命令的輸入。)
== CMD_DESCRIPTION_SHELVESET_DELETE ==
刪除擱置集。
== CMD_USAGE_SHELVESET_DELETE ==
用法:
cm ^shelveset ^delete | ^rm <擱置_è¦æ ¼>
擱置_è¦æ ¼ æ“±ç½®é›†è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
ä»¥æ·±å…¥çž­è§£æ“±ç½®é›†è¦æ ¼ã€‚)
== CMD_HELP_SHELVESET_DELETE ==
'^shelveset ^delete' 命令會刪除擱置集。
範例:
cm ^shelveset ^delete ^sh:3
(移除已儲存的擱置集。)
== CMD_DESCRIPTION_SHELVESET_APPLY ==
套用已儲存的擱置集。
== CMD_USAGE_SHELVESET_APPLY ==
用法:
cm ^shelveset ^apply <擱置_è¦æ ¼> [--^mount] [--^encoding=<å稱>]
[--^comparisonmethod=(^ignoreeol | ^ignorewhitespaces| \
^ignoreeolwhitespaces | ^notignore)]
擱置_è¦æ ¼ æ“±ç½®é›†è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
ä»¥æ·±å…¥çž­è§£æ“±ç½®é›†è¦æ ¼ã€‚)
é¸é …:
--^mount 指定儲存庫的è£è¼‰é»žã€‚
--^encoding 指定輸出編碼,例如:utf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^comparisonmethod 設定比較方法。如需詳細資訊,請åƒé–±å‚™è¨»ã€‚
== CMD_HELP_SHELVESET_APPLY ==
'^shelveset ^apply' 命令會還原已儲存擱置集的內容。
備註:
比較方法:
^ignoreeol 忽略行尾差異。
^ignorewhitespaces 忽略空格差異。
^ignoreeolwhitespaces 忽略行尾和空格差異。
^notignore 嵿¸¬è¡Œå°¾å’Œç©ºæ ¼å·®ç•°ã€‚
範例:
cm ^shelveset ^apply ^sh:3
(套用已儲存擱置。)
== CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
列出物件和屬性。
== CMD_USAGE_SHOW_FIND_OBJECTS ==
用法:
cm ^showfindobjects
== CMD_HELP_SHOW_FIND_OBJECTS ==
å¯ç”¨ç‰©ä»¶èˆ‡å±¬æ€§ï¼š
^attribute:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾å±¬æ€§ï¼š
^type :字串。
範例:
cm ^find ^attribute "^where ^type = '狀態'"
(尋找 '狀態' 類型的所有屬性。)
^value :字串。
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
範例:
cm ^find ^attribute "^where ^date > '^this ^week'"
(尋找本週已套用的所有屬性。)
^owner :使用者。
准許特殊使用者 '^me'。
範例:
cm ^find ^attribute "^where ^value = '已解決' ^and ^owner = '^me'"
(尋找我已套用 '已解決' 值的所有屬性。)
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
^comment :字串。
^srcobj ï¼šç‰©ä»¶è¦æ ¼ï¼šé …目路徑ã€åˆ†æ”¯ã€è®Šæ›´é›†ã€ä¿®è¨‚或標籤。
使用 'cm ^help ^objectspec' 以瞭解如何指定這些物件。
範例:
cm ^find ^attribute "^where ^srcobj = '^item:readme.txt'"
(尋找已套用至項目 'readme.txt' 的屬性。)
cm ^find ^attribute "^where ^srcobj = '^br:/main/scm23343'"
(尋找已套用至 scm23343 分支的屬性。)
cm ^find ^attribute "^where ^srcobj = '^rev:readme.txt#^br:/main/task002'"
(尋找已套用至指定修訂版本的屬性。)
cm ^find ^attribute "^where ^srcobj = '^rev:^revid:1126'"
(尋找已套用至指定修訂 ID 的屬性。)
^ID :整數。
^attributetype:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾å±¬æ€§é¡žåž‹ï¼š
^name :字串。
範例:
cm ^find ^attributetype "^where ^name ^like 'st%'"
(尋找å稱開頭為 'st' 的所有屬性。)
^value :字串。
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
範例:
cm ^find ^attribute "^where ^date > '^today'"
(尋找今天已套用的所有屬性。)
^owner :使用者。
准許特殊使用者 '^me'。
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
^comment :字串。
範例:
cm ^find ^attributetype "^where ^comment != ''" --^xml
(尋找具有註解的所有屬性類型,並
以 XML æ ¼å¼å°‡è¼¸å‡ºåˆ—å°è‡³æ¨™æº–輸出。)
^source ï¼šç‰©ä»¶è¦æ ¼ï¼šé …目路徑ã€åˆ†æ”¯ã€è®Šæ›´é›†æˆ–標籤。
使用 'cm ^help ^objectspec' 以瞭解如何指定這些物件。
範例:
cm ^find ^attributetype "^where ^source = '^item:readme.txt'"
(尋找項目 'readme.txt' 中的所有屬性類型。)
cm ^find ^attributetype "^where ^source = '^cs:30'"
(尋找變更集 '30' 中的所有屬性類型。)
cm ^find ^attributetype "^where ^source = '^lb:v0.14.1'"
(尋找標籤 'v0.14.1' 中的所有屬性類型。)
^ID :整數。
複寫欄ä½ã€‚檢查下列「複寫相關欄ä½ã€ã€‚
^ReplLogId
^ReplSrcDate
^ReplSrcId
^ReplSrcRepository
^ReplSrcServer
^branch:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾åˆ†æ”¯ï¼š
^name :字串。
範例:
cm ^find ^branch "^where ^name ^like 'scm23%'"
(尋找å稱開頭為 'scm23' 的分支。)
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
範例:
cm ^find ^branch "^where ^date > '^one ^week ^ago'"
(尋找上週已建立的分支。)
^changesets :日期 (分支中變更集的日期)。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
範例:
cm ^find ^branch "^where ^changesets >= '^today'"
(å°‹æ‰¾ä»Šå¤©å·²å»ºç«‹ä¸”å«æœ‰è®Šæ›´é›†çš„分支。)
^attribute :字串。
^attrvalue :字串。
範例:
cm ^find ^branch "^where ^attribute = '狀態' ^and ^attrvalue = '失敗'"
(尋找具有 '狀態' 屬性且
值為 '失敗' 的分支。)
^owner :使用者。
准許特殊使用者 '^me'。
^parent ï¼šåˆ†æ”¯è¦æ ¼ã€‚
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
範例:
cm ^find ^branch "^where ^owner != '^me' ^and ^parent != '^br:/main'"
(尋找由其他人建立且其上層
åˆ†æ”¯ä¸¦éž '/main' 的分支。)
^comment :字串。
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
^ID :整數。
範例:
cm ^find ^branch "^where ^id = 2029607"
(尋找 ID 為 2029607 的分支。)
複寫欄ä½ã€‚檢查下列「複寫相關欄ä½ã€ã€‚
^ReplLogId
^ReplSrcDate
^ReplSrcId
^ReplSrcRepository
^ReplSrcServer
^changeset:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾è®Šæ›´é›†ï¼š
^branch ï¼šåˆ†æ”¯è¦æ ¼ã€‚
使用 'cm ^help ^objectspec' 以瞭解如何指定此
物件。
範例:
cm ^find ^changeset "^where ^branch = '/main/scm23119'"
(尋找分支 'scm23119' 中的所有變更集。)
^changesetid :整數。
^attribute :字串。
範例:
cm ^find ^changeset "^where ^attribute = '狀態'"
(尋找具有 '狀態' 屬性的變更集。)
^attrvalue :字串。
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
^owner :使用者。
准許特殊使用者 '^me'。
範例:
cm ^find ^changeset "^where ^date >= '2018/8/6' ^and ^owner != '^me'"
(尋找建立日期大於或等於
2018/8/6 且由其他人建立的所有變更集。)
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
範例:
cm ^find ^changeset "^where ^guid = '1b30674f-14cc-4fd7-962b-676c8a6f5cb6'"
(尋找具有指定 GUID 的變更集。)
^comment :字串。
範例:
cm ^find ^changeset "^where ^comment = ''"
(尋找ä¸å«ä»»ä½•註解的變更集。)
^onlywithrevisions:布林值。
篩é¸è®Šæ›´é›†æ˜¯å¦æœ‰ä¿®è¨‚。
範例:
cm ^find ^changeset "^where ^onlywithrevisions = 'false'"
(尋找ä¸å«ä»»ä½•修訂的變更集。)
^returnparent :布林值。
回到變更集上層的方å¼ã€‚é©åˆç”¨æ–¼ç·¨å¯«æŒ‡ä»¤ç¢¼ã€‚
範例:
cm ^find ^changeset "^where ^changesetid = 29 ^and ^returnparent = 'true'"
(尋找變更集 29 的上層。)
^parent :變更集 ID (整數)。
範例:
cm ^find ^changeset "^where ^parent = 548"
(尋找上層為變更集 548 的所有變更集。)
^ID :整數。
複寫欄ä½ã€‚檢查下列「複寫相關欄ä½ã€ã€‚
^ReplLogId
^ReplSrcDate
^ReplSrcId
^ReplSrcRepository
^ReplSrcServer
^label:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾æ¨™ç±¤ï¼š
^name :字串。
範例:
cm ^find ^label "^where ^name ^like '7.0.16.%'"
(尋找å稱開頭為 '7.0.16' 的標籤。)
^attribute :字串。
^attrvalue :字串。
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
範例:
cm ^find ^label "^where ^date >= '^this ^month' ^and \
^attribute = '發佈-狀態' ^and ^attrvalue != '已發佈'"
(尋找本月已建立且 '發佈-狀態' 屬性
設為 '已發佈' 以外的值的標籤。)
^owner :使用者。
准許特殊使用者 '^me'。
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
^branch ï¼šåˆ†æ”¯è¦æ ¼ã€‚
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
範例:
cm ^find ^label "^where ^branch = '/main'"
(尋找已套用至主è¦åˆ†æ”¯çš„æ‰€æœ‰æ¨™ç±¤ã€‚)
^branchid :整數。
^changeset :變更集 ID (整數)。
範例:
cm ^find ^label "^where ^changeset = 111733"
(尋找已套用至變更集 111733 的標籤。)
^comment :字串。
^ID :整數。
複寫欄ä½ã€‚檢查下列「複寫相關欄ä½ã€ã€‚
^ReplLogId
^ReplSrcDate
^ReplSrcId
^ReplSrcRepository
^ReplSrcServer
^merge:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾åˆä½µï¼š
^srcbranch ï¼šåˆ†æ”¯è¦æ ¼ã€‚
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
範例:
cm ^find ^merge "^where ^srcbranch = '^br:/main'"
(尋找來自主è¦åˆ†æ”¯çš„åˆä½µã€‚)
^srcchangeset :變更集 ID (整數)。
^dstbranch ï¼šåˆ†æ”¯è¦æ ¼ã€‚
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
^dstchangeset :變更集 ID (整數)。
範例:
cm ^find ^merge "^where ^dstchangeset = 108261" \
--^format="{^srcbranch} {^srcchangeset} {^dstbranch} {^dstchangeset} {^owner}"
(尋找變更集 108261 çš„åˆä½µï¼Œä¸¦åˆ—å°
é¡¯ç¤ºä¾†æº (分支和變更集 ID)ã€
目的地 (分支和變更集 ID) 以åŠåˆä½µæ“有者的格å¼åŒ–輸出。)
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
^owner :使用者。
准許特殊使用者 '^me'。
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
^type :字串。
å¯èƒ½çš„值為 '^merge'ã€'^cherrypick'ã€
'^cherrypicksubstractive'ã€'^interval'ã€'^intervalcherrypick'
和 '^intervalcherrypicksubstractive'
範例:
cm ^find ^merge "^where ^type = '^cherrypick' ^and ^owner = '^me'"
(尋找我所有精心挑é¸çš„項目。)
^ID :整數。
^replicationlog:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾è¤‡å¯«è¨˜éŒ„:
^branch ï¼šåˆ†æ”¯è¦æ ¼ã€‚
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
範例:
cm ^find ^replicationlog "^where ^branch = '/main/gm22358'"
(尋找分支 'gm22358' 的複寫記錄。)
^repositoryname :字串。
^owner :使用者。
准許特殊使用者 '^me'。
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
^server :字串。
^package :布林值。
範例:
cm ^find ^replicationlog "^where ^package = 'T' ^and ^server ^like '%cloud%'"
(尋找從伺æœå™¨åç¨±åŒ…å« 'cloud' 之套件
所建立的複寫記錄。)
^ID :整數。
^review:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾ç¨‹å¼ç¢¼æª¢é–±ï¼š
^status :字串。
^assignee :字串。
範例:
cm ^find ^review "^where ^status = '暫止' ^and ^assignee = '^me'"
(尋找我所有暫止的檢閱。)
^title :字串。
^target ï¼šç‰©ä»¶è¦æ ¼ï¼šåˆ†æ”¯æˆ–變更集。
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
範例:
cm ^find ^review "^where ^target = '^br:/main/scm17932'"
(尋找分支 'scm17932' 的相關檢閱。)
^targetid :整數。
^targettype :字串。
å¯èƒ½çš„值為 '^branch' å’Œ '^changeset'。
範例:
cm ^find ^review "^where ^targettype = '^changeset'"
(尋找目標類型為變更集的檢閱。)
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
^owner :使用者。
准許特殊使用者 '^me'。
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
^ID :整數。
^revision:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾ä¿®è¨‚:
^branch ï¼šåˆ†æ”¯è¦æ ¼ã€‚
使用 'cm ^help ^objectspec' 以瞭解如何指定此物件。
^changeset :變更集 ID (整數)。
範例:
cm ^find ^revision "^where ^changeset >= 111756"
(尋找變更集 111756
和更新版本中建立的修訂。)
^item :字串或整數。
^itemid :整數。
範例:
cm ^find ^revision "^where ^item = 'readme.txt' ^or ^itemid = 2250"
(尋找項目 'readme.txt' 的修訂以åŠ
項目 ID 2250。)
cm ^find ^revision "^where ^item = 'readme.txt' ^or ^item = 2250"
–得與先å‰ç¯„例相åŒçš„修訂。)
^attribute :字串。
^attrvalue :字串。
範例:
cm ^find ^revision "^where ^attribute = '狀態' ^and ^attrvalue != '未解決'"
(尋找具有 '狀態' 屬性且值
ä¸¦éž '未解決' 的修訂。)
^archived :布林值。
範例:
cm ^find ^revision "^where ^archived = 'true'"
(尋找外部儲存空間中的
å·²å°å­˜ä¿®è¨‚。)
^comment :字串。
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
^owner :使用者。
准許特殊使用者 '^me'。
^parent :修訂 ID (整數)。
^returnparent :布林值。
^shelve :擱置 ID (整數)。
^size :整數 (以ä½å…ƒçµ„為單ä½)。
^type :字串。
å¯èƒ½çš„值為 '^dir'ã€'^bin' å’Œ '^txt'。
範例:
cm ^find ^revision "^where ^type = '^txt' 和 \
^size > 300000 ^and ^owner = '^me' and ^date >= '2 ^months ^ago'"
(尋找我在兩個月之å‰å»ºç«‹
且大å°ç´„大於 3MB 的文字修訂。)
^workspacecheckoutid :整數。
^ID :整數。
複寫欄ä½ã€‚檢查下列「複寫相關欄ä½ã€ã€‚
^ReplLogId
^ReplSrcDate
^ReplSrcId
^ReplSrcRepository
^ReplSrcServer
^shelve:
您å¯ä½¿ç”¨ä¸‹åˆ—欄ä½é€²è¡Œç¯©é¸ä»¥å°‹æ‰¾æ“±ç½®ï¼š
^owner :使用者。
准許特殊使用者 '^me'。
^date :日期。
如需詳細資訊,請查看本指å—中的「日期常數ã€ã€‚
範例:
cm ^find ^shelve "^where ^owner != '^me' ^and ^date >= '^1 ^years ^ago'"
(尋找其他人在去年
期間建立的擱置。)
^attribute :字串。
^attrvalue :字串。
^comment :字串。
^GUID :全域唯一識別碼。
åå…­é€²ä½ ID (æ ¼å¼ç‚º xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx)。
^parent :整數。
^shelveid :整數。
範例:
cm ^find ^shelve "^where ^shelveid = 2"
(尋找具有å稱 2 的擱置。)
^ID :整數。
範例:
cm ^find ^shelve "^where ^id >= 3848"
(尋找具有 ID 大於 3848 之物件的擱置。)
複寫欄ä½ã€‚檢查下列「複寫相關欄ä½ã€ã€‚
^ReplLogId
^ReplSrcDate
^ReplSrcId
^ReplSrcRepository
^ReplSrcServer
複寫相關欄ä½ï¼š
很多物件會追蹤複寫資料,這表示 Unity VCS 會追蹤
原本建立這些資料的所在ä½ç½®ã€‚
您å¯ä»¥ä½¿ç”¨çš„æ¬„ä½åŒ…括:
^ReplSrcServer ï¼šå„²å­˜åº«è¦æ ¼ã€‚代表「複寫來æºä¼ºæœå™¨ã€ã€‚
已從中複寫物件的伺æœå™¨ã€‚
範例:
cm ^find ^branch "^where ^replsrcserver='skull.codicefactory.com:9095'"
(尋找從伺æœå™¨ 'skull' 複寫的分支。)
^ReplSrcRepository :字串。代表「複寫來æºå„²å­˜åº«ã€ã€‚這是
已從中複寫物件的儲存庫。
範例:
cm ^find ^branch "^where ^replsrcserver = 'skull.codicefactory.com:9095' \
^and ^replsrcrepository = 'codice'"
(尋找已從伺æœå™¨ 'skull' 和儲存庫
'codice' 複寫的分支。)
^ReplLogId :整數。複寫作業的 ID。在 Unity VCS 中,
æ¯æ¬¡å¾žè¤‡æœ¬å»ºç«‹æ–°ç‰©ä»¶æ™‚,
都會建立新的「複寫記錄ã€ã€‚
範例:
cm ^find ^revision "^where ^repllogid = 2019974"
(尋找從複本
2019974 複寫的修訂。)
^ReplSrcDate :日期。這是複本實際發生的
日期。
複寫物件會ä¿ç•™å…¶åŽŸå§‹å»ºç«‹æ—¥æœŸï¼Œ
而如果您想è¦å°‹æ‰¾åœ¨ç‰¹å®šæ™‚é–“
範åœå…§è¤‡å¯«çš„物件,
æ­¤æ¬„ä½æœƒéžå¸¸æœ‰ç”¨ã€‚
範例:
cm ^find ^label "^where ^replsrcdate >= '^one ^month ^ago' \
^and ^date >= '15 ^days ^ago'"
(尋找在 15 天之å‰å»ºç«‹ä¸”在一個月
之å‰è¤‡å¯«çš„æ¨™ç±¤ã€‚)
cm ^find ^replicationlog "^where ^date > '^one ^week ^ago'"
8780433 2018/09/27 8:49:38 codice@BACKYARD:8087 F mbarriosc
(尋找一週之å‰å»ºç«‹çš„複寫記錄。)
ç¾åœ¨ï¼Œæ‚¨å¯ä»¥æª¢æŸ¥æ˜¯å¦å·²åœ¨è¤‡å¯«å‰
建立複寫分支:
cm ^find ^branch "^where ^repllogid = 8780433"
8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T
^ReplSrcId :整數。這是複寫來æºä¼ºæœå™¨çš„ ID。
您å¯ä½¿ç”¨ 'cm ^find' 命令æœå°‹
'^replicationsource' 物件以探索此 ID。
範例:
cm ^find ^replicationsource
7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9
ç¾åœ¨ï¼Œæ‚¨å¯å¾žä»¥ä¸‹å°‹æ‰¾è¤‡å¯«çš„變更集:
codice@AFRODITA:8087:
cm ^find ^changesets "^where ^replsrcid = 7860739"
日期常數:
您å¯ä»¥ä½¿ç”¨éµå¾ªæ‚¨çš„æ©Ÿå™¨ç•¶åœ°èªžç³»åŒ–設定的日期格å¼ã€‚
例如,如果您的電腦顯示 'MM-dd-yyyy' æ ¼å¼çš„æ—¥æœŸï¼Œ
,則您å¯ä»¥åœ¨æŸ¥è©¢ä¸­ä½¿ç”¨ '12-31-2019' 等日期。
您也å¯ä»¥ä½¿ç”¨ä¸‹åˆ—常數簡化查詢:
'^today' :今天的日期。
'^yesterday' :昨天的日期。
'^this ^week' :本週星期一的日期。
'^this ^month' :本月第 1 天的日期。
'^this ^year' :今年 1 月 1 日的日期。
'^one ^day ^ago' ï¼šç›®å‰æ—¥æœŸçš„一天å‰ã€‚
'^one ^week ^ago' ï¼šç›®å‰æ—¥æœŸçš„七天å‰ã€‚
'^one ^month ^ago' ï¼šç›®å‰æ—¥æœŸçš„一個月å‰ã€‚
'n ^days ^ago' ï¼šç›®å‰æ—¥æœŸçš„「nã€å¤©å‰ã€‚
'n ^months ^ago' ï¼šç›®å‰æ—¥æœŸçš„「nã€å€‹æœˆå‰ã€‚
'n ^years ^ago' ï¼šç›®å‰æ—¥æœŸçš„「nã€å¹´å‰ã€‚
下列 '^where' å­å¥é©ç”¨æ–¼æ¬„ä½é¡žåž‹ '^date':
'(...)^where ^date > '^today' (...)'
'(...)^where ^date < '^yesterday' (...)'
'(...)^where ^date > '^this ^week' (...)'
'(...)^where ^date > '^this ^month' (...)'
'(...)^where ^date < '^one ^day ^ago' ^and ^date > '3 ^days ^ago' (...)'
'(...)^where ^date < '^one ^week ^ago' ^and ^date > '3 ^weeks ^ago' (...)'
'(...)^where ^date < '^one ^month ^ago' ^and ^date > '3 ^months ^ago' (...)'
'(...)^where ^date > '1 ^year ^ago' (...)'
您也å¯ä»¥åœ¨ 'cm ^find' 命令上é€éŽ
--^dateformat 標誌強制使用特定日期格å¼ã€‚請查看 'cm ^find --^help' 以瞭解詳細資訊。
== CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
顯示å¯ç”¨çš„觸發類型。
== CMD_USAGE_TRIGGER_SHOWTYPES ==
用法:
cm ^trigger ^showtypes
== CMD_DESCRIPTION_SHOWACL ==
顯示物件的 ACL。
== CMD_USAGE_SHOWACL ==
用法:
cm ^showacl | ^sa <物件_è¦æ ¼> [--^extended] [--^xml[=<輸出_檔案>]]
[--^encoding=<å稱>]
物件_è¦æ ¼ è¦é¡¯ç¤º ACL çš„ç‰©ä»¶è¦æ ¼ã€‚
此命令的有效物件為:
儲存庫伺æœå™¨ã€å„²å­˜åº«ã€åˆ†æ”¯ã€è®Šæ›´é›†ã€æ¨™ç±¤ã€é …目,
以åŠå±¬æ€§ã€‚
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
é¸é …:
--^extended 顯示 ACL 階層樹。
--^xml å°‡ XML æ ¼å¼çš„輸出列å°è‡³æ¨™æº–輸出。
å¯ä»¥æŒ‡å®šè¼¸å‡ºæª”案。
--^encoding 與 '--^xml' é¸é …æ­é…使用,指定è¦åœ¨
XML 輸出中使用的編碼,亦å³ï¼šutf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
== CMD_HELP_SHOWACL ==
範例:
cm ^showacl ^repserver:PlasticServer:8084
(顯示所é¸ä¼ºæœå™¨çš„ ACL。)
cm ^sa ^br:/main --^extended
(顯示所é¸åˆ†æ”¯è¦æ ¼çš„ ACL 階層樹。)
== CMD_DESCRIPTION_SHOWCOMMANDS ==
顯示所有å¯ç”¨å‘½ä»¤ã€‚
== CMD_USAGE_SHOWCOMMANDS ==
用法:
cm ^showcommands
== CMD_HELP_SHOWCOMMANDS ==
== CMD_DESCRIPTION_SHOWOWNER ==
é¡¯ç¤ºç‰©ä»¶çš„æ“æœ‰è€…。
== CMD_USAGE_SHOWOWNER ==
用法:
cm ^showowner | ^so <物件_è¦æ ¼>
物件_è¦æ ¼ è¦é¡¯ç¤ºæ“æœ‰è€…çš„ç‰©ä»¶è¦æ ¼ã€‚
物件必須是下列其中一種:
儲存庫伺æœå™¨ã€å„²å­˜åº«ã€åˆ†æ”¯ã€è®Šæ›´é›†ã€
標籤ã€å±¬æ€§ã€ä¿®è¨‚和項目。
(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
== CMD_HELP_SHOWOWNER ==
備註:
æ­¤å‘½ä»¤æœƒé¡¯ç¤ºç‰©ä»¶çš„æ“æœ‰è€…ã€‚æ“æœ‰è€…å¯ç‚ºä½¿ç”¨è€…或
群組。å¯ä½¿ç”¨ 'cm ^setowner' å‘½ä»¤ä¿®æ”¹æ“æœ‰è€…。
範例:
cm ^showowner ^repserver:PlasticServer:8084
(顯示所é¸ä¼ºæœå™¨çš„æ“æœ‰è€…ã€‚)
cm ^so ^item:samples\
(顯示所é¸é …ç›®è¦æ ¼çš„æ“æœ‰è€…ã€‚)
== CMD_DESCRIPTION_SHOWPERMISSIONS ==
列出å¯ç”¨æ¬Šé™ã€‚
== CMD_USAGE_SHOWPERMISSIONS ==
用法:
cm ^showpermissions | ^sp
== CMD_HELP_SHOWPERMISSIONS ==
範例:
cm ^showpermissions
== CMD_DESCRIPTION_SHOWSELECTOR ==
顯示工作å€é¸æ“‡å™¨ã€‚
== CMD_USAGE_SHOWSELECTOR ==
此命令已棄用。它的存在是為了回溯相容性,
但在 Unity VCS 4.0 ä¸­å¤§å¤šå·²æ£„ç”¨é¸æ“‡å™¨ã€‚鏿“‡å™¨ä»
存在是為了指定工作分支或變更集,但舊è¦å‰‡
篩é¸è·¯å¾‘的功能已ä¸å†å—到支æ´ã€‚
用法:
cm ^showselector | ^ss [<工作å€_路徑> | <工作å€_è¦æ ¼>]
工作å€_路徑 è¦é¡¯ç¤ºé¸æ“‡å™¨çš„工作å€è·¯å¾‘。
工作å€_è¦æ ¼ 工作å€è¦æ ¼ã€‚(使用 'cm ^help ^objectspec' 以
深入瞭解工作å€è¦æ ¼ã€‚)
== CMD_HELP_SHOWSELECTOR ==
備註:
如果未指定路徑或工作å€è¦æ ¼ï¼Œå‘½ä»¤å°‡ä»¥
ç›®å‰ç›®éŒ„åšç‚ºå·¥ä½œå€è·¯å¾‘。
範例:
cm ^showselector c:\workspace
(顯示所é¸å·¥ä½œå€è·¯å¾‘çš„é¸æ“‡å™¨ã€‚)
cm ^ss
(顯示目å‰å·¥ä½œå€çš„鏿“‡å™¨ã€‚)
cm ^showselector > mySelector.txt
(將目å‰å·¥ä½œå€çš„鏿“‡å™¨å¯«å…¥æª”案。)
cm ^showselector ^wk:mywk@reptest
(顯示 'reptest' 儲存庫中 'mywk' 工作å€çš„鏿“‡å™¨ã€‚)
== CMD_DESCRIPTION_SUPPORT ==
å¯è®“使用者執行支æ´ç›¸é—œä½œæ¥­ã€‚
== CMD_USAGE_SUPPORT ==
用法:
cm ^support <命令> [é¸é …]
命令:
^bundle
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^support <命令> --^usage
cm ^support <命令> --^help
== CMD_HELP_SUPPORT ==
範例:
cm ^support
cm ^support ^bundle
cm ^support ^bundle c:\outputfile.zip
== CMD_DESCRIPTION_SUPPORT_BUNDLE ==
å»ºç«‹å«æœ‰ç›¸é—œè¨˜éŒ„的「支æ´çµ„åˆã€å¥—件。
您å¯ä»¥åœ¨è¦æ±‚å”助ã€ç´¢å–é¡å¤–資訊或
æäº¤éŒ¯èª¤æ™‚附加檔案。
== CMD_USAGE_SUPPORT_BUNDLE ==
用法:
cm ^support ^bundle [<輸出檔案>]
é¸é …:
輸出檔案 在指定的ä½ç½®
建立「支æ´çµ„åˆã€å¥—件。
== CMD_HELP_SUPPORT_BUNDLE ==
備註:
此命令å¯è®“使用者建立「支æ´çµ„åˆã€å¥—件,以便
åœ¨è¦æ±‚å”助ã€ç´¢å–é¡å¤–資訊或æäº¤éŒ¯èª¤æ™‚附加。
使用者å¯é¸æ“‡æ˜¯å¦è¦æŒ‡å®šè¼¸å‡ºæª”案的ä½ç½®ï¼›å¦‚果未指定,
輸出檔案將寫入暫存目錄。
範例:
cm ^support ^bundle
(在暫存目錄中建立「支æ´çµ„åˆã€ã€‚)
cm ^support ^bundle c:\outputfile.zip
(在指定的ä½ç½®å»ºç«‹ã€Œæ”¯æ´çµ„åˆã€ã€‚)
== CMD_DESCRIPTION_SWITCH ==
將工作å€åˆ‡æ›è‡³åˆ†æ”¯ã€è®Šæ›´é›†ã€æ¨™ç±¤æˆ–擱置集。
== CMD_USAGE_SWITCH ==
用法:
cm ^switch (<åˆ†æ”¯è¦æ ¼> | <變更åŠè¦æ ¼> | <æ¨™ç±¤è¦æ ¼> | <æ“±ç½®é›†è¦æ ¼>)
[--^workspace=<路徑>] [--^repository=<å稱>]
[--^forcedetailedprogress]
(使用 'cm ^help ^objectspec' 以深入瞭解分支ã€è®Šæ›´é›†ã€æ¨™ç±¤
å’Œæ“±ç½®é›†è¦æ ¼ã€‚)
é¸é …:
--^workspace å·¥ä½œå€æ‰€åœ¨ä½ç½®çš„路徑。
--^repository 切æ›è‡³æŒ‡å®šå„²å­˜åº«ã€‚
--^forcedetailedprogress 強制顯示詳細進度,å³ä½¿åœ¨æ¨™æº–輸出
釿–°å°Žå‘的情æ³ä¸‹äº¦ç„¶ã€‚
== CMD_HELP_SWITCH ==
備註:
此命令å¯è®“ä½¿ç”¨è€…å°‡å·¥ä½œå€æ¨¹æ›´æ–°ç‚ºæŒ‡å®šç‰©ä»¶
(åˆ†æ”¯ã€æ¨™ç±¤ã€æ“±ç½®é›†æˆ–變更集) 的內容。
範例:
cm ^switch ^br:/main
cm ^switch ^lb:Rel1.1
cm ^switch ^br:/main/scm002 --^repository=rep2
cm ^switch ^cs:4375
cm ^switch ^sh:2
== CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
將分支設定為工作分支。
== CMD_USAGE_SWITCH_TO_BRANCH ==
此命令已棄用。請改用 cm 切æ›ã€‚
用法:
cm ^switchtobranch [é¸é …] [分支_è¦æ ¼]
分支_è¦æ ¼ï¼šåˆ†æ”¯è¦æ ¼ã€‚
é¸é …:
--^label=å稱 | --^changeset=數字:從指定的標籤或變更集
載入修訂。如果未指定分支_è¦æ ¼ï¼Œå‰‡éœ€è¦
下列其中一個é¸é …。
--^changeset=變更集:切æ›è‡³æŒ‡å®šçš„變更集。
--^repository=儲存庫:切æ›è‡³æŒ‡å®šçš„儲存庫。
--^workspace | -工作å€=è·¯å¾‘ï¼šå·¥ä½œå€æ‰€åœ¨ä½ç½®çš„路徑。
== CMD_HELP_SWITCH_TO_BRANCH ==
備註:
此命令å¯è®“使用者在分支中工作。
如果未指定分支_è¦æ ¼ï¼Œå‰‡å¿…須指定標籤或變更集。
如果未指定儲存庫,分支則會設定為目å‰å„²å­˜åº«ã€‚
範例:
cm ^switchtobranch ^br:/main
cm ^switchtobranch ^br:/main/task001
cm ^switchtobranch --^label=BL050
(唯讀組態。此命令會載入已標示
變更集的內容。)
== CMD_DESCRIPTION_SYNC ==
與 Git åŒæ­¥ã€‚
== CMD_USAGE_SYNC ==
用法:
cm ^synchronize | ^sync <å„²å­˜åº«è¦æ ¼> ^git [<url> [--^user=<使用者_å稱> --^pwd=<密碼>]]
[(--^txtsimilaritypercent | --^binsimilaritypercent | \
--^dirsimilaritypercent)=<值>]
[--^author] [--^skipgitlfs]
å„²å­˜åº«è¦æ ¼ å„²å­˜åº«è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
ä»¥æ·±å…¥çž­è§£å„²å­˜åº«è¦æ ¼ã€‚)
git (é è¨­)。
é¸é …:
url é ç«¯å„²å­˜åº« URL (http(s):// 或 git:// 或
SSH URL)。
--^user 指定 URL 的使用者å稱。
--^pwd 指定 URL 的密碼。
--^txtsimilaritypercent \
--^binsimilaritypercent \
--^dirsimilaritypercent
å¯åµæ¸¬å·²ç§»å‹•的項目,與 Unity VCS
GUI 的方å¼ç›¸åŒã€‚
--^author 使用 git 作者的å稱和時間戳記值。
(é è¨­ç‚º git æäº¤è€…)
--^skipgitlfs 忽略
.gitattributes 檔案中的 Git LFS 組態。它的功能與沒有 Git LFS
支æ´çš„æƒ…æ³é¡žä¼¼ã€‚
== CMD_HELP_SYNC ==
備註:
如果 git å„²å­˜åº«è¦æ±‚輸入使用者和密碼,則請使用 '^url'ã€'--^user'
å’Œ '--^pwd' é¸é …。
如果 git å„²å­˜åº«æœªè¦æ±‚輸入使用者和密碼,則請將 '^url'
é¸é …èˆ‡ç¬¬ä¸€å€‹åŒæ­¥ä½œæ¥­æ­é…ä½¿ç”¨ã€‚å°æ–¼å¾ŒçºŒåŒæ­¥ä½œæ¥­ï¼Œ'^url'
為é¸ç”¨é¸é …。
è‹¥è¦ä½¿ç”¨ SSH 通訊å”å®šåŸ·è¡ŒåŒæ­¥ä½œæ¥­ï¼Œæ‚¨å¿…須將「sshã€ç”¨æˆ¶ç«¯
新增至 PATH 環境變數並正確地設定,æ‰èƒ½é€£ç·šè‡³
é ç«¯ä¸»æ©Ÿ (亦å³å·²è¨­å®šç§å¯†/公開金鑰)。
範例:
cm ^sync default@localhost:8087 ^git git://localhost/repository
== CMD_DESCRIPTION_TRIGGER ==
å¯è®“使用者管ç†è§¸ç™¼å™¨ã€‚
== CMD_USAGE_TRIGGER ==
用法:
cm ^trigger | ^tr <命令> [é¸é …]
命令:
^create | ^mk
^delete | ^rm
^edit
^list | ^ls
^showtypes
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^trigger <命令> --^usage
cm ^trigger <命令> --^help
== CMD_HELP_TRIGGER ==
範例:
cm ^tr ^mk ^before-mklabel new "/path/to/script" --^server=myserver:8084
cm ^tr ^edit ^before-mklabel 7 --^position=4 --^server=myserver:8084
cm ^tr ^ls ^before-mkbranch --^server=myserver:8084
cm ^tr ^rm ^after-setselector 4
cm ^tr ^showtypes
== CMD_DESCRIPTION_TUBE ==
執行 Plastic Tube 的相關命令。
== CMD_USAGE_TUBE ==
用法:
cm ^tube ^config -^u=<使用者> -^p=<密碼>
(å°‡ Unity VCS 設定為使用 Plastic Tube æ­é…指定的使用者和
密碼。)
cm ^tube ^create <é ç«¯ä½¿ç”¨è€…>
(建立 "é ç«¯ä½¿ç”¨è€… -> 我的使用者" Tube。
"我的使用者" 使用者å¯è®“ "é ç«¯ä½¿ç”¨è€…" 連線至 "我的使用者" 伺æœå™¨ã€‚
å¯å»ºç«‹å¾ž "é ç«¯ä½¿ç”¨è€…" 到 "我的使用者" 的連線。
åªèƒ½å»ºç«‹å¾žå…¶ä»–ä½¿ç”¨è€…åˆ°ç›®å‰ Tube 使用者的 Tube。)
cm ^tube ^remove <é ç«¯ä½¿ç”¨è€…>
(移除 "é ç«¯ä½¿ç”¨è€… -> 我的使用者" Tube。)
cm ^tube ^local
(列出本地伺æœå™¨ä¸­å…±ç”¨çš„æœ¬åœ°å„²å­˜åº«ï¼Œä»¥åŠå…±ç”¨çš„
使用者。)
cm ^tube ^remote
(åˆ—å‡ºèˆ‡ç›®å‰ Tube 使用者共用的共用
é ç«¯å„²å­˜åº«ã€‚)
cm ^tube ^share <儲存庫_è¦æ ¼>[ ...]-^u=<é ç«¯ä½¿ç”¨è€…> -^a=(^pull | ^push | ^pull,^push)
(與é ç«¯ä½¿ç”¨è€…共用本地儲存庫並設定指定的
å­˜å–æ¨¡å¼ã€‚ä½¿ç”¨ç©ºæ ¼åˆ†éš”å„²å­˜åº«è¦æ ¼ã€‚)
cm ^tube ^unshare <儲存庫_è¦æ ¼>[ ...]-^u=<é ç«¯ä½¿ç”¨è€…>
–消與é ç«¯ä½¿ç”¨è€…共用本地儲存庫。使用空格
åˆ†éš”å„²å­˜åº«è¦æ ¼ã€‚)
cm ^tube ^connect
(å°‡ Unity VCS 伺æœå™¨é€£ç·šè‡³ Plastic Tube。)
cm ^tube ^disconnect
(中斷 Unity VCS 伺æœå™¨èˆ‡ Plastic Tube 的連線。)
cm ^tube ^status
(顯示 Unity VCS 伺æœå™¨æ˜¯å¦å·²é€£ç·šè‡³ Plastic Tube。)
é¸é …
-^u Tube 使用者 (plasticscm.com 使用者)。
-^p 使用者密碼。
-^a è¨­å®šå­˜å–æ¨¡å¼ã€‚
儲存庫_è¦æ ¼ å„²å­˜åº«è¦æ ¼ã€‚(使用 'cm ^help ^objectspec' 以
æ·±å…¥çž­è§£å„²å­˜åº«è¦æ ¼ã€‚)
== CMD_HELP_TUBE ==
備註:
使用 'cm ^tube' å‘½ä»¤ç®¡ç† Plastic Tube。
範例:
cm ^tube ^config -^u=ruben@codicesoftware.com -^p=rubenpassword
cm ^tube ^create pablo@codicesoftware.com
('pablo@codicesoftware.com' å¯é€£ç·šè‡³ç›®å‰çš„ Plastic Tube 使用者)
cm ^tube ^remove pablo@codicesoftware.com
cm ^tube ^local
cm ^tube ^remote
cm ^tube ^share repo@server:8087 -^u=pablo@codicesoftware.com -^a=^pull,^push
cm ^tube ^share repo@server:8087 doc@server:8087 -^u=pablo@codicesoftware.com -^a=^push
cm ^tube ^unshare repo@server:8087 -^u=pablo@codicesoftware.com
cm ^tube ^connect
cm ^tube ^disconnect
cm ^tube ^status
== CMD_DESCRIPTION_UNDOCHECKOUT ==
復原項目簽出。
== CMD_USAGE_UNDOCHECKOUT ==
用法:
cm ^undocheckout | ^unco <項目_路徑>[ ...][-^a | --^all] [--^symlink] [--^silent]
[--^machinereadable [--^startlineseparator=<分隔符號>]
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
é …ç›®_路徑 è¦å¥—用作業的項目。使用空格分隔
路徑。使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。
使用 . 將作業套用至目å‰ç›®éŒ„。
é¸é …:
-^a | --^all 復原指定項目中的所有變更。如果
項目已簽出,則會還原
簽出。如果項目已在本地修改,則會
還原修改。
--^symlink 將復原簽出作業套用至連çµï¼Œè€Œéž
套用至目標。
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^machinereadable 以易於剖æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,
指定å„行應如何起始。
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,
指定å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,
指定應如何分隔欄ä½ã€‚
== CMD_HELP_UNDOCHECKOUT ==
備註:
å¦‚æžœé …ç›®å·²ç°½å‡ºï¼Œè€Œä¸”æ‚¨ä¸æƒ³å°‡å…¶ç°½å…¥ï¼Œæ‚¨å¯ä»¥ä½¿ç”¨æ­¤å‘½ä»¤å¾©åŽŸ
簽出。檔案和資料夾皆å¯å–消
簽出。項目將更新為簽出å‰çš„狀態。
è¦æ±‚:
- 項目必須å—原始程å¼ç¢¼æŽ§åˆ¶ã€‚
- 必須簽出項目。
從 stdin 讀å–輸入:
'^undocheckout' 命令å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯
傳éžå–®ä¸€ç ´æŠ˜è™Ÿã€Œ-ã€ä¾†å®Œæˆã€‚
範例:cm ^undocheckout ^checkin -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“您使用管線指定è¦å¾©åŽŸç°½å‡ºçš„æª”æ¡ˆã€‚
範例:
dir /S /B *.c | cm ^undocheckout --^all -
(在 Windows 中,復原工作å€ä¸­æ‰€æœ‰ .c 檔案的簽出。)
範例:
cm ^undocheckout .
(復原目å‰ç›®éŒ„中的簽出。)
cm ^undocheckout file1.txt file2.txt
cm unco c:\workspace\file.txt
(å¾©åŽŸæ‰€é¸æª”案的簽出。)
cm ^unco -^a file1.txt
(復原 'file1.txt' 的簽出或本地修改)
cm ^unco é€£çµ --^symlink
(å°‡å¾©åŽŸç°½å‡ºä½œæ¥­å¥—ç”¨è‡³é€£çµæª”æ¡ˆï¼Œè€Œä¸æ˜¯å¥—用至目標;
此功能é©ç”¨æ–¼ UNIX 環境。)
cm ^status --^short --^changelist=暫止_待_檢閱 | cm ^undocheckout -
(復原用戶端變更清單。
以上命令會列出å為
'暫止_å¾…_檢閱' è®Šæ›´æ¸…å–®ä¸­çš„è·¯å¾‘ï¼Œä¸”æ­¤è·¯å¾‘æ¸…å–®æœƒé‡æ–°å°Žå‘至
復原簽出命令的輸入。)
cm ^unco .--^machinereadable
(復原目å‰ç›®éŒ„中的簽出,並以
ç°¡åŒ–ã€æ˜“於剖æžçš„æ ¼å¼åˆ—å°çµæžœã€‚)
cm ^unco .--^machinereadable --^startlineseparator=">" --^endlineseparator="<" \
--^fieldseparator=","
(復原目å‰ç›®éŒ„中的簽出,並以簡化且易於剖æžçš„æ ¼å¼
列å°çµæžœã€èµ·å§‹è¡Œå’Œçµå°¾è¡Œï¼Œä»¥åŠä½¿ç”¨
指定的字串來分隔欄ä½ã€‚)
== CMD_DESCRIPTION_UNDOCHECKOUTUNCHANGED ==
復原未變更的已簽出項目。
== CMD_USAGE_UNDOCHECKOUTUNCHANGED ==
用法:
cm ^uncounchanged | ^unuc <項目_路徑>[ ...][-^R | -^r | --^recursive]
[--^symlink] [--^silent]
é …ç›®_路徑 è¦å¥—用作業的項目。使用空格分隔
路徑。使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。
使用 . 將作業套用至目å‰ç›®éŒ„。
é¸é …:
-^R 以éžè¿´æ–¹å¼å¾©åŽŸæŒ‡å®šè·¯å¾‘ä¸­æœªè®Šæ›´çš„é …ç›®ã€‚
--^symlink 將復原簽出未變更的作業套用至連çµï¼Œè€Œä¸æ˜¯
套用至目標。
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
== CMD_HELP_UNDOCHECKOUTUNCHANGED ==
備註:
æ­¤å‘½ä»¤æœƒå¾žå·¥ä½œå€æ ¹ç›®éŒ„以éžè¿´çš„æ–¹å¼å¥—用。
從 stdin 讀å–輸入:
'^uncounchanged' 命令å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯
傳éžå–®ä¸€ç ´æŠ˜è™Ÿã€Œ-ã€ä¾†å®Œæˆã€‚
範例:cm ^uncounchanged -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“您使用管線指定è¦å¾©åŽŸç°½å‡ºçš„æœªè®Šæ›´
檔案。
範例:
dir /S /B *.c | cm ^uncounchanged -
(在 Windows 中,復原工作å€ä¸­æ‰€æœ‰æœªè®Šæ›´ .c 檔案上的
簽出。)
範例:
cm ^uncounchanged .-^R
(在目å‰ç›®éŒ„上以éžè¿´æ–¹å¼å¾©åŽŸæœªè®Šæ›´æª”æ¡ˆçš„ç°½å‡ºã€‚)
cm ^unuc /首é /我的使用者/我的工作å€/專案/範本 -^R
(在所é¸ç›®éŒ„上以éžè¿´æ–¹å¼å¾©åŽŸæœªè®Šæ›´æª”æ¡ˆçš„ç°½å‡ºã€‚)
== CMD_DESCRIPTION_UNDELETE ==
å–æ¶ˆåˆªé™¤ä½¿ç”¨ç‰¹å®šä¿®è¨‚的項目。
== CMD_USAGE_UNDELETE ==
用法:
cm ^undelete <ä¿®è¨‚è¦æ ¼> <路徑>
ä¿®è¨‚è¦æ ¼ 將在工作å€ä¸­è¼‰å…¥ä¹‹å…§å®¹çš„
ä¿®è¨‚çš„è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
ä»¥æ·±å…¥çž­è§£ä¿®è¨‚è¦æ ¼ã€‚)
路徑 還原路徑。
== CMD_HELP_UNDELETE ==
備註:
è¦å–æ¶ˆåˆªé™¤çš„é …ç›®ä¸æ‡‰å·²è¼‰å…¥å·¥ä½œå€ä¸­ã€‚
xlink 䏿”¯æ´ '^undelete' 作業。
範例:
cm ^undelete ^revid:756 C:\mywks\src\foo.c
cm ^undelete ^itemid:68#^cs:2 C:\mywks\dir\myfile.pdf
cm ^undelete ^serverpath:/src#^br:/main C:\mywks\Dir
== CMD_DESCRIPTION_UNDOCHANGE ==
復原路徑上的變更。
== CMD_USAGE_UNDOCHANGE ==
用法:
cm ^undochange | ^unc <項目_路徑>[ ...][-^R | -^r | --^recursive]
é …ç›®_路徑 è¦å¥—用作業的項目。使用空格分隔
路徑。使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。
使用 . 將作業套用至目å‰ç›®éŒ„。
é¸é …:
-^R 以éžè¿´çš„æ–¹å¼å¥—用作業。
== CMD_HELP_UNDOCHANGE ==
備註:
å¦‚æžœé …ç›®å·²ç°½å‡ºæˆ–ä¿®æ”¹ï¼Œä½†æœªç°½å…¥ï¼Œè€Œä¸”æ‚¨ä¸æƒ³
將其簽入,您å¯ä»¥ä½¿ç”¨æ­¤å‘½ä»¤å¾©åŽŸè®Šæ›´ã€‚é …ç›®
將更新為之å‰çš„內容。
從 stdin 讀å–輸入:
'^undochange' 命令å¯å¾ž stdin 讀å–路徑。若è¦åŸ·è¡Œæ­¤æ“作,å¯
傳éžå–®ä¸€ç ´æŠ˜è™Ÿã€Œ-ã€ä¾†å®Œæˆã€‚
範例:cm ^undochange -
將讀å–路徑,直到輸入空白行為止。
這å¯è®“您使用管線指定è¦å¾©åŽŸè®Šæ›´çš„æª”æ¡ˆã€‚
範例:
dir /S /B *.c | cm ^undochange -
(在 Windows 中,復原工作å€ä¸­æ‰€æœ‰ .c 檔案的變更。)
範例:
cm ^unc .
(復原目å‰ç›®éŒ„上的檔案變更。)
cm ^undochange .-^R
(以éžè¿´æ–¹å¼å¾©åŽŸç›®å‰ç›®éŒ„上的檔案變更。)
cm ^unc file1.txt "file 2.txt"
(å¾©åŽŸæ‰€é¸æª”案的變更。)
cm ^unc c:\workspace\file.txt
(å¾©åŽŸæ‰€é¸æª”案的變更。)
== CMD_DESCRIPTION_UNDO ==
復原工作å€ä¸­çš„變更。
== CMD_USAGE_UNDO ==
用法:
cm ^undo [<路徑>[ ...]] [--^symlink] [-^r | --^recursive] [<篩é¸>[ ...]]
[--^silent | --^machinereadable [--^startlineseparator=<分隔符號>]
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
路徑 è¦å¥—用作用的目標檔案或目錄的
路徑。使用雙引號 (" ") 指定å«ç©ºæ ¼çš„
路徑。使用空格分隔路徑。
如果未指定路徑,復原作業é è¨­æœƒ
使用目å‰ç›®éŒ„中的
所有檔案。
ç¯©é¸ å°‡æŒ‡å®šçš„ä¸€æˆ–å¤šå€‹ç¯©é¸å¥—用至指定的
路徑。使用空格分隔篩é¸ã€‚如需詳細資訊,請åƒé–±
<篩é¸ï¼žä¸€ç¯€ã€‚
é¸é …:
--^symlink 將復原作業套用至符號連çµï¼Œè€Œä¸æ˜¯
套用至目標。
-^r 以éžè¿´æ–¹å¼åŸ·è¡Œå¾©åŽŸã€‚
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^machinereadable 以易於剖æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„行應如何起始。
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,指定
å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,指定
應如何分隔欄ä½ã€‚
篩é¸ï¼š
如果未指定標誌,會ä¾é è¨­å¾©åŽŸæ‰€æœ‰è®Šæ›´ï¼Œä½†
å¯ä½¿ç”¨ä¸‹åˆ—一或多個標誌篩é¸è·¯å¾‘。
如果檔案或目錄符åˆä¸€æˆ–多個指定的變更類型,
將會復原所述之檔案或目錄上的所有變更。
例如,如果您指定 '--^checkedout' 和 '--^moved',若檔案
已簽出且移動,則會復原這兩項變更。
--^checkedout é¸å–已簽出的檔案和目錄。
--^unchanged é¸å–未變更內容的檔案。
--^changed é¸å–已本地變更或簽出的檔案和
目錄。
--^deleted é¸å–已刪除的檔案和目錄。
--^moved é¸å–已移動的檔案和目錄。
--^added é¸å–已新增的檔案和目錄。
== CMD_HELP_UNDO ==
備註:
'^undo' 命令具有å±éšªæ€§ - 它會以無法回復的方å¼å¾©åŽŸå·¥ä½œã€‚
^undo 作業完æˆå¾Œï¼Œå‰‡ç„¡æ³•復原å—其影響的檔案和
目錄的先å‰ç‹€æ…‹ã€‚如果未在引數中
指定路徑,é è¨­å°‡å¾©åŽŸç›®å‰ç›®éŒ„中的所有變更,
但䏿˜¯ä»¥éžè¿´æ–¹å¼é€²è¡Œã€‚
é€™äº›ç­‰åŒæ–¼å¾ž /src 目錄執行:
/src
|- file.txt
|- code.cs
\- /test
|- test_a.py
\- test_b.py
cm ^undo
cm ^undo *
cm ^undo file.txt code.cs /test
cm ^undo .
cm ^undo /src file.txt code.cs
è‹¥è¦ä»¥éžè¿´çš„æ–¹å¼é€²è¡Œä½œæ¥­ï¼Œæ‚¨å¿…須指定 '-^r' 標誌。
復原目錄下的所有變更 (包括影響到
目錄本身的變更):
cm ^undo 目錄路徑 -^r
如果目錄路徑是工作å€è·¯å¾‘,將會復原工作å€ä¸­çš„
所有變更。
已刪除的項目:
è‹¥è¦å¾©åŽŸæª”æ¡ˆå’Œç›®éŒ„åˆªé™¤ä½œæ¥­ï¼Œæ‚¨å¿…é ˆæŒ‡å®šé …ç›®çš„
完整路徑,或指定包å«çš„目錄並使用éžè¿´ ('-^r')
標誌。
例如:
cm ^undo .
(ä¸å¾©åŽŸç›®å‰ç›®éŒ„中的刪除作業。)
cm ^undo .-^r
(以éžè¿´æ–¹å¼å¾©åŽŸç›®å‰ç›®éŒ„中的所有刪除作業 (和其他變更)。)
cm ^undo src/file.txt
(復原 src/file.txt 的刪除作業 (或其他變更)。)
範例:
cm ^undo .-^r
(以éžè¿´æ–¹å¼å¾©åŽŸç›®å‰ç›®éŒ„中的所有變更。如果已從
工作å€çš„æ ¹ç›®éŒ„執行,則會復原整個工作å€ä¸­çš„æ‰€æœ‰è®Šæ›´ã€‚)
cm ^co file.txt
cm ^undo file.txt
(在 'file.txt' 上復原簽出。)
^echo ^content >> file.txt
cm ^undo file.txt
(復原 'file.txt' 的本地變更。)
cm ^undo src
(復原 src 目錄åŠå…¶æª”案的變更。)
cm ^undo src/*
(復原 src 中包å«çš„æ‰€æœ‰æª”案和目錄的變更,而
完全ä¸å½±éŸ¿ src。)
cm ^undo *.cs
(復原符åˆç›®å‰ç›®éŒ„中 *.cs çš„
所有檔案或目錄的變更。)
cm ^undo *.cs -^r
(復原符åˆç›®å‰ç›®éŒ„åŠå…¶åº•下所有目錄中 *.cs çš„
所有檔案或目錄的變更。)
cm ^co file1.txt file2.txt
^echo ^content >> file1.txt
cm ^undo --^unchanged
(復原未變更 'file2.txt' 的簽出,進而忽略本地變更的
'file1.txt'。)
^echo ^content >> file1.txt
^echo ^content >> file2.txt
cm ^co file1.txt
cm ^undo --^checkedout
(復原已簽出檔案 'file1.txt' 中的變更,進而忽略 'file2.txt',因為
這個檔案並未簽出。)
cm ^add file.txt
cm ^undo file.txt
(復原新增 'file.txt' çš„å‹•ä½œï¼Œé€²è€Œä½¿å…¶å†æ¬¡æˆç‚ºç§äººæª”案。)
^rm file1.txt
^echo ^content >> file2.txt
cm ^add file3.txt
cm ^undo --^deleted --^added *
(復原 'file1.txt' 刪除動作和 'file3.txt' 新增動作,而忽略 'file2.txt'
變更。)
== CMD_DESCRIPTION_LOCK_UNLOCK ==
復原鎖定伺æœå™¨ä¸Šçš„項目鎖定。
== CMD_USAGE_LOCK_UNLOCK ==
用法:
cm ^lock ^unlock [<儲存庫伺æœå™¨è¦æ ¼>] <GUID>[ ...]
儲存庫伺æœå™¨è¦æ ¼ 儲存庫伺æœå™¨è¦æ ¼ã€‚(使用 'cm ^help ^objectspec'
以深入瞭解儲存庫伺æœå™¨è¦æ ¼ã€‚)
GUID è¦å°éŽ–çš„ GUID 項目清單。使用空格
分隔 GUID。
== CMD_HELP_LOCK_UNLOCK ==
備註:
- 此命令會使用指定的伺æœå™¨ä¾†è§£é™¤éŽ–å®šé …ç›®ã€‚
- 如果未指定伺æœå™¨ï¼Œæ­¤å‘½ä»¤æœƒå˜—試從目å‰å·¥ä½œå
å–得伺æœå™¨ã€‚
- 如果未在上述步驟中計算伺æœå™¨ï¼Œå‰‡æœƒå¾žç›®å‰ Unity VCS
用戶端組態å–得伺æœå™¨ã€‚
- åªæœ‰ä¼ºæœå™¨ç®¡ç†å“¡æ‰èƒ½åŸ·è¡Œ 'cm ^unlock' 命令。
- è‹¥è¦æŒ‡å®š GUIDï¼Œæ ¼å¼æ‡‰ç‚º 32 使•¸ä¸¦ä»¥é€£å­—號格å¼
分隔 (å¯é¸æ“‡æ˜¯å¦è¦åŠ ä¸Šæ‹¬è™Ÿ):
{00000000-0000-0000-0000-000000000000}
或 00000000-0000-0000-0000-000000000000
範例:
cm ^lock ^unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
(復原所é¸é …目鎖定。)
cm ^lock ^unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 \
bcb98a61-2f62-4309-9a26-e21a2685e075
(復原å為 'DIGITALIS' 的鎖定伺æœå™¨ä¸Šæ‰€é¸çš„項目鎖定。)
cm ^lock ^unlock tardis@cloud 4740c4fa-56af-3dfe-de10-8711fa248635 \
71263c17-5eaf-5271-4d2c-a25f72e101d4
(復原å為 'tardis' 的雲端鎖定伺æœå™¨ä¸Šæ‰€é¸çš„項目鎖定。)
== CMD_DESCRIPTION_UPDATE ==
更新工作å€ä¸¦ä¸‹è¼‰æœ€æ–°è®Šæ›´ã€‚
== CMD_USAGE_UPDATE ==
用法:
cm ^update [<項目_路徑> | --^last]
[--^changeset=<è®Šæ›´é›†è¦æ ¼>] [--^cloaked] [--^dontmerge] [--^forced]
[--^ignorechanges] [--^override] [--^recursewk] [--^skipchangedcheck]
[--^silent] [--^verbose] [--^xml[=<輸出_檔案>]] [--^encoding=<å稱>]
[--^machinereadable [--^startlineseparator=<分隔符號>]
[--^endlineseparator=<分隔符號>] [--^fieldseparator=<分隔符號>]]
[--^forcedetailedprogress]
é …ç›®_路徑 è¦æ›´æ–°çš„路徑。
使用 . 將更新套用至目å‰ç›®éŒ„。
如果未指定路徑,則會完全更新
ç›®å‰å·¥ä½œå€ã€‚
--^last 進行更新å‰ï¼Œå°‡å·¥ä½œå€é¸æ“‡å™¨å¾žè®Šæ›´é›†
組態或標籤組態變更為
分支組態。
鏿“‡å™¨å·²è®Šæ›´ç‚ºè®Šæ›´é›†æˆ–
標籤所屬的分支。
é¸é …:
--^changeset å°‡å·¥ä½œå€æ›´æ–°ç‚ºç‰¹å®šè®Šæ›´é›†ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解
è®Šæ›´é›†è¦æ ¼ã€‚)
--^cloaked åŒ…å«æ›´æ–°ä½œæ¥­ä¸­çš„隱匿項目。
如果未指定此é¸é …,將會在作業中忽略這些
隱匿的項目。
--^dontmerge è¬ä¸€æ›´æ–°ä½œæ¥­æœŸé–“éœ€è¦æ›´æ–°åˆä½µï¼Œ
則䏿œƒåŸ·è¡Œåˆä½µã€‚
--^forced å°‡é …ç›®å¼·åˆ¶æ›´æ–°è‡³é¸æ“‡å™¨ä¸­
指定的修訂。
--^ignorechanges å¦‚æžœåœ¨æ›´æ–°å·¥ä½œå€æ™‚嵿¸¬åˆ°
暫止的變更,則忽略顯示的
暫止變更警告訊æ¯ã€‚
--^override 覆寫 Unity VCS 控制範åœå¤–的已變更檔案。
將以伺æœå™¨å…§å®¹
覆寫其內容。
--^recursewk æ›´æ–°ç›®å‰è·¯å¾‘內找到的
所有工作å€ã€‚å¯ç”¨ä¾†æ›´æ–°æŒ‡å®šè·¯å¾‘中
包å«çš„æ‰€æœ‰å·¥ä½œå€ã€‚
--^skipchangedcheck é–‹å§‹å‰ï¼Œæ›´æ–°æœƒå…ˆæª¢æŸ¥å·¥ä½œå€ä¸­æ˜¯å¦æœ‰
本地變更。如果您總是在修改檔案å‰
簽出,您å¯ä»¥ä½¿ç”¨æ­¤æª¢æŸ¥åŠŸèƒ½ä¸¦
加快作業的速度。
--^silent ä¸é¡¯ç¤ºä»»ä½•輸出。
--^verbose 顯示其他資訊。
--^xml å°‡ XML æ ¼å¼çš„輸出列å°è‡³æ¨™æº–輸出。
å¯ä»¥æŒ‡å®šè¼¸å‡ºæª”案。
--^encoding 與 --^xml é¸é …æ­é…使用,指定è¦åœ¨ XML 輸出中
使用的編碼,亦å³ï¼šutf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^machinereadable 以易於剖æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,
指定å„行應如何起始。
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,
指定å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,
指定應如何分隔欄ä½ã€‚
--^forcedetailedprogress 強制顯示詳細進度,å³ä½¿åœ¨æ¨™æº–輸出
釿–°å°Žå‘的情æ³ä¸‹äº¦ç„¶ã€‚
== CMD_HELP_UPDATE ==
備註:
'^update' å‘½ä»¤åªæœƒä¸‹è¼‰æ‰€éœ€çš„æª”案。
此命令應該會執行éžè¿´ä½œæ¥­ã€‚
使用 '--^last' é¸é …時,ä¸éœ€è¦æŒ‡å®šè·¯å¾‘。
在此情æ³ä¸‹ï¼Œå°‡æ›´æ–°ç›®å‰å·¥ä½œç›®éŒ„所屬的
工作å€ã€‚
(è«‹åˆ‡è¨˜ï¼Œå¦‚æžœé¸æ“‡å™¨å…ˆå‰æŒ‡å‘變更集或標籤,指定此標誌
å¯èƒ½æœƒå°Žè‡´å·¥ä½œå€é¸æ“‡å™¨è®Šæ›´ç‚º
分支組態。)
範例:
cm ^update
(æ›´æ–°ç›®å‰å·¥ä½œå€ä¸­çš„æ‰€æœ‰é …目。)
cm ^update .
(æ›´æ–°ç›®å‰ç›®éŒ„ä»¥åŠæ‰€æœ‰ä¸‹å±¤é …目。)
cm ^update .--^forced --^verbose
(å¼·åˆ¶æ“·å–æ‰€æœ‰ä¿®è¨‚。)
cm ^update --^last
cm ^update .--^machinereadable --^startlineseparator=">"
(æ›´æ–°ç›®å‰ç›®éŒ„並以簡化ã€
易於剖æžçš„æ ¼å¼åˆ—å°çµæžœï¼Œä½¿ç”¨æŒ‡å®šçš„
字串起始行。)
== CMD_DESCRIPTION_VERSION ==
顯示目å‰ç”¨æˆ¶ç«¯ç‰ˆæœ¬è™Ÿç¢¼ã€‚
== CMD_USAGE_VERSION ==
用法:
cm ^version
== CMD_HELP_VERSION ==
== CMD_DESCRIPTION_WHOAMI ==
顯示目å‰çš„ Unity VCS 使用者。
== CMD_USAGE_WHOAMI ==
用法:
cm ^whoami
== CMD_HELP_WHOAMI ==
== CMD_USAGE_WKTREENODESTATUS ==
用法:
cm ^wktreenodestatus 路徑 1, 路徑 2, ...
== CMD_DESCRIPTION_WORKSPACE ==
å¯è®“使用者管ç†å·¥ä½œå€ã€‚
== CMD_USAGE_WORKSPACE ==
用法:
cm ^workspace | ^wk <命令> [é¸é …]
命令:
^list | ^ls
^create | ^mk
^delete | ^rm
^move | ^mv
^rename
è‹¥è¦å–å¾—æ¯å€‹å‘½ä»¤çš„詳細資訊,請執行:
cm ^workspace <命令> --^usage
cm ^workspace <命令> --^help
== CMD_HELP_WORKSPACE ==
範例:
cm ^workspace ^create myWorkspace 工作å€_路徑
cm ^workspace ^list
cm ^workspace ^delete myWorkspace
== CMD_DESCRIPTION_WORKSPACE_CREATE ==
建立新工作å€ã€‚
== CMD_USAGE_WORKSPACE_CREATE ==
用法:
cm ^workspace | ^wk [^create | ^mk] <工作å€_å稱> <工作å€_路徑> [<儲存庫_è¦æ ¼>]
[--^selector[=<鏿“‡å™¨_檔案>]
(建立新工作å€ã€‚)
cm ^workspace | ^wk [^create | ^mk] <工作å€_å稱> <工作å€_路徑> --^dynamic --^tree=[<樹狀目錄>]
(建立動態工作å€ã€‚此功能ä»å±¬å¯¦é©—性質,且
僅é©ç”¨æ–¼ Windows。)
工作å€_å稱 新工作å€å稱。
工作å€_路徑 新工作å€çš„路徑。
儲存庫_è¦æ ¼ 使用指定的儲存庫建立新工作å€ã€‚
å„²å­˜åº«è¦æ ¼ï¼šæŸ¥çœ‹ 'cm ^help ^objectspec'。
é¸é …:
--^selector 編輯新工作å€çš„鏿“‡å™¨ã€‚
å¦‚æžœå·²æŒ‡å®šé¸æ“‡å™¨æª”案,則會從指定的檔案設定
新工作å€çš„鏿“‡å™¨ã€‚
--^dynamic 建立動態工作å€ã€‚此功能ä»å±¬
實驗性質,且僅é©ç”¨æ–¼ Windows。
指定此標誌需è¦ä½¿ç”¨ --^tree åƒæ•¸ã€‚
--^tree 與 '--^dynamic' 標誌æ­é…使用,指定
動態工作å€å³å°‡é€²è¡Œè¼‰å…¥çš„åˆå§‹é»žã€‚這å¯ç‚º
分支ã€è®Šæ›´é›†æˆ–æ¨™ç±¤è¦æ ¼ã€‚
工作å€ç¨å¾Œå°‡ä½¿ç”¨è¦æ ¼ä¸­çš„
儲存庫。(使用 'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
== CMD_HELP_WORKSPACE_CREATE ==
備註:
- å·¥ä½œå€æ˜¯å°æ‡‰è‡³æœ¬åœ°æª”案系統之儲存庫的檢視畫é¢ã€‚
工作å€é¸æ“‡å™¨æœƒå®šç¾©æŒ‡å®šå·¥ä½œå€å…§å®¹çš„è¦å‰‡ã€‚
使用 'cm ^showselector' 顯示工作å€é¸æ“‡å™¨ï¼Œæˆ–使用 'cm ^setselector'
進行修改。
- 如果未指定 '儲存庫_è¦æ ¼' 或 '--^selector'',則會自動將工作å
設定為使用 client.conf 檔案中已設定之伺æœå™¨çš„第一個儲存庫
(ä¾å­—æ¯é †åº)。
- å‹•æ…‹å·¥ä½œå€æ˜¯å¯¦é©—性質的功能 (åƒ…é™ Windows),且
需è¦åŸ·è¡Œ plasticfs.exe 程å¼ã€‚
範例:
cm ^workspace ^create myworkspace c:\workspace
cm ^wk ^mk myworkspace /home/john/plastic_view
(分別在 Windows å’Œ Linux 中建立 'myworkspace' 工作å€ã€‚)
cm ^wk mywktest c:\wks\wktest --^selector=myselector.txt
(使用 'myselector.txt' æª”æ¡ˆä¸­çš„é¸æ“‡å™¨ï¼Œå»ºç«‹ 'mywktest' 工作å€ã€‚)
cm ^wk mywkprj c:\wks\wkprj myrep@^repserver:localhost:8084
(使用所é¸å„²å­˜åº«å»ºç«‹ 'mywkprj' 工作å€ã€‚)
cm ^wk mywkprj c:\dynwks\mywkprj --^dynamic --^tree=^br:/main@myrep@localhost:8084
(使用 'myrep@localhost:8084'
儲存庫建立動態 'mywkprj' 工作å€ï¼Œåœ¨ç¬¬ä¸€æ¬¡è£è¼‰æ™‚æŒ‡å‘ '^br:/main'。)
== CMD_DESCRIPTION_WORKSPACE_DELETE ==
刪除工作å€ã€‚
== CMD_USAGE_WORKSPACE_DELETE ==
用法:
cm ^workspace | ^wk ^delete | ^rm [<工作å€_路徑> | <工作å€è¦æ ¼>] [--^keepmetadata]
工作å€_路徑 è¦åˆªé™¤çš„工作å€è·¯å¾‘。
工作å€è¦æ ¼ è¦åˆªé™¤çš„工作å€è¦æ ¼ã€‚(使用
'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
é¸é …:
--^keepmetadata 䏿œƒåˆªé™¤ .plastic
資料夾中的中繼資料檔案。
== CMD_HELP_WORKSPACE_DELETE ==
備註:
æ­¤å‘½ä»¤æœƒåˆªé™¤è·¯å¾‘æˆ–è¦æ ¼æ‰€æŒ‡å®šçš„工作å€ã€‚
如果未指定引數,將直接使用目å‰å·¥ä½œå€ã€‚
範例:
cm ^workspace ^delete
(移除目å‰å·¥ä½œå€ã€‚)
cm ^wk ^delete c:\workspace
cm ^workspace rm /home/danipen/wks
cm ^wk ^rm ^wk:MiWorkspace
cm ^wk ^rm ^wk:MiWorkspace@DIGITALIS
== CMD_DESCRIPTION_WORKSPACE_LIST ==
列出工作å€ã€‚
== CMD_USAGE_WORKSPACE_LIST ==
用法:
cm ^workspace | ^wk [^list | ^ls] [--^format=<字串_æ ¼å¼>]
é¸é …:
--^format ä»¥æŒ‡å®šçš„æ ¼å¼æ“·å–輸出訊æ¯ã€‚如需
詳細資訊,請åƒé–±å‚™è¨»ã€‚
== CMD_HELP_WORKSPACE_LIST ==
備註:
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—串以顯示輸出。
æ­¤å‘½ä»¤çš„è¼¸å‡ºåƒæ•¸å¦‚下所示:
{0} | {^wkname} 工作å€å稱。
{1} | {^machine} 用戶端機器å稱。
{2} | {^path} 工作å€è·¯å¾‘。
{3} | {^wkid} 工作å€å”¯ä¸€è­˜åˆ¥ç¢¼ã€‚
{4} | {^wkspec} 使用此格å¼çš„工作å€è¦æ ¼ï¼š
'wkname@machine'。
{^tab} æ’入定ä½å­—元空格。
{^newline} æ’入新行。
範例:
cm ^wk
(列出所有工作å€ã€‚)
cm ^workspace ^list --^format={0}#{3,40}
cm ^workspace ^list --^format={^wkname}#{^wkid,40}
(列出所有工作å€ä¸¦é¡¯ç¤ºå·¥ä½œå€å稱ã€# 符號和
40 å€‹ç©ºæ ¼çš„å·¥ä½œå€ GUID 欄ä½ï¼Œé å·¦å°é½Šã€‚)
cm ^wk --^format="路徑 {2} ä¸­çš„å·¥ä½œå€ {0}"
cm ^wk --^format="路徑 {^path} ä¸­çš„å·¥ä½œå€ {^wkname}"
(列出所有工作å€ä¸¦ä»¥æ ¼å¼åŒ–字串的形å¼é¡¯ç¤ºçµæžœã€‚)
== CMD_DESCRIPTION_WORKSPACE_MOVE ==
移動工作å€ã€‚
== CMD_USAGE_WORKSPACE_MOVE ==
用法:
cm ^workspace | ^wk ^move | ^mv [<工作å€è¦æ ¼>] <æ–°_路徑>
é¸é …:
工作å€è¦æ ¼ è¦ç§»å‹•的工作å€è¦æ ¼ã€‚(使用
'cm ^help ^objectspec' ä»¥æ·±å…¥çž­è§£è¦æ ¼ã€‚)
æ–°_路徑 將移動至此處的工作å€ã€‚
== CMD_HELP_WORKSPACE_MOVE ==
備註:
此命令å¯è®“使用者將工作å€ç§»å‹•至ç£ç¢Ÿä¸Šçš„å¦ä¸€å€‹ä½ç½®ã€‚
範例:
cm ^workspace ^move myWorkspace \new\workspaceDirectory
(å°‡ 'myWorkspace' 移動至指定的ä½ç½®ã€‚)
cm ^wk ^mv c:\users\maria\wkspaces\newlocation
(將目å‰å·¥ä½œå€ç§»å‹•至新ä½ç½®ã€‚)
== CMD_DESCRIPTION_WORKSPACE_RENAME ==
釿–°å‘½å工作å€ã€‚
== CMD_USAGE_WORKSPACE_RENAME ==
用法:
cm ^workspace | ^wk ^rename [<工作å€_å稱>] <æ–°_å稱>
工作å€_å稱 è¦é‡æ–°å‘½å的工作å€ã€‚
æ–°_å稱 工作å€çš„æ–°å稱。
== CMD_HELP_WORKSPACE_RENAME ==
備註:
æ­¤å‘½ä»¤æœƒé‡æ–°å‘½å工作å€ã€‚
如果未æä¾›å·¥ä½œå€å稱,則會使用目å‰å·¥ä½œå€ã€‚
範例:
cm ^workspace ^rename mywk1 wk2
(å°‡ 'mywk1' 工作å€é‡æ–°å‘½å為 'wk2'。)
cm ^wk ^rename æ–°å稱
(將目å‰å·¥ä½œå€é‡æ–°å‘½å為 'æ–°å稱'。)
== CMD_DESCRIPTION_WORKSPACESTATUS ==
顯示工作å€ä¸­çš„變更。
== CMD_USAGE_WORKSPACESTATUS ==
用法:
cm ^status [<工作å€_路徑>] [--^changelist[=<å稱>] | --^changelists] [--^cutignored]
[ --^header] [ --^noheader] [ --^nomergesinfo] [ --^head]
[--^short] [--^symlink] [ --^dirwithchanges] [--^xml[=<輸出_檔案>]]
[--^encoding=<å稱>] [ --^wrp | --^wkrootrelativepaths]
[--^fullpaths | --^fp] [<舊版_é¸é …>] [<æœå°‹_類型>[ ...]]
[--^machinereadable [--^startlineseparator=分隔符號]
[--^endlineseparator=分隔符號] [--^fieldseparator=分隔符號]]
é¸é …:
工作å€_路徑 將執行æœå°‹ä¹‹å·¥ä½œå€çš„
路徑。
--^changelist 顯示所é¸è®Šæ›´æ¸…單中的變更。
--^changelists 顯示用戶端變更清單中的分組變更。
--^cutignored è·³éŽå·²å¿½ç•¥ç›®éŒ„的內容。
éœ€è¦ '--^ignored' æœå°‹é¡žåž‹ã€‚如需詳細資訊,請åƒé–±ï¼œæœå°‹
類型>一節。
--^header åªåˆ—å°å·¥ä½œå€ç‹€æ…‹ã€‚
--^noheader åªåˆ—å°å·²ä¿®æ”¹çš„é …ç›®æœå°‹çµæžœã€‚
--^nomergesinfo ä¸åˆ—å°è®Šæ›´çš„åˆä½µè³‡è¨Šã€‚
--^head 列å°åˆ†æ”¯ä¸Šæœ€å¾Œä¸€å€‹è®Šæ›´é›†çš„狀態。
--^short åªåˆ—出包å«è®Šæ›´çš„路徑。
--^symlink 將作業套用至符號連çµï¼Œè€Œä¸æ˜¯å¥—用至
目標。
--^dirwithchanges 顯示其中包å«è®Šæ›´çš„目錄
(其中的已新增ã€å·²ç§»å‹•和已移除項目)。
--^xml å°‡ XML æ ¼å¼çš„輸出列å°è‡³æ¨™æº–輸出。
å¯ä»¥æŒ‡å®šè¼¸å‡ºæª”案。
--^pretty Prints workspace changes in a nice table format.
--^encoding 與 --^xml é¸é …æ­é…使用,指定è¦åœ¨ XML 輸出中
使用的編碼,亦å³ï¼šutf-8。
è«‹åƒé–± MSDN 文件 (ç¶²å€ç‚º
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
),以å–得坿”¯æ´ä¹‹ç·¨ç¢¼åŠå…¶æ ¼å¼çš„表格
(在é å°¾çš„ [å稱] 欄中)。
--^wrp 列å°å·¥ä½œå€æ ¹ç›®éŒ„相å°è·¯å¾‘,而éž
ç›®å‰ç›®éŒ„相å°è·¯å¾‘。
--^fullpaths, --^fp 強制列å°çµ•å°è·¯å¾‘,覆寫任何其他
路徑列å°è¨­å®šã€‚
--^machinereadable 以易於剖æžçš„æ ¼å¼è¼¸å‡ºçµæžœã€‚
--^startlineseparator æ­é… '--^machinereadable' 標誌使用,
指定å„行應如何起始。
--^endlineseparator æ­é… '--^machinereadable' 標誌使用,
指定å„è¡Œæ‡‰å¦‚ä½•çµæŸã€‚
--^fieldseparator æ­é… '--^machinereadable' 標誌使用,
指定應如何分隔欄ä½ã€‚
舊版é¸é …:
--^cset 以舊版格å¼åˆ—å°å·¥ä½œå€ç‹€æ…‹ã€‚
--^compact 以舊版格å¼åˆ—å°å·¥ä½œå€ç‹€æ…‹å’Œ
變更清單。
--^noheaders 與 '--^compact' 標誌æ­é…使用時,
䏿œƒåˆ—å°è®Šæ›´æ¸…單。(䏿œƒå¥—用
至新變更清單格å¼ã€‚)
æœå°‹é¡žåž‹ï¼š
--^added 列å°å·²æ–°å¢žçš„項目。
--^checkout 列å°å·²ç°½å‡ºçš„項目。
--^changed 列å°å·²è®Šæ›´çš„項目。
--^copied 列å°å·²è¤‡è£½çš„項目。
--^replaced 列å°å·²å–代的項目。
--^deleted 列å°å·²åˆªé™¤çš„項目。
--^localdeleted 列å°å·²åœ¨æœ¬åœ°åˆªé™¤çš„項目。
--^moved 列å°å·²ç§»å‹•的項目。
--^localmoved 列å°å·²åœ¨æœ¬åœ°ç§»å‹•的項目。
--^percentofsimilarity=<值> è‹¥è¦å°‡å…©å€‹æª”案視為相åŒé …目,兩個檔案之間的
相似性百分比。å¯ç”¨æ–¼
已在本地移動的æœå°‹ã€‚å…¶é è¨­
值為 20%。
--^txtsameext 在已移動項目æœå°‹æœŸé–“,
相似性內容比å°ç¨‹åº
åªæœƒå°‡å…·æœ‰ç›¸åŒå‰¯æª”åçš„
文字檔案ç´å…¥è€ƒé‡ã€‚根據é è¨­ï¼Œå°‡è™•ç†æ‰€æœ‰
文字檔案。
--^binanyext 在已移動項目æœå°‹æœŸé–“,
相似性內容比å°ç¨‹åº
æœƒå°‡æ‰€æœ‰äºŒé€²ä½æª”案ç´å…¥è€ƒé‡ã€‚根據é è¨­ï¼Œ
åªæœƒè™•ç†å…·æœ‰ç›¸åŒ
副檔åçš„äºŒé€²ä½æª”案。
--^private 列å°éžå—控項目。
--^ignored 列å°å·²å¿½ç•¥çš„項目。
--^hiddenchanged 列å°éš±è—的已變更項目。(包括
'--^changed')
--^cloaked 列å°å·²éš±åŒ¿çš„項目。
--^controlledchanged 此標誌會替代下列é¸é …:
'--^added'ã€'--^checkout'ã€'--^copied'ã€
'--^replaced'ã€'--^deleted'ã€'--^moved'。
--^all 此標誌會å–ä»£ä¸‹åˆ—åƒæ•¸ï¼š
'--^controlledchanged'ã€'--^changed'ã€
'--^localdeleted'ã€'--^localmoved'ã€'--^private'。
== CMD_HELP_WORKSPACESTATUS ==
備註:
'^status' 命令會列å°å·¥ä½œå€ä¸Šå·²è¼‰å…¥çš„變更集,並å–å¾—
工作å€å…§å·²è®Šæ›´çš„元素。
此命令å¯ç”¨ä¾†é¡¯ç¤ºå·¥ä½œå€ä¸­æš«æ­¢çš„變更;
å¯ä½¿ç”¨å‘½ä»¤åƒæ•¸æœå°‹å’Œä¿®æ”¹çš„
變更類型。é è¨­æœƒé¡¯ç¤ºæ‰€æœ‰è®Šæ›´ï¼Œç„¡è«–æ˜¯å—æŽ§
或本地變更。
已在本地移動的æœå°‹å¯ä½¿ç”¨ç›¸ä¼¼æ€§ç™¾åˆ†æ¯”åƒæ•¸ '--^percentofsimilarity' (-^p),
決定兩個元素是å¦ç‚ºç›¸åŒçš„項目。
é è¨­å€¼ç‚º 20%,但您å¯èª¿æ•´æ­¤å€¼ã€‚
å¯ä»¥é¡¯ç¤ºä¾ç”¨æˆ¶ç«¯è®Šæ›´æ¸…單分組的工作å€è®Šæ›´ã€‚
'^default' 變更清單包å«
其他變更清單中未包å«çš„變更。也就是說,é è¨­è®Šæ›´æ¸…單顯示的內容
將喿±ºæ–¼æŒ‡å®šçš„æœå°‹é¡žåž‹æ¨™èªŒã€‚
è‹¥è¦é¡¯ç¤ºä¾è®Šæ›´æ¸…單分組的變更,則也需è¦é¡¯ç¤º
å—æŽ§è®Šæ›´ (狀態等於 '^added'ã€'^checkout'ã€'^copied'ã€
'^replaced'ã€'^deleted' 或 '^moved' 的項目)。因此,顯示變更清單時,
將自動啟用 '--^controlledchanged' é¸é …。
XML 輸出的é è¨­ç·¨ç¢¼ç‚º utf-8。
根據é è¨­ï¼Œé™¤éžæŒ‡å®š '--^machinereadable' 或 '--^short' 標誌,
å¦å‰‡æ­¤å‘½ä»¤å°‡åˆ—å°ç›®å‰ç›®éŒ„相å°è·¯å¾‘。如果
已指定其中任何一種標誌,此命令將列å°çµ•å°è·¯å¾‘。
如果已指定 '--^xml' 標誌,將列å°å·¥ä½œå€æ ¹ç›®éŒ„
相å°è·¯å¾‘ (除éžä¹Ÿå·²æŒ‡å®š '--^fp' 標誌,改為列å°
絕å°è·¯å¾‘)。
範例:
cm ^status
(列å°å·¥ä½œè®Šæ›´é›†ä»¥åŠå·¥ä½œå€ä¸­æ‰€æœ‰å·²è®Šæ›´çš„項目類型
,但已忽略的項目除外。)
cm ^status --^controlledchanged
(列å°å·¥ä½œè®Šæ›´é›†ä»¥åŠå·²ç°½å‡ºã€å·²æ–°å¢žã€
已複製ã€å·²å–代ã€å·²åˆªé™¤å’Œå·²ç§»å‹•的項目。)
cm ^status --^added
ªåˆ—å°å·¥ä½œè®Šæ›´é›†ä»¥åŠå·¥ä½œå€å…§å·²æ–°å¢žçš„項目。)
cm ^status c:\workspaceLocation\code\client --^added
(以éžè¿´æ–¹å¼åˆ—å°å·¥ä½œè®Šæ›´é›†ä»¥åŠæŒ‡å®šè·¯å¾‘下已新增的
項目。)
cm ^status --^changelists
cm ^status --^changelist
(顯示ä¾ç”¨æˆ¶ç«¯è®Šæ›´æ¸…單分組的所有工作å€è®Šæ›´ã€‚)
cm ^status --^changelist=暫止_待_檢閱
(顯示å為 '暫止_å¾…_檢閱' 的變更清單上的變更)
cm ^status --^changelist=é è¨­ --^private
(顯示 'é è¨­' 變更清單中的變更,顯示ç§äººé …目,以åŠ
嫿œ‰å—控變更的項目 (如果有的話)。)
cm ^status --^short --^changelist=暫止_待_檢閱 | cm ^checkin -
(簽入 '暫止_待_檢閱' 變更清單中的變更。)
cm ^status C:\workspaceLocation --^xml=output.xml
–å¾— XML æ ¼å¼çš„狀態資訊並在
output.xml 檔案中使用 utf-8。)
cm ^status --^ignored
(顯示所有已忽略的項目。)
輸出:
/main@myrepo@local (^cs:2 - ^head)
^Added
狀態 å¤§å° ä¸Šæ¬¡ä¿®æ”¹ 路徑
^Ignored 0 ä½å…ƒçµ„ 19 ç§’é˜ä¹‹å‰ out\app.exe
^Ignored 48 ç§’é˜ä¹‹å‰ src
^Ignored 0 ä½å…ƒçµ„ 48 ç§’é˜ä¹‹å‰ src\version.c
cm ^status --^ignored --^cutignored
(顯示未忽略上層目錄的已忽略檔案,以åŠå·²å¿½ç•¥çš„
目錄但ä¸é¡¯ç¤ºå…¶å…§å®¹ã€‚)
輸出:
/main@myrepo@local (^cs:2 - ^head)
^Added
狀態 å¤§å° ä¸Šæ¬¡ä¿®æ”¹ 路徑
^Ignored 0 ä½å…ƒçµ„ 19 ç§’é˜ä¹‹å‰ out\app.exe
^Ignored 48 ç§’é˜ä¹‹å‰ src
== CMD_DESCRIPTION_XLINK ==
建立ã€ç·¨è¼¯æˆ–顯示 Xlink 的詳細資料。
== CMD_USAGE_XLINK ==
用法:
cm ^xlink [-^w] [-^rs] <xlink_路徑> / (<è®Šæ›´é›†è¦æ ¼> | <æ¨™ç±¤è¦æ ¼> | <åˆ†æ”¯è¦æ ¼)>
[<æ“´å……_è¦å‰‡>[ ...]]
(建立 Xlink。)
cm ^xlink [-^rs] <xlink_路徑> /<相å°_路徑> (<è®Šæ›´é›†è¦æ ¼> | <æ¨™ç±¤è¦æ ¼> | <åˆ†æ”¯è¦æ ¼>)
[<æ“´å……_è¦å‰‡>[ ...]]
(å»ºç«‹æŒ‡å‘ /<相å°_路徑> 而éž
é è¨­æ ¹ç›®éŒ„ / 的唯讀局部 Xlink。)
cm ^xlink -^e <xlink_路徑> (<è®Šæ›´é›†è¦æ ¼> | <æ¨™ç±¤è¦æ ¼> | <åˆ†æ”¯è¦æ ¼>)
(編輯 Xlink ä»¥è®Šæ›´ç›®æ¨™è¦æ ¼ã€‚)
cm ^xlink -^s|--^show <xlink_路徑>
(顯示 Xlink 資訊,包括擴充è¦å‰‡ã€‚)
cm ^xlink -^ar|--^addrules <xlink_路徑> <æ“´å……_è¦å‰‡>[ ...]
(將指定的擴充è¦å‰‡æ–°å¢žè‡³ Xlink)。
cm ^xlink -^dr|--^deleterules <xlink_路徑> <æ“´å……_è¦å‰‡>[ ...]
(從 Xlink 中移除指定的擴充è¦å‰‡)。
Xlink_路徑 這是目å‰å·¥ä½œå€ä¸­
å°‡è£è¼‰ (建立
Xlink 時) 或已è£è¼‰ (編輯 Xlink 時) 連çµå„²å­˜åº«çš„æ‰€åœ¨ç›®éŒ„。
è®Šæ›´é›†è¦æ ¼ é ç«¯å„²å­˜åº«ä¸­çš„完整目標變更集
è¦æ ¼ã€‚
這å¯åˆ¤æ–·æœƒåœ¨é€£çµå„²å­˜åº«çš„工作å€ä¸­è¼‰å…¥
哪個版本和分支。
(使用 'cm ^help ^objectspec' 以深入瞭解變更集
è¦æ ¼ã€‚)
æ¨™ç±¤è¦æ ¼ é ç«¯å„²å­˜åº«ä¸­çš„å®Œæ•´æ¨™ç±¤è¦æ ¼ã€‚
(使用 'cm ^help ^objectspec' 以深入瞭解標籤
è¦æ ¼ã€‚)
åˆ†æ”¯è¦æ ¼ é ç«¯å„²å­˜åº«ä¸­çš„å®Œæ•´åˆ†æ”¯è¦æ ¼ã€‚
這會使用指定分支指å‘çš„
ç›®å‰è®Šæ›´é›†ã€‚(使用 'cm ^help ^objectspec'
æ·±å…¥çž­è§£åˆ†æ”¯è¦æ ¼ã€‚)
-^e ç·¨è¼¯ç¾æœ‰ Xlink 以變更目標變更集
è¦æ ¼ã€‚
-^s | --^show é¡¯ç¤ºé—œæ–¼æ‰€é¸ Xlink 的資訊。
-^ar | --^addrules 將一或多個擴充è¦å‰‡æ–°å¢žè‡³æ‰€é¸ Xlink。
-^dr | --^deleterules å¾žæ‰€é¸ Xlink 刪除一或多個擴充
è¦å‰‡ã€‚
æ“´å……_è¦å‰‡ 指定一或多個擴充è¦å‰‡ã€‚æ¯å€‹æ“´å……
è¦å‰‡éƒ½æ˜¯ä¸€çµ„分支目標分支:
^br:/main/fix-^br:/main/develop/fix
é¸é …:
-^w 代表 Xlink 為å¯å¯«å…¥çš„狀態。這表示
å¯é€éŽåˆ†æ”¯è‡ªå‹•擴充修改
目標儲存庫內容。
-^rs 相å°ä¼ºæœå™¨ã€‚æ­¤é¸é …å¯å…許建立
ç¨ç«‹æ–¼å„²å­˜åº«ä¼ºæœå™¨ä¹‹å¤–çš„ç›¸å° Xlink。如此
一來,將會自動識別ä¸åŒä¼ºæœå™¨çš„複寫
儲存庫中建立的 Xlink。
== CMD_HELP_XLINK ==
備註:
æ­¤å‘½ä»¤æœƒå°æŒ‡å®šçš„變更集建立 Xlink。ä¾é è¨­æœƒå»ºç«‹å”¯è®€
Xlink。這表示無法修改 Xlink 的工作å€ä¸­
載入的內容。若è¦åœ¨
Xlink 內容中進行變更,則須改為建立å¯å¯«å…¥çš„ Xlink (使用 '-^w' é¸é …)。
編輯 Xlink 的目標變更集時,å¯ä»¥ä½¿ç”¨ç°¡åŒ–çš„
命令語法。如此一來,唯一需è¦çš„åƒæ•¸å°±æ˜¯
æ–°ç›®æ¨™è®Šæ›´é›†ã€‚å°‡ä¸æœƒä¿®æ”¹å…¶é¤˜çš„ Xlink
åƒæ•¸ã€‚
分支自動擴充:
在任何å¯å¯«å…¥ Xlink 儲存庫中進行變更時 ('-^w' é¸é …),必須在目標
儲存庫中建立新分支。新分支
çš„å稱是根據最上層儲存庫中定義的
ç°½å‡ºåˆ†æ”¯ã€‚è‹¥è¦æ±ºå®šè¦ä½¿ç”¨çš„分支å稱,以下是é©ç”¨çš„è¦å‰‡ï¼š
1) 執行檢查,確èªç›®æ¨™å„²å­˜åº«ä¸­æ˜¯å¦å­˜åœ¨
具有相åŒå®Œæ•´å稱的分支:
- 如果存在,這會用來åšç‚ºç°½å‡ºåˆ†æ”¯ã€‚
- 如果ä¸å­˜åœ¨ï¼ŒæœƒæŒ‰ç…§ä¸‹åˆ—æ–¹å¼å»ºç«‹åˆ†æ”¯å稱:
- 目標 Xlink 變更集的分支å稱 + 簽出分支的
簡短å稱 (最後的部分)。
- 如果此分支存在,則會用來åšç‚ºç°½å‡ºåˆ†æ”¯ã€‚
- å¦å‰‡ï¼Œå‰‡æœƒå»ºç«‹åˆ†æ”¯ï¼Œä¸”分支基底會設定為
Xlink 變更集。
2) æœƒåœ¨æŒ‡å‘ Xlink 儲存庫之新變更集的上層儲存庫的
分支上建立新版 Xlink。
最後,會ä¿ç•™æœ€æ–°ç‰ˆæœ¬çš„完整 Xlink çµæ§‹ï¼Œä¸¦åŒ…å«é©ç•¶
版本中的最新變更。
範例:
cm ^xlink code\firstrepo / 1@first@localhost:8084
(在目å‰å·¥ä½œå€çš„ 'firstrepo' 資料夾中建立 Xlink,其中
將會è£è¼‰å„²å­˜åº« 'first' 中的變更集 '1'。)
cm ^xlink opengl\include /includes/opengl 1627@includes@localhost:8087
(在目å‰å·¥ä½œå€çš„目錄 'opengl\include' 中建立唯讀
局部 Xlink,其中儲存庫 'includes' 的變更集 '1627' 中的路徑 '/includes/opengl'
å°‡è£è¼‰ç‚ºæ ¹ç›®éŒ„。這表示無論
'/includes/opengl' 中的內容是什麼,都會è£è¼‰åœ¨ 'opengl\include' 中,而
儲存庫的其餘項目則將予以忽略。)
cm ^xlink -^w -^rs code\secondrepo / ^lb:LB001@second@localhost:8084
(在目å‰å·¥ä½œå€çš„資料夾 'secondrepo' 中建立å¯å¯«å…¥
且相å°çš„ Xlink,其中將è£è¼‰å„²å­˜åº« 'second' çš„
標籤 'LB001'。)
cm ^xlink code\thirdrepo / 3@third@localhost:8087 ^br:/main-^br:/main/scm003
(在目å‰å·¥ä½œå€çš„ 'thirdrepo' 資料夾中建立 Xlink,其中
將會è£è¼‰å„²å­˜åº« 'third' 中的變更集 '3'。)
cm ^xlink -^e code\secondrepo ^br:/main/task1234@second@localhost:8084
(編輯 Xlink 'code\secondrepo',在儲存庫 'second'
中連çµåˆ†æ”¯ 'main/task1234' 以變更目標儲存庫。)
cm ^xlink --^show code\thirdrepo
(顯示 Xlink 'code\thirdrepo' 的資訊,包括其擴充
è¦å‰‡ (如果有的話))。
cm ^xlink -^ar code\secondrepo ^br:/main-^br:/main/develop ^br:/main/fix-^br:/main/develop/fix
(將兩個擴充è¦å‰‡æ–°å¢žè‡³ xlink 'code\secondrepo'。)
cm ^xlink -^dr code\secondrepo ^br:/main/fix-^br:/main/develop/fix
(從 xlink ' code\secondrepo' 中刪除擴充è¦å‰‡)。
== CMD_USAGE_AUTOCOMPLETE ==
用法:
cm ^autocomplete ^install
(å°‡ 'cm' 命令完æˆå®‰è£åœ¨ Shell 中。)
cm ^autocomplete ^uninstall
(從 Shell ä¸­è§£é™¤å®‰è£ 'cm' 命令完æˆã€‚)
cm ^autocomplete --^line <shell_行> --^position <滑鼠_ä½ç½®>
(讓 'shell_行' 的自動完æˆå»ºè­°å›žåˆ°æ’入於
'滑鼠_ä½ç½®'。此命令並éžå°ˆä¾›æœ€çµ‚使用者使用,
但ä»è¨˜è¼‰æ–¼æ–‡ä»¶ä¸­ï¼Œä»¥é˜²æ‚¨æƒ³è¦ç‚ºæ‚¨é¸æ“‡çš„ Shell æ“´å……
è‡ªå‹•å®Œæˆæ”¯æ´ã€‚)
shell_行 ä½¿ç”¨è€…å·²åœ¨è¦æ±‚è‡ªå‹•å®Œæˆæ™‚
寫入 Shell 的文字行。
在 Bash ä¸­ï¼Œé€™ä½æ–¼ COMP_LINE 環境變數中。
在 PowerShell ä¸­ï¼Œé€™ä½æ–¼ $wordToComplete 變數中。
滑鼠_ä½ç½® è¦æ±‚è‡ªå‹•å®Œæˆæ™‚çš„
滑鼠ä½ç½®ã€‚
在 Bash ä¸­ï¼Œé€™ä½æ–¼ COMP_POINT 環境變數中。
在 PowerShell ä¸­ï¼Œé€™ä½æ–¼ $cursorPosition 變數中。
== CMD_DESCRIPTION_CONFIGURECLIENT ==
Configures the Unity VCS client for the current machine user to work with a default server.
== CMD_USAGE_CONFIGURECLIENT ==
用法:
cm ^configure [--^language=<language> --^workingmode=<mode> [AuthParameters]
--^server=<server> [--^port=<port>]] [--^clientconf=<clientconfpath>]
--^language å¯ç”¨çš„語言:
en (English)
es (Spanish)
--^workingmode å¯ç”¨çš„使用者/安全性工作模å¼:
NameWorkingMode (Name)
NameIDWorkingMode (Name + ID)
LDAPWorkingMode (LDAP)
ADWorkingMode (Active Directory)
UPWorkingMode (User and password)
SSOWorkingMode (Single Sign On)
AuthParameters é©—è­‰åƒæ•¸ (僅é©ç”¨æ–¼ ^LDAPWorkingMode å’Œ ^UPWorkingMode):
--^user=<user>
--^password=<password>
Single Sign On parameters (only for ^SSOWorkingMode):
--^user=<user>
--^token=<token>
--^server Unity VCS server IP / address
--^port Unity VCS server port
(port optional for Cloud servers)
--^clientconf 用來建立設定檔案的檔案路徑 (é¸ç”¨)
引數å¯ä»¥æ˜¯å®Œæ•´çš„è·¯å¾‘ã€æª”案å稱或目錄。
範例:
--^clientconf=c:/path/to/myclient.conf
(將使用指定的路徑來建立用戶端設定檔案)
--^clientconf=myclient.conf
(將使用é è¨­è¨­å®šç›®éŒ„內的檔案 myclient.conf)
--^clientconf=c:/exisitingDirectory
(將使用指定目錄中的é è¨­æª”案å稱 client.conf)
== CMD_HELP_CONFIGURECLIENT ==
備註:
The cm ^configure command cannot be used on Cloud Edition or DVCS Edition of Unity VCS.
Use 'plastic --configure' instead.
範例:
cm ^configure
(runs the interactive Unity VCS client configuration command)
cm ^configure --^language=^en --^workingmode=^LDAPWorkingMode --^user=^jack --^password=^01234 \
--^server=^plastic.mymachine.com --^port=^8084
(configures the Unity VCS client with the specified parameters and creates the 'client.conf'
configuration file in the default directory).
(Cloud 伺æœå™¨çš„é¸ç”¨é€£æŽ¥åŸ )
cm ^configure --^language=^en --^workingmode=^NameWorkingMode --^server=^plastic.mymachine.com \
--^port=^8084 --^clientconf=^clientconf_exp.conf
(configures the Unity VCS client with the specified parameters and creates the 'client.conf'
configuration file in the specified path).