Files
SpaceDroid/Droid 2/Library/Artifacts/24/24ddc7ae5510e84311ff92f4484a169f
T

8191 lines
309 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-Hans== 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
继承:
继承是 Plastic SCM 3.0 时期的一ç§é€‰é¡¹ã€‚
这是高级选项,但几乎已弃用。
该选项å…许对象从任何其他对象继承æƒé™ï¼Œ
从而覆盖默认的继承关系。
使用选项 -^cut 切断继承链。
使用选项 -^cutncpy 切断并å¤åˆ¶å½“å‰ç»§æ‰¿çš„
æƒé™ã€‚(这个选项å—到 Windows 文件系统æƒé™çš„å¯å‘,
在 Windows 文件系统中å¯ä»¥åˆ‡æ–­ç»§æ‰¿å…³ç³»ä½†ä¿ç•™å®žé™…æƒé™ã€‚)
-^inherit 选项å…许用户从对象规格继承。
示例:'-^inherit=对象规格'
示例:
cm ^acl --^user=danipen -^denied=+^ci ^rep:core
(拒ç»ç”¨æˆ· 'danipen' 在存储库 'core' 上签入。)
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' 匹é…的任何路径,
该命令拒ç»å‘ 'devs' 组授予签入æƒé™ã€‚创建标记 '#rel'
是为了ç¨åŽèƒ½å¤Ÿè¿›è¡Œå¼•用。)
cm ^acl ^path:/server#rel --^branches=-/main,+/main/Rel2.1
(更新具有 'rel' 标记的安全路径 '/server',
删除 'main' 分支,并将分支 'main/Rel2.1' 添加到
安全路径所应用到的分支组。就å‰é¢çš„示例而言,
çŽ°åœ¨åˆ†æ”¯åˆ—è¡¨å°†åŒ…å« 'main/Rel2.1' å’Œ 'main/2.0'。)
cm ^acl --^user=vsanchezm -^allowed=-^read -^overrideallowed=+^read ^path:/doc
(删除授æƒç»™ 'vsanchezm' çš„ '^read' æƒé™ï¼Œåœ¨ '/doc' 路径中对其进行覆盖。)
== 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 è¦ä½¿ç”¨çš„ 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 显示æœåС噍åªè¯»æ¨¡å¼çжæ€ã€‚
选项:
æœåС噍 在指定æœåŠ¡å™¨ï¼ˆæœåС噍:端å£ï¼‰ä¸­æ‰§è¡Œå‘½ä»¤ã€‚(使用
'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}"
ï¼ˆä¾æ¬¡å†™å…¥ owner 字段ã€ä¸€ä¸ªç©ºæ ¼ã€date 字段(å³å¯¹é½ï¼‰ã€
ä¸€ä¸ªç©ºæ ¼ä»¥åŠ content 字段。)
cm ^blame c:\workspace\file.txt --^format="{^owner, -7} {^comment} {^date}" \
--^dateformat=yyyyMMdd
ï¼ˆä¾æ¬¡å†™å…¥ owner 字段(å ç”¨ 7 个空格,左对é½ï¼‰ã€
一个空格ã€comment 字段ã€å¦ä¸€ä¸ªç©ºæ ¼ä»¥åŠç»“尾的
æ ¼å¼åŒ–日期(例如,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
ï¼ˆå°†å˜æ›´é›† 2 中 myfile.pdf 的修订存档在 'c:\archived_files'
文件夹中。存档的文件å将以 '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 <å˜æ›´é›†è§„æ ¼> <分支规格>
选项:
å˜æ›´é›†è§„æ ¼ è¦ç§»åŠ¨åˆ°å¦ä¸€ä¸ªåˆ†æ”¯çš„ç¬¬ä¸€ä¸ªå˜æ›´é›†ã€‚All
åŒä¸€åˆ†æ”¯ä¸­çš„æ‰€æœ‰åŽä»£å˜æ›´é›†ä¹Ÿå°†ä½œä¸º
该命令的目标。
(使用 '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=pending_to_review | cm ^checkin -
(列出å为 'pending_to_review' 的更改列表中的路径,并将此列表
é‡å®šå‘到 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
(签出所有文本文件。)
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 触å‘器:创建 Web 触å‘器的方法是键入 "^webtrigger <目标-URI>"
作为触å‘å™¨å‘½ä»¤ã€‚åœ¨è¿™ç§æƒ…况下,触å‘器将针对指定的 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,则返回 GUID)。
è¦ç¼–辑或删除现有代ç å®¡æŸ¥ï¼Œå¿…é¡»æä¾›ç›®æ ‡ä»£ç 
审查 ID(或 GUID)。如果没有错误,则ä¸ä¼šæ˜¾ç¤ºä»»ä½•消æ¯ã€‚
状æ€å‚æ•°åªèƒ½æ˜¯ä»¥ä¸‹å€¼ä¹‹ä¸€ï¼š^"Under review"
(默认值)ã€^"Reviewed" 或 ^"Rework required"。
repository 傿•°å¯ç”¨äºŽè®¾ç½®é»˜è®¤çš„工作
存储库。当用户想è¦åœ¨å…¶ä»–æœåŠ¡å™¨ä¸Šè€Œä¸æ˜¯åœ¨ä¸Žå½“å‰å·¥ä½œåŒº
å…³è”çš„æœåŠ¡å™¨ä¸Šç®¡ç†å®¡æŸ¥æ—¶ï¼Œæˆ–者根本没有
当å‰å·¥ä½œåŒºæ—¶ï¼Œæ­¤å‚数很有用。
输出格å¼è‡ªå®šä¹‰ï¼š
æ­¤å‘½ä»¤æŽ¥å—æ ¼å¼å­—符串以显示输出。
æ­¤å‘½ä»¤çš„è¾“å‡ºå‚æ•°å¦‚下:
{0} ID
{1} GUID
请注æ„,'--^format' 傿•°ä»…在创建新的代ç 
审查时生效。
示例:
cm ^codereview ^cs:1856@myrepo@myserver:8084 "我的代ç å®¡æŸ¥" --^assignee=dummy
cm ^codereview ^br:/main/task001@myrepo@myserver:8084 "我的代ç å®¡æŸ¥" \
--^status=^"Rework required" --^assignee=newbie --^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,因为没有目标修订。
对于 Xlink,'^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} 行。"
(检索已格å¼åŒ–的差异比较指标结果。)
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
(将本地æœåŠ¡å™¨ä¸­çš„å­˜å‚¨åº“ 'repo' 以 Git 快速导出格å¼
ä»Žå˜æ›´é›† '20' 导出到 '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 å°† fileinfo æ“作应用于符å·é“¾æŽ¥è€Œä¸æ˜¯
目标。
--^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 是å¦
是相对 Xlink。
^IsXlink é¡¹æœ¬èº«æ˜¯å¦æ˜¯ Xlink。
^XlinkTarget 项指å‘的目标存储库(如果项
是 Xlink)。
^XlinkName 项的 Xlink å称(如果项实际上
是 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 ==
备注:
如果未指定存储库,则在工作区中é…置的存储库上
进行æœç´¢ã€‚
从命令行中使用比较è¿ç®—符(>ã€<ã€>=ã€<=)
è¿è¡ŒæŸ¥è¯¢æ—¶ï¼Œè¯·æ³¨æ„,shell 将这些è¿ç®—符视为 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 æœåŠ¡å™¨æ–­å¼€è¿žæŽ¥çš„æƒ…å†µä¸‹ï¼Œæ­¤å‘½ä»¤å¯¹äºŽæ£€æµ‹
已更改的文件很有用。å¯ä»¥å°†è¾“出通过管é“传递到 checkout 命令,
从而在ç¨åŽæ£€æŸ¥æ›´æ”¹ï¼ˆè¯·å‚阅示例)。
示例:
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 将开始从当å‰ç›®å½•
æœç´¢ã€‚
此命令适åˆç”¨äºŽåœ¨æ–‡ä»¶å¤¹ä¸Šæ·»åŠ ç§æœ‰é¡¹ï¼Œå¹¶å°†è¾“出通过管é
传递到 add 命令。请å‚阅示例。
示例:
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 表示在网络测试中传输的
用户数æ®é‡ï¼ˆä»¥å…†å­—节为å•ä½ï¼‰ï¼Œ
例如 "^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}å˜æ›´é›† {^changesetid} 创建于 {^date}ï¼›{^tab} 已更改项:{^items}。"
--^itemformat="{^newline}分支 {^branch} 中的项 {^path} 已更改。"
示例:
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 从活动的工作区选择器获å–内容。
如果已指定选择器格å¼ï¼Œåˆ™åˆ—出
指定的选择器。
自 Plastic SCM 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 对指定分支执行“åˆå¹¶åˆ°â€æ“作
(通过输入分支规格)
并完全解决冲çªã€‚
“åˆå¹¶åˆ°â€ï¼ˆæˆ–无工作区的åˆå¹¶ï¼‰æ˜¯åœ¨
æœåŠ¡å™¨ç«¯è¿›è¡Œçš„åˆå¹¶ã€‚正常的åˆå¹¶
å‘生在“从â€åˆ†æ”¯ã€æ ‡ç­¾æˆ–å˜æ›´é›†åˆå¹¶çš„
工作区上,而“åˆå¹¶åˆ°â€å®Œå…¨å‘生
在æœåŠ¡å™¨ä¸Šã€‚åœ¨æ­£å¸¸åˆå¹¶ä¸­ï¼Œ
â€œç›®æ ‡â€æ˜¯å·¥ä½œåŒºï¼Œè€Œåœ¨â€œåˆå¹¶åˆ°â€ä¸­ï¼Œ
必须始终指定目标(这就是称之为
“到â€çš„原因)。
请查看以下链接以了解关于
“åˆå¹¶åˆ°â€åŠŸèƒ½çš„æ›´å¤šä¿¡æ¯ï¼š
https://www.plasticscm.com/download/help/mergeto
--^shelve 使用åˆå¹¶ç»“果的更改(加上åˆå¹¶
å¯è¿½æº¯æ€§ä¿¡æ¯ï¼‰æ¥åˆ›å»ºä¸€ä¸ªæç½®ï¼Œ
è€Œä¸æ˜¯åˆ›å»ºæ–°çš„å˜æ›´é›†ã€‚åˆå¹¶æºä¸º
æç½®æ—¶ï¼Œæ­¤é€‰é¡¹ä¸å¯ç”¨ã€‚该选项
ä»…å¯ç”¨äºŽæœåŠ¡å™¨ç«¯åˆå¹¶
(åˆç§°ä¸ºâ€œåˆå¹¶åˆ°â€ï¼‰ã€‚å› æ­¤ï¼Œéœ€è¦ '--^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
è¦å®šä¹‰åˆå¹¶æºï¼Œå¯ä»¥ä½¿ç”¨ä»¥ä¸‹è§„格:
- 分支规格:
[^br:/]br_name
示例:^br:/main/task001
(以上示例从此分支上的最åŽä¸€ä¸ªå˜æ›´é›†æ‰§è¡Œåˆå¹¶ã€‚)
- 标签规格:
^lb:lb_name
示例:^lb:BL001
ï¼ˆä»Žæ ‡è®°çš„å˜æ›´é›†åˆå¹¶ã€‚)
- å˜æ›´é›†è§„格:
^cs:cs_number
示例:^cs:25
ï¼ˆä»Žç»™å®šçš„å˜æ›´é›†å†…容åˆå¹¶ã€‚)
- æç½®è§„格:
^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=bin_dst ^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',新分支的基项
将是父分支上的最åŽä¸€ä¸ªå˜æ›´é›†ã€‚如果新分支
æ˜¯é¡¶çº§åˆ†æ”¯ï¼Œåˆ™ä½¿ç”¨çš„åŸºç¡€å˜æ›´é›†å°†ä¸ºå˜æ›´é›† 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="我的注释"
(在存储库 'myrep@myserver:8084' 中,创建 'task001' 分支
作为 '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
(在当å‰å·¥ä½œåŒºçš„存储库中删除å为 'task001' 分支
('main' çš„å­çº§ï¼‰ã€‚)
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 触å‘器:创建 Web 触å‘器的方法是键入 "^webtrigger <目标-URI>"
作为触å‘å™¨å‘½ä»¤ã€‚åœ¨è¿™ç§æƒ…况下,触å‘器将针对指定的 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 myNewLabel ^cs:42
('^create' 命令是å¯é€‰å‘½ä»¤ã€‚)
cm ^label ^rename myNewLabel newLabelName
cm ^label ^delete newLabelName
== 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 修订规格" 命令)。
-- 存储库æœåŠ¡å™¨è§„æ ¼ --
^repserver:name:port
示例:
cm ^repo ^list ^repserver:skull:8084
cm ^repo ^list skull:8084
æ—æ³¨ï¼š
由于历å²åŽŸå› ï¼Œæˆ‘ä»¬ç§°ä¹‹ä¸ºâ€œå­˜å‚¨åº“æœåŠ¡å™¨è§„æ ¼â€ï¼Œè€Œä¸åªæ˜¯
“æœåŠ¡å™¨è§„æ ¼â€ã€‚很久以å‰ï¼Œæˆ‘们有å•独的工作区æœåŠ¡å™¨å’Œ
存储库æœåŠ¡å™¨ï¼Œå‘½åæ–¹å¼æ²¿ç”¨è‡³ä»Šã€‚
-- 存储库规格 --
^rep:rep_name@[存储库æœåŠ¡å™¨è§„æ ¼]
示例:
cm ^showowner ^rep:codice@localhost:6060
(此处的 "^rep:" 是必需的,因为 ^showowner ä¸ä»…容许存储库,
而且容许其他类型的对象。因此,需è¦ç”¨æˆ·æŒ‡æ˜Ž
对象类型。)
-- 分支规格 --
^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
-- 标签规格 --
^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 忽略路径中的大å°å†™ã€‚使用此标志åŽï¼Œ
å³ä½¿ç”¨æˆ·å†™å…¥ "/data/teXtures",'^configure' 也对
"/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-black.png' 以外的所有 'soft' 目录å­é¡¹ã€‚)
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 忽略路径中的大å°å†™ã€‚使用此标志åŽï¼Œå³ä½¿
用户写入 "/data/teXtures",选项 '--^configure' 也对
"/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 目录路径 -^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 设置 patch 命令的输出文件。
--^tool 设置è¦ä½¿ç”¨çš„应用程åºï¼ˆå·®å¼‚比较还是修补)。
== CMD_HELP_PATCH ==
é™åˆ¶ï¼š
å¦‚æžœè¾“å‡ºè¡¥ä¸æ–‡ä»¶å·²ç»å­˜åœ¨ï¼Œè¯¥å‘½ä»¤ä¸ä¼šè¦†ç›–这个文件。
åº”ç”¨è¡¥ä¸æ—¶ï¼Œå¦‚æžœç£ç›˜ä¸Šæ²¡æœ‰å·²ä¿®æ”¹çš„æ–‡ä»¶ï¼Œè¯¥å‘½ä»¤ä¸ä¼š
将更改应用于这些文件。
é‡è¦ä¿¡æ¯ï¼š
此命令需è¦å·®å¼‚比较工具和修补工具;å¯ä»Žä»¥ä¸‹ç½‘å€å…¬å¼€èŽ·å¾—è¿™äº›å·¥å…·ï¼š
http://gnuwin32.sourceforge.net/packages/patch.htm 和
http://gnuwin32.sourceforge.net/packages/diffutils.htm
安装åŽï¼Œå»ºè®®å°†å·¥å…·çš„ä½ç½®æ·»åŠ åˆ° PATH
环境å˜é‡ã€‚
示例:
cm ^patch ^cs:4@default@localhost:8084
(以统一格å¼åœ¨æŽ§åˆ¶å°ä¸Šæ‰“å°å˜æ›´é›† 4 的差异。)
cm ^patch ^br:/main --^output=file.patch
(使用分支 "main" 的差异æ¥ç”Ÿæˆè¡¥ä¸æ–‡ä»¶ã€‚)
cm ^patch ^br:/main --^output=file.patch --^tool=C:\gnu\diff.exe
(åŒä¸Šï¼Œä½¿ç”¨çš„æ˜¯è‡ªå®šä¹‰æ‰§è¡Œç¨‹åºã€‚)
cm ^patch ^cs:2@default ^cs:4@default
(以统一格å¼åœ¨æŽ§åˆ¶å°ä¸Šæ‰“å°å˜æ›´é›† 2 å’Œ 4 之间的差异。)
cm ^patch --^apply file.patch --^tool=C:\gnu\patch.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 将指定的列设置为 itemid 列。查询
解释器将å°è¯•将项 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:status
(删除属性 '状æ€'。)
cm ^att ^rm çŠ¶æ€ ^att:integrated@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:status ^br:/main/SCM105
(从分支 'main/SCM105' 删除属性实现 '状æ€'。)
cm ^att ^unset ^att:integrated@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:status state
(将属性 '状æ€' é‡å‘½å为 '状况'。)
== CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
编辑属性的注释。
== CMD_USAGE_ATTRIBUTE_EDIT ==
用法:
cm ^attribute | ^att ^edit <属性规格> <新注释>
属性规格 è¦æ›´æ”¹ç›¸åº”注释的属性。(使用 'cm ^help ^objectspec'
å¯è¿›ä¸€æ­¥äº†è§£å±žæ€§è§„格。)
新注释 属性的新注释。还å¯ä»¥ä¸ºå±žæ€§æŒ‡å®š
一个默认值列表。
== CMD_HELP_ATTRIBUTE_EDIT ==
备注:
此命令将更改属性的注释。
è¦æŒ‡å®šå±žæ€§çš„默认值列表,åªéœ€å°†
如下的行包å«åœ¨å±žæ€§æ³¨é‡Šä¸­ï¼š
'default: 值_一, "值二", 值3, "最终值"'。
示例:
cm ^attribute ^edit ^att:status "CI 管é“中分支的状æ€ã€‚"
(编辑属性 '状æ€' 的注释。)
cm ^attribute ^edit ^att:status "分支的状æ€ã€‚默认值:未完æˆã€å·²è§£å†³ã€å·²å®¡æŸ¥"
(编辑属性 '状æ€' 的注释。还指定一个值
列表。因此,当属性 '状æ€' 设置为对象时,å¯ä»¥é€‰æ‹©
以下值之一:"未完æˆ"ã€"已解决" 或 "已审查"。)
== 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=<密ç >] | 身份验è¯é€‰é¡¹]
(æœåŠ¡å™¨ä¹‹é—´çš„ç›´æŽ¥å¤åˆ¶ã€‚从存储库拉å–分支。)
cm ^pull <目标存储库规格> --^package=<包文件> [身份验è¯é€‰é¡¹]
(基于包的å¤åˆ¶ã€‚将包导入目标存储库中。)
cm ^pull ^hydrate <目标分支规格> [<æºå­˜å‚¨åº“è§„æ ¼>]
[--^user=<用户å> [--^password=<密ç >] | 身份验è¯é€‰é¡¹]
(为分支中先å‰ä½¿ç”¨ '--^nodata' å¤åˆ¶çš„æ‰€æœ‰å˜æ›´é›†
引入缺失的数æ®ã€‚å¦‚æžœæœªæŒ‡å®šç”¨äºŽèŽ·å–æ•°æ®çš„存储库,
Unity VCS 会å°è¯•使用“å¤åˆ¶æºâ€ï¼ˆå¤åˆ¶åˆ†æ”¯
çš„æ¥æºï¼‰ï¼‰ã€‚
cm ^pull ^hydrate <ç›®æ ‡å˜æ›´é›†è§„æ ¼> [<æºå­˜å‚¨åº“è§„æ ¼>]
[--^user=<用户å> [--^password=<密ç >] | 身份验è¯é€‰é¡¹]
(为先å‰ä½¿ç”¨ '--^nodata' å¤åˆ¶çš„å˜æ›´é›†å¼•入缺失的
æ•°æ®ã€‚å¦‚æžœæœªæŒ‡å®šç”¨äºŽèŽ·å–æ•°æ®çš„存储库,Unity VCS 会å°è¯•
使用“å¤åˆ¶æºâ€ï¼‰ã€‚
æºåˆ†æ”¯è§„æ ¼ è¦ä»Žè¿œç¨‹å­˜å‚¨åº“拉å–的分支。
(使用 'cm ^help ^objectspec' å¯è¿›ä¸€æ­¥äº†è§£åˆ†æ”¯è§„格。)
目标分支规格 è¦è¿›è¡Œ hydrate 的分支。
(使用 'cm ^help ^objectspec' å¯è¿›ä¸€æ­¥äº†è§£åˆ†æ”¯è§„格。)
ç›®æ ‡å˜æ›´é›†è§„æ ¼ è¦è¿›è¡Œ hydrate çš„å˜æ›´é›†ã€‚
(使用 '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=<转æ¢è¡¨æ–‡ä»¶>
å¦‚æžœè½¬æ¢æ¨¡å¼ä¸º 'table',则转æ¢è¡¨æ–‡ä»¶ä¸­åŒ…å«
æ ¼å¼ä¸º <æ—§åç§°;æ–°åç§°> 的行(æ¯è¡Œä¸€ä¸ªï¼‰ã€‚将分支
写入目标存储库时,æºå­˜å‚¨åº“中由“旧åç§°â€
标识的用户所创建的对象将设置到目标上
具有“新åç§°â€çš„用户。
身份验è¯é€‰é¡¹ï¼š
å¯ä»¥ä½¿ç”¨ä»¥ä¸‹ä¸¤ç§æ¨¡å¼ä¹‹ä¸€æ¥æŒ‡å®šèº«ä»½éªŒè¯æ•°æ®ï¼š
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' åˆ†æ”¯ä¸­çš„æ‰€æœ‰å˜æ›´é›†
进行 hydrate æ“作。)
cm ^pull ^hydrate ^cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
(从远程æœåŠ¡å™¨èŽ·å–æ•°æ®ï¼Œå¯¹ 'myserver' ä¸­çš„å˜æ›´é›† 122169 进行
hydrate æ“作。)
== CMD_DESCRIPTION_PUSH ==
将分支推é€åˆ°å¦ä¸€ä¸ªå­˜å‚¨åº“。
== CMD_USAGE_PUSH ==
用法:
cm ^push <æºåˆ†æ”¯è§„æ ¼> <目标存储库规格>
[--^preview] [转æ¢é€‰é¡¹]
[--^user=<用户å> [--^password=<密ç >] | 身份验è¯é€‰é¡¹]
(æœåŠ¡å™¨ä¹‹é—´çš„ç›´æŽ¥å¤åˆ¶ã€‚从存储库推é€åˆ†æ”¯ã€‚)
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=<转æ¢è¡¨æ–‡ä»¶>
å¦‚æžœè½¬æ¢æ¨¡å¼ä¸º 'table',则转æ¢è¡¨æ–‡ä»¶ä¸­åŒ…å«
æ ¼å¼ä¸º <æ—§åç§°;æ–°åç§°> 的行(æ¯è¡Œä¸€ä¸ªï¼‰ã€‚将分支
写入目标存储库时,æºå­˜å‚¨åº“中由“旧åç§°â€
标识的用户所创建的对象将设置到目标上
具有“新åç§°â€çš„用户。
身份验è¯é€‰é¡¹ï¼š
å¯ä»¥ä½¿ç”¨ä»¥ä¸‹ä¸¤ç§æ¨¡å¼ä¹‹ä¸€æ¥æŒ‡å®šèº«ä»½éªŒè¯æ•°æ®ï¼š
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=<密ç >] | 身份验è¯é€‰é¡¹]
[转æ¢é€‰é¡¹]
(存储库之间的直接克隆。)
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=<转æ¢è¡¨æ–‡ä»¶>
å¦‚æžœè½¬æ¢æ¨¡å¼ä¸º 'table',则转æ¢è¡¨æ–‡ä»¶ä¸­åŒ…å«
æ ¼å¼ä¸º <æ—§åç§°;æ–°åç§°> 的行(æ¯è¡Œä¸€ä¸ªï¼‰ã€‚将分支
写入目标存储库时,æºå­˜å‚¨åº“中由“旧åç§°â€
标识的用户所创建的对象将设置到目标上
具有“新åç§°â€çš„用户。
身份验è¯é€‰é¡¹ï¼š
å¯ä»¥ä½¿ç”¨ä»¥ä¸‹ä¸¤ç§æ¨¡å¼ä¹‹ä¸€æ¥æŒ‡å®šèº«ä»½éªŒè¯æ•°æ®ï¼š
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' 的'project' 存储库。)
== 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 private_directory
(删除 'private_directory'。)
cm ^remove ^private c:\workspace\controlled_directory
(失败,因为 'controlled_directory' å¹¶éžç§æœ‰ç›®å½•。)
cm ^remove ^private -^r c:\workspace\controlled_directory
(删除 'controlled_directory' ä¸‹çš„æ‰€æœ‰ç§æœ‰æ–‡ä»¶å’Œç›®å½•。)
cm ^rm ^private --^dry-run --^verbose c:\workspace\controlled_directory -^r
(显示 'controlled_directory' ä¸‹çš„ç§æœ‰æ–‡ä»¶è¢«åˆ é™¤æ‰€å½±å“çš„
所有路径,实际上ä¸åˆ é™¤ä»»ä½•内容。)
cm ^rm ^private --^verbose c:\workspace\controlled_directory -^r
(显示 'controlled_directory' ä¸‹çš„ç§æœ‰æ–‡ä»¶è¢«åˆ é™¤æ‰€å½±å“çš„
所有路径,并执行删除。)
== 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:status ^br:/main/SCM105 未完æˆ
(将属性 '状æ€' 设置为分支 'SCM105',值为 '未完æˆ'。)
cm ^att ^set ^att:integrated@reptest@server2:8084 ^lb:LB008@reptest@server2:8084 是
(在存储库 'reptest' 中将属性 '集æˆ' 设置为标签 'LB008',
值为 '是'。)
== CMD_DESCRIPTION_SETOWNER ==
设置对象的所有者。
== CMD_USAGE_SETOWNER ==
用法:
cm ^setowner | ^sto --^user=<用户å> | --^group=<组> <对象规格>
--^user 用户å。对象的新所有者。
--^group 组å称。对象的新所有者。
对象规格 è¦è®¾ç½®æ–°æ‰€æœ‰è€…的对象的规格。
å¯ä»¥åœ¨ä»¥ä¸‹å¯¹è±¡ä¸Šè®¾ç½®æ‰€æœ‰è€…:
存储库æœåС噍ã€å­˜å‚¨åº“ã€åˆ†æ”¯ã€å˜æ›´é›†ã€
标签ã€é¡¹ã€ä¿®è®¢å’Œå±žæ€§ã€‚
(使用 'cm ^help ^objectspec' å¯è¿›ä¸€æ­¥äº†è§£è§„格。)
== CMD_HELP_SETOWNER ==
备注:
对象的所有者å¯ä»¥æ˜¯ç”¨æˆ·æˆ–组。
å¯ä»¥åœ¨ä»¥ä¸‹å¯¹è±¡ä¸Šè®¾ç½®æ‰€æœ‰è€…:存储库æœåС噍ã€
存储库ã€åˆ†æ”¯ã€å˜æ›´é›†ã€æ ‡ç­¾ã€é¡¹ã€ä¿®è®¢å’Œå±žæ€§ã€‚
示例:
cm ^setowner --^user=john ^repserver:localhost:8084
(将 'john' 设置为存储库æœåŠ¡å™¨æ‰€æœ‰è€…ã€‚ï¼‰
cm ^sto --^group=development ^rep:mainRep@PlasticServer:8084
(将 'development' 组设置为 'mainRep' 存储库的所有者。)
== CMD_DESCRIPTION_SETSELECTOR ==
将选择器设置为工作区。
== CMD_USAGE_SETSELECTOR ==
已弃用此命令。为了å‘åŽå…¼å®¹ï¼Œæ­¤å‘½ä»¤ä»ç„¶å­˜åœ¨ï¼Œ
但是在 Plastic SCM 4.0 中,已在很大程度上弃用选择器。ä»ç„¶å­˜åœ¨çš„选择器
æ˜¯ä¸ºäº†æŒ‡å®šå·¥ä½œåˆ†æ”¯æˆ–å˜æ›´é›†ï¼Œä½†ä¸å†æ”¯æŒ
用于筛选路径的旧规则。
用法:
cm ^setselector | ^sts [--^file=<选择器文件>] [--^ignorechanges]
[--^forcedetailedprogress] [<工作区路径> | <工作区规格>]
选项:
--^file è¦ä»Žä¸­åŠ è½½é€‰æ‹©å™¨çš„æ–‡ä»¶ã€‚
--^ignorechanges 忽略在更新工作区时
检测到待定更改的情况下显示
的待定更改警告消æ¯ã€‚
--^forcedetailedprogress å³ä½¿åœ¨æ ‡å‡†è¾“出被é‡å®šå‘的情况下也è¦å¼ºåˆ¶æ˜¾ç¤º
详细进度。
工作区路径 用于设置选择器的工作区的路径。
工作区规格 工作区的规格。(使用 'cm ^help ^objectspec'
å¯è¿›ä¸€æ­¥äº†è§£å·¥ä½œåŒºè§„格。)
== CMD_HELP_SETSELECTOR ==
备注:
此命令将设置工作区的选择器。
å·¥ä½œåŒºéœ€è¦æŸäº›ä¿¡æ¯æ‰èƒ½ä»Žå­˜å‚¨åº“加载修订。
为了获得这些信æ¯ï¼Œ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=pending_to_review | cm ^shelve -
(æç½®å®¢æˆ·ç«¯æ›´æ”¹åˆ—表。
以上命令将列出å为 'pending_to_review'
的更改列表中的路径,并且路径列表将é‡å®šå‘到
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=pending_to_review | cm ^shelveset -
(æç½®å®¢æˆ·ç«¯æ›´æ”¹åˆ—表。
以上命令将列出å为 'pending_to_review'
的更改列表中的路径,并且路径列表将é‡å®šå‘到
'^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' and \
^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 中,
æ¯æ¬¡ä»Žå¤æœ¬åˆ›å»ºæ–°å¯¹è±¡æ—¶ï¼Œ
都会创建一个新的 'replicationlog'。
示例:
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 27/09/2018 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' :本月第一天的日期。
'^this ^year' :本年 1 月 1 日。
'^one ^day ^ago' ï¼šå½“å‰æ—¥æœŸå‰ä¸€å¤©ã€‚
'^one ^week ^ago' ï¼šå½“å‰æ—¥æœŸå‰ä¸ƒå¤©ã€‚
'^one ^month ^ago' ï¼šå½“å‰æ—¥æœŸå‰ä¸€ä¸ªæœˆã€‚
'n ^days ^ago' ï¼šå½“å‰æ—¥æœŸå‰ 'n' 天。
'n ^months ^ago' ï¼šå½“å‰æ—¥æœŸå‰ 'n' 个月。
'n ^years ^ago' ï¼šå½“å‰æ—¥æœŸå‰ 'n' 年。
以下 '^where' å­å¥å¯¹äºŽç±»åž‹ä¸º '^date' 的字段有效:
'(...)^where ^date > '^today' (...)'
'(...)^where ^date < '^yesterday' (...)'
'(...)^where ^date > '^this ^week' (...)'
'(...)^where ^date > '^this ^month' (...)'
'(...)^where ^date < '^one ^day ^ago' ^and ^date > '3 ^days ^ago' (...)'
'(...)^where ^date < '^one ^week ^ago' ^and ^date > '3 ^weeks ^ago' (...)'
'(...)^where ^date < '^one ^month ^ago' ^and ^date > '3 ^months ^ago' (...)'
'(...)^where ^date > '1 ^year ^ago' (...)'
还å¯ä»¥åœ¨ 'cm ^find' 命令中强制使用特定日期格å¼ï¼Œæ–¹æ³•是使用
--^dateformat 标志。请查看 'cm ^find --^help' 以了解更多详细信æ¯ã€‚
== CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
显示å¯ç”¨çš„触å‘器类型。
== CMD_USAGE_TRIGGER_SHOWTYPES ==
用法:
cm ^trigger ^showtypes
== CMD_DESCRIPTION_SHOWACL ==
显示对象的 ACL。
== CMD_USAGE_SHOWACL ==
用法:
cm ^showacl | ^sa <对象规格> [--^extended] [--^xml[=<输出文件>]]
[--^encoding=<åç§°>]
对象规格 è¦æ˜¾ç¤ºç›¸åº” ACL 的对象的规格。
此命令的有效对象为:
存储库æœåС噍ã€å­˜å‚¨åº“ã€åˆ†æ”¯ã€å˜æ›´é›†ã€æ ‡ç­¾ã€é¡¹
和属性。
(使用 'cm ^help ^objectspec' å¯è¿›ä¸€æ­¥äº†è§£è§„格。)
选项:
--^extended 显示 ACL 层次结构树。
--^xml 以 XML æ ¼å¼å°†è¾“出打å°åˆ°æ ‡å‡†è¾“出。
å¯ä»¥æŒ‡å®šè¾“出文件。
--^encoding 与 '--^xml' 选项结åˆä½¿ç”¨ï¼ŒæŒ‡å®šè¦åœ¨ XML 输出
中使用的编ç ï¼ˆä¾‹å¦‚:utf-8)。
请å‚阅ä½äºŽä»¥ä¸‹ç½‘å€çš„ MSDN 文档:
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
以查看包å«å—支æŒç¼–ç åŠå…¶æ ¼å¼çš„表格
(ä½äºŽé¡µé¢æœ«å°¾çš„“åç§°â€åˆ—中)。
== CMD_HELP_SHOWACL ==
示例:
cm ^showacl ^repserver:PlasticServer:8084
(显示所选æœåŠ¡å™¨çš„ ACL。)
cm ^sa ^br:/main --^extended
(显示所选分支规格的 ACL 层次结构树。)
== CMD_DESCRIPTION_SHOWCOMMANDS ==
显示所有å¯ç”¨å‘½ä»¤ã€‚
== CMD_USAGE_SHOWCOMMANDS ==
用法:
cm ^showcommands
== CMD_HELP_SHOWCOMMANDS ==
== CMD_DESCRIPTION_SHOWOWNER ==
显示对象的所有者。
== CMD_USAGE_SHOWOWNER ==
用法:
cm ^showowner | ^so <对象规格>
对象规格 è¦æ˜¾ç¤ºç›¸åº”所有者的对象的规格。
对象必须为下列其中之一:
存储库æœåС噍ã€å­˜å‚¨åº“ã€åˆ†æ”¯ã€å˜æ›´é›†ã€
标签ã€å±žæ€§ã€ä¿®è®¢å’Œé¡¹ã€‚
(使用 'cm ^help ^objectspec' å¯è¿›ä¸€æ­¥äº†è§£è§„格。)
== CMD_HELP_SHOWOWNER ==
备注:
此命令将显示对象的所有者。所有者å¯ä»¥æ˜¯ç”¨æˆ·æˆ–
组。å¯ä»¥ä½¿ç”¨ 'cm ^setowner' 命令修改所有者。
示例:
cm ^showowner ^repserver:PlasticServer:8084
(显示所选æœåŠ¡å™¨çš„æ‰€æœ‰è€…ã€‚ï¼‰
cm ^so ^item:samples\
(显示所选项规格的所有者。)
== CMD_DESCRIPTION_SHOWPERMISSIONS ==
列出å¯ç”¨çš„æƒé™ã€‚
== CMD_USAGE_SHOWPERMISSIONS ==
用法:
cm ^showpermissions | ^sp
== CMD_HELP_SHOWPERMISSIONS ==
示例:
cm ^showpermissions
== CMD_DESCRIPTION_SHOWSELECTOR ==
显示工作区选择器。
== CMD_USAGE_SHOWSELECTOR ==
已弃用此命令。为了å‘åŽå…¼å®¹ï¼Œæ­¤å‘½ä»¤ä»ç„¶å­˜åœ¨ï¼Œ
但是在 Plastic SCM 4.0 中,已在很大程度上弃用选择器。ä»ç„¶å­˜åœ¨çš„选择器
æ˜¯ä¸ºäº†æŒ‡å®šå·¥ä½œåˆ†æ”¯æˆ–å˜æ›´é›†ï¼Œä½†ä¸å†æ”¯æŒ
用于筛选路径的旧规则。
用法:
cm ^showselector | ^ss [<工作区路径> | <工作区规格>]
工作区路径 用于显示选择器的工作区的路径。
工作区规格 工作区的规格。(使用 'cm ^help ^objectspec' å¯
å¯è¿›ä¸€æ­¥äº†è§£å·¥ä½œåŒºè§„格。)
== CMD_HELP_SHOWSELECTOR ==
备注:
å¦‚æžœè·¯å¾„å’Œå·¥ä½œåŒºè§„æ ¼å‡æœªæŒ‡å®šï¼Œåˆ™è¯¥å‘½ä»¤å°†é‡‡ç”¨
当å‰ç›®å½•作为工作区路径。
示例:
cm ^showselector c:\workspace
(显示所选工作区路径的选择器。)
cm ^ss
(显示当å‰å·¥ä½œåŒºçš„选择器。)
cm ^showselector > mySelector.txt
(将当å‰å·¥ä½œåŒºçš„选择器写入文件。)
cm ^showselector ^wk:mywk@reptest
(显示存储库 'reptest' 中的工作区 'mywk' 的选择器。)
== CMD_DESCRIPTION_SUPPORT ==
å…许用户执行与支æŒç›¸å…³çš„æ“ä½œã€‚
== CMD_USAGE_SUPPORT ==
用法:
cm ^support <命令> [选项]
命令:
^bundle
è¦èŽ·å–æœ‰å…³æ¯æ¡å‘½ä»¤çš„æ›´å¤šä¿¡æ¯ï¼Œè¯·è¿è¡Œï¼š
cm ^support <命令> --^usage
cm ^support <命令> --^help
== CMD_HELP_SUPPORT ==
示例:
cm ^support
cm ^support ^bundle
cm ^support ^bundle c:\outputfile.zip
== CMD_DESCRIPTION_SUPPORT_BUNDLE ==
åˆ›å»ºå¸¦æœ‰ç›¸å…³æ—¥å¿—çš„â€œæ”¯æŒæ†ç»‘包â€åŒ…。
å¯ä»¥åœ¨è¯·æ±‚帮助ã€è¯¢é—®å…¶ä»–ä¿¡æ¯æˆ–者æäº¤ bug æ—¶
附加该文件。
== CMD_USAGE_SUPPORT_BUNDLE ==
用法:
cm ^support ^bundle [<输出文件>]
选项:
输出文件 在指定的ä½ç½®åˆ›å»ºâ€œæ”¯æŒæ†ç»‘包â€
包。
== CMD_HELP_SUPPORT_BUNDLE ==
备注:
此命令å…è®¸ç”¨æˆ·åˆ›å»ºä¸€ä¸ªâ€œæ”¯æŒæ†ç»‘包â€åŒ…,然åŽä¾¿å¯åœ¨è¯·æ±‚帮助ã€
è¯¢é—®å…¶ä»–ä¿¡æ¯æˆ–æäº¤ bug 时附加这个包。
用户å¯ä»¥é€‰æ‹©æŒ‡å®šè¾“出文件的ä½ç½®ï¼›å¦åˆ™ï¼Œ
输出文件将写入到临时目录。
示例:
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 switch。
用法:
cm ^switchtobranch [选项] [分支规格]
分支规格:分支的规格。
选项:
--^label=åç§° | --^changeset=æ•°å­—ï¼šä»ŽæŒ‡å®šæ ‡ç­¾æˆ–å˜æ›´é›†
加载修订。如果未æä¾›ä»»ä½•分支规格,则需è¦è¿™äº›é€‰é¡¹
之一。
--^changeset=å˜æ›´é›†ï¼šåˆ‡æ¢åˆ°æŒ‡å®šçš„å˜æ›´é›†ã€‚
--^repository=存储库:切æ¢åˆ°æŒ‡å®šçš„存储库。
--^workspace | -wk=路径:工作区所在的路径。
== 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 å°† undocheckout æ“ä½œåº”ç”¨äºŽé“¾æŽ¥è€Œä¸æ˜¯
目标。
--^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
(将 undocheckout æ“ä½œåº”ç”¨äºŽé“¾æŽ¥æ–‡ä»¶è€Œä¸æ˜¯ç›®æ ‡ï¼Œ
适用于 UNIX 环境。)
cm ^status --^short --^changelist=pending_to_review | cm ^undocheckout -
(撤销客户端更改列表。
以上命令将列出å为 'pending_to_review'
的更改列表中的路径,并且路径列表将é‡å®šå‘到
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 å°† uncounchanged æ“ä½œåº”ç”¨äºŽé“¾æŽ¥è€Œä¸æ˜¯
目标。
--^silent 䏿˜¾ç¤ºä»»ä½•输出。
== CMD_HELP_UNDOCHECKOUTUNCHANGED ==
备注:
此命令是从工作区根目录以递归方å¼åº”用的。
从 stdin 读å–输入:
'^uncounchanged' 命令å¯ä»Ž stdin 读å–路径。为此,请传递
ä¸€ä¸ªç ´æŠ˜å· "-"。
示例:cm ^uncounchanged -
路径将一直读å–到有空行输入为止。
è¿™ç§æƒ…况下å…è®¸ä½¿ç”¨ç«–çº¿æŒ‡å®šè¦æ’¤é”€ç­¾å‡ºçš„
未更改文件。
示例:
dir /S /B *.c | cm ^uncounchanged -
(在 Windows 中,撤销对工作区中所有未更改的 .c 文件
的签出。)
示例:
cm ^uncounchanged .-^R
(在当å‰ç›®å½•ä¸­ä»¥é€’å½’æ–¹å¼æ’¤é”€æœªæ›´æ”¹æ–‡ä»¶çš„签出。)
cm ^unuc /home/myuser/mywk/project/templates -^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' çš„ Cloud é”定æœåŠ¡å™¨ä¸Šçš„æ‰€é€‰é¡¹é”定。)
== 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 newname
(将当å‰å·¥ä½œåŒºé‡å‘½å为 'newname'。)
== 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=pending_to_review
(显示å为 'pending_to_review' 的更改列表中的更改。)
cm ^status --^changelist=default --^private
(显示 'default' æ›´æ”¹åˆ—è¡¨ä¸­çš„æ›´æ”¹ï¼ŒåŒ…æ‹¬ç§æœ‰é¡¹ä»¥åŠ
å…·æœ‰å—æŽ§æ›´æ”¹çš„é¡¹ï¼ˆå¦‚æžœæœ‰ï¼‰ã€‚ï¼‰
cm ^status --^short --^changelist=pending_to_review | cm ^checkin -
(签入更改列表 'pending_to_review' 中的更改。)
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
(通过链接存储库 'second' 中的分支 'main/task1234',
编辑 Xlink 'code\secondrepo' 以更改目标存储库。)
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
(在 shell 中安装 'cm' 命令补é½åŠŸèƒ½ã€‚ï¼‰
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).