ArenosWebDev/arenos-nexus
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity
2e704cae70
arenos-nexus/Arenos Nexus/Library/PackageCache/com.unity.collab-proxy@ab839cc7d2ad/Lib/Editor/Localization/cm-help.zh-Hans.txt

8068 lines
302 KiB
Plaintext
Raw Normal View History

init Init Commit Unity
2025-09-25 22:01:28 +02:00
== 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_命令> [--^repository=<名称>]
SQL_命令 要执行的 SQL 查询。
选项：
--^repository 要查询的存储库。
== CMD_HELP_QUERY ==
备注：
此命令允许用户在服务器数据库中执行 SQL 查询。
为了编写 SQL 查询，请使用以下两个预定义的函数来管理
用户和路径：
- '^SolveUser(<用户名>)'，将用户名解析为 Unity VCS 格式。
- '^SolvePath(<路径>)'，将磁盘路径解析为项 ID。
== CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
删除一个或多个属性。
== CMD_USAGE_ATTRIBUTE_DELETE ==
用法：
cm ^attribute | ^att ^delete | ^rm <属性规格>[ ...]
属性规格 要删除的属性。使用空格对各个属性进行
分隔。
（使用 'cm ^help ^objectspec' 可进一步了解属性
规格。）
== CMD_HELP_ATTRIBUTE_DELETE ==
备注：
此命令将删除一个或多个属性。
示例：
cm ^attribute ^delete ^att: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_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).
（Cloud 服务器的可选端口）
Reference in New Issue Copy Permalink