forked from BilalY/Rasagar
8186 lines
307 KiB
Plaintext
8186 lines
307 KiB
Plaintext
== CMD_DESCRIPTION_ACL ==
|
||
设置对象权限。
|
||
|
||
== CMD_USAGE_ACL ==
|
||
用法:
|
||
|
||
cm ^acl (--^user=<用户名> | --^group=<组名称>)
|
||
(-^allowed|-^denied|-^overrideallowed|-^overridedenied=+|-<权限>[,...])[,...]
|
||
<对象规格>
|
||
|
||
--^user 用户名。
|
||
--^group 组名称。
|
||
-^allowed 启用指定的一项或多项权限。使用
|
||
逗号对各个权限进行分隔。(使用 'cm ^showpermissions'
|
||
可显示所有可用权限。)
|
||
-^denied 拒绝指定的一项或多项权限。使用
|
||
逗号对各个权限进行分隔。(使用 'cm ^showpermissions'
|
||
可显示所有可用权限。)
|
||
-^overrideallowed 覆盖允许的一项或多项权限。使用
|
||
逗号对各个权限进行分隔。(使用 'cm ^showpermissions'
|
||
可显示所有可用权限。)
|
||
-^overridedenied 覆盖拒绝的一项或多项权限。使用
|
||
逗号对各个权限进行分隔。(使用 'cm ^showpermissions'
|
||
可显示所有可用权限。)
|
||
对象规格 要设置权限的对象。
|
||
此命令的有效对象为:
|
||
存储库服务器、存储库、分支、变更集、标签、项
|
||
和属性。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
安全路径的特殊用法:
|
||
cm ^acl [(--^user=<用户名> | --^group=<组名称>)
|
||
(-^allowed|-^denied|-^overrideallowed|-^overridedenied=+|-<权限>[,...])[,...]]
|
||
[--^delete] [--^branches=[+ | -]<分支>[,...]]
|
||
<规格>
|
||
|
||
--^delete 删除安全路径。
|
||
请参阅“备注”以了解更多信息。
|
||
--^branches 将安全路径权限设置为一个分支组。
|
||
使用逗号对各个分支进行分隔。
|
||
(可选)每个分支前面可添加 + 或 -
|
||
符号,从而指定在编辑时必须在列表中添加
|
||
还是删除某个分支。
|
||
请参阅“备注”以了解更多信息。
|
||
规格 要设置权限的安全路径。
|
||
|
||
== CMD_HELP_ACL ==
|
||
为了配置权限,需要了解 Unity VCS 安全机制的工作原理。
|
||
请查看《安全指南》以了解权限的工作原理:
|
||
https://www.plasticscm.com/download/help/securityguide
|
||
|
||
备注:
|
||
|
||
此命令设置用户或组对于指定对象、存储库、分支、标签
|
||
和/或服务器路径的权限。
|
||
|
||
对象规格:
|
||
(使用 'cm ^help ^objectspec' 可了解如何指定对象。)
|
||
'^acl' 命令使用一种特殊类型的规格:安全路径。
|
||
|
||
- 安全路径规格:
|
||
^path:server_path[#tag]
|
||
示例:^path:/src/foo.c
|
||
^path:/doc/pdf
|
||
^path:/doc/pdf#documents
|
||
|
||
权限操作:
|
||
使用 -^allowed 和 -^denied 指定要设置的权限。
|
||
使用 -^overrideallowed 和 -^overridedenied 参数指定
|
||
要覆盖的权限。
|
||
|
||
每个操作都需要一个权限列表(以逗号分隔)。
|
||
|
||
权限名称:
|
||
每个权限名称前面都带有 + 或 - 符号。
|
||
+ 符号表示设置权限,而 - 符号表示清除权限。
|
||
要查看对象的权限,请使用 'cm ^showacl' 命令。
|
||
|
||
覆盖的权限:
|
||
使用 -^overrideallowed 和 -^overridedenied
|
||
来覆盖权限可以绕过继承。
|
||
这对于绕过在存储库或服务器级别设置的权限
|
||
很有帮助。
|
||
示例:
|
||
cm ^acl --^user=vio -^allowed=+^ci -^overrideallowed=+^ci ^br:qa@test
|
||
(允许用户 'vio' 在存储库 'test' 上的分支 'qa' 上签入,
|
||
即使该用户的权限在存储库级别被拒绝也是如此。)
|
||
|
||
服务器路径权限(又称“安全路径”):
|
||
- 允许为给定的服务器路径指定权限。
|
||
- 在签入操作期间会检查这些权限。
|
||
- 也可以在更新操作期间检查这些权限,
|
||
并可以将这些权限用作一种防止某些目录和文件
|
||
下载到工作区的方法。
|
||
- 对于要签入的每一项,服务器都会尝试将项路径
|
||
与安全路径匹配。如果匹配,则签入操作
|
||
将检查是否可以签入该项。
|
||
|
||
可为安全路径定义的权限
|
||
如下:
|
||
'^ci'、'^change'、'^add'、'^move'、'^rm'、'^read'
|
||
|
||
对于任何涉及的项,如果权限检查不成功,
|
||
则检入操作将回滚。
|
||
|
||
要将安全路径权限设置为一个分支组,请使用
|
||
--^branches 选项。
|
||
示例:
|
||
cm ^acl --^user=jo -^denied=+^ci ^path:/src#rule0 --^branches=main,main/rel0
|
||
|
||
要编辑与安全路径关联的 ACL,该标记很有用。
|
||
示例:
|
||
cm ^acl --^user=jo -^denied=+^rm ^path:/src#rule0
|
||
(如果没有标记,则需要再次指定
|
||
分支列表。)
|
||
|
||
安全路径的分支列表是可以编辑的。
|
||
示例:
|
||
cm ^acl ^path:/src#rule0 --^branches=-main,+main/rel1
|
||
(从列表中删除 'main' 并添加 'main/rel1'。)
|
||
|
||
要删除安全路径,请使用 --^delete 参数。
|
||
示例:
|
||
cm ^acl --^user=jo --^delete ^path:/src#rule0
|
||
|
||
继承:
|
||
继承是 Plastic SCM 3.0 时期的一种选项。
|
||
这是高级选项,但几乎已弃用。
|
||
该选项允许对象从任何其他对象继承权限,
|
||
从而覆盖默认的继承关系。
|
||
|
||
使用选项 -^cut 切断继承链。
|
||
使用选项 -^cutncpy 切断并复制当前继承的
|
||
权限。(这个选项受到 Windows 文件系统权限的启发,
|
||
在 Windows 文件系统中可以切断继承关系但保留实际权限。)
|
||
|
||
-^inherit 选项允许用户从对象规格继承。
|
||
示例:'-^inherit=对象规格'
|
||
|
||
示例:
|
||
|
||
cm ^acl --^user=danipen -^denied=+^ci ^rep:core
|
||
(拒绝用户 'danipen' 在存储库 'core' 上签入。)
|
||
|
||
cm ^acl --^group=developers -^allowed=+^view,-^read -^denied=+^chgperm ^br:main
|
||
(该命令向 'main' 分支中的 'developers' 组
|
||
授予查看权限、清除读取权限并拒绝 chgperm 权限。)
|
||
|
||
安全路径示例:
|
||
|
||
cm ^acl --^group=devs -^denied=+^ci ^path:/server#rel --^branches=main,main/2.0
|
||
(对于在分支 'main' 和 'main/2.0' 中与 '/server' 匹配的任何路径,
|
||
该命令拒绝向 'devs' 组授予签入权限。创建标记 '#rel'
|
||
是为了稍后能够进行引用。)
|
||
|
||
cm ^acl ^path:/server#rel --^branches=-/main,+/main/Rel2.1
|
||
(更新具有 'rel' 标记的安全路径 '/server',
|
||
删除 'main' 分支,并将分支 'main/Rel2.1' 添加到
|
||
安全路径所应用到的分支组。就前面的示例而言,
|
||
现在分支列表将包含 'main/Rel2.1' 和 'main/2.0'。)
|
||
|
||
cm ^acl --^user=vsanchezm -^allowed=-^read -^overrideallowed=+^read ^path:/doc
|
||
(删除授权给 'vsanchezm' 的 '^read' 权限,在 '/doc' 路径中对其进行覆盖。)
|
||
|
||
== CMD_DESCRIPTION_ACTIVATEUSER ==
|
||
激活许可的用户。
|
||
|
||
== CMD_USAGE_ACTIVATEUSER ==
|
||
用法:
|
||
|
||
cm ^activateuser | ^au <用户名>[ ...][--^server=<存储库服务器规格>]
|
||
|
||
用户名 要激活的一个或多个用户名。使用双引号 (" ")
|
||
指定包含空格的用户名。使用空格
|
||
对各个用户名进行分隔。
|
||
|
||
选项:
|
||
--^server=<存储库服务器规格> 激活指定服务器中的用户。
|
||
如果未指定服务器,则在 client.conf 文件
|
||
中的默认服务器中执行命令。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解
|
||
存储库服务器规格。)
|
||
|
||
== CMD_HELP_ACTIVATEUSER ==
|
||
备注:
|
||
|
||
要激活用户,必须已事先禁用该用户。
|
||
默认情况下,用户第一次在 Unity VCS 中执行写操作时
|
||
会被激活。仅当未超过最大用户数时,
|
||
才会自动激活用户。
|
||
|
||
有关停用 Unity VCS 用户的更多信息,
|
||
请参阅 'cm ^help ^deactivateuser' 命令。
|
||
|
||
示例:
|
||
|
||
cm ^activateuser john
|
||
cm ^activateuser david "mary collins"
|
||
cm ^au peter --^server=localhost:8087
|
||
|
||
== CMD_DESCRIPTION_ADD ==
|
||
向版本控制中添加项。
|
||
|
||
== CMD_USAGE_ADD ==
|
||
用法:
|
||
|
||
cm ^add [-^R | -^r | --^recursive] [--^silent] [--^ignorefailed]
|
||
[--^skipcontentcheck] [--^coparent] [--^filetypes=<文件>] [--^noinfo]
|
||
[--^format=<格式字符串>] [--^errorformat=<格式字符串>]
|
||
<项路径>[ ...]
|
||
|
||
项路径 要移动的一个或多个项。使用双引号 (" ") 指定
|
||
包含空格的路径。使用空格对各个项进行分隔。
|
||
使用 * 添加当前目录的所有内容。
|
||
|
||
选项:
|
||
|
||
-^R -^r --^recursive 以递归方式添加项。
|
||
--^silent 不显示任何输出。
|
||
--^ignorefailed 如果无法添加某一项,则添加操作将在没有
|
||
这一项的情况下继续进行。注意:如果无法添加
|
||
某个目录,则不会添加目录中的内容。
|
||
--^skipcontentcheck 如果不足以根据扩展名将文件设置为
|
||
文本或二进制,则会将该文件设置为二进制,
|
||
而不是检查内容来检测类型。这样做
|
||
是为了在进行大量签入时提高性能。
|
||
--^coparent 对要添加的项的父级进行签出。
|
||
--^filetypes 要使用的 filetypes 文件。请查看以下链接以了解
|
||
更多信息:
|
||
http://blog.plasticscm.com/2008/03/custom-file-types.html
|
||
--^noinfo 不打印进度信息。
|
||
--^format 检索特定格式的输出消息。请查看
|
||
示例以了解更多信息。
|
||
--^errorformat 检索特定格式的错误消息
|
||
(如果有)。请查看示例以了解更多信息。
|
||
|
||
== CMD_HELP_ADD ==
|
||
备注:
|
||
|
||
添加项的要求:
|
||
- 要添加的项的父目录必须已事先添加。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^add' 命令可从 stdin 读取路径。为此,请传递一个破折号
|
||
"-"。
|
||
示例:cm ^add -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要添加的文件。
|
||
示例:
|
||
dir /S /B *.c | cm ^add -
|
||
(在 Windows 中,添加工作区中的所有 .c 文件。)
|
||
|
||
|
||
|
||
示例:
|
||
|
||
cm ^add file1.txt file2.txt
|
||
(添加 'file1.txt' 和 'file2.txt' 项。)
|
||
|
||
cm ^add c:\workspace\file.txt
|
||
(添加路径 'c:\workspace' 中的 'file.txt' 项。)
|
||
|
||
cm ^add -^R c:\workspace\src
|
||
(以递归方式添加 'src'。)
|
||
|
||
cm ^add -^R *
|
||
(以递归方式添加当前目录的所有内容。)
|
||
|
||
cm ^add -^R * --^filetypes=filetypes.conf
|
||
(以递归方式添加当前目录的所有内容,使用
|
||
'filetypes.conf' 根据文件的扩展名为文件分配类型,
|
||
而不是检查文件内容。)
|
||
|
||
cm ^add --^coparent c:\workspace\dir\file.txt
|
||
(将 'file.txt' 添加到源代码管理中,并执行 'dir' 的签出。)
|
||
|
||
cm ^add -^R * --^format="ADD {0}" --^errorformat="ERR {0}"
|
||
(以递归方式添加当前目录的所有内容,
|
||
对于成功添加的文件,打印 '^ADD <项>',而对于无法添加的项,
|
||
则打印 '^ERR <项>'。)
|
||
|
||
== CMD_USAGE_ADDIGNOREPATTERN ==
|
||
用法:
|
||
|
||
cm ^addignorepattern <模式>[ ...]
|
||
[--^workspace=<工作区路径> | --^allworkspaces] [--^remove]
|
||
|
||
== CMD_DESCRIPTION_ADMIN ==
|
||
在服务器上执行管理命令。
|
||
|
||
== CMD_USAGE_ADMIN ==
|
||
用法:
|
||
|
||
cm ^admin <命令> [选项]
|
||
|
||
可用命令:
|
||
|
||
^readonly
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^admin <命令> --^usage
|
||
cm ^admin <命令> --^help
|
||
|
||
== CMD_HELP_ADMIN ==
|
||
备注:
|
||
只有服务器管理员才能执行管理命令。
|
||
|
||
示例:
|
||
|
||
cm ^admin ^readonly ^enter
|
||
cm ^admin ^readonly ^status
|
||
|
||
== CMD_DESCRIPTION_ADMIN_READONLY ==
|
||
启用/禁用服务器只读模式。
|
||
|
||
== CMD_USAGE_ADMIN_READONLY ==
|
||
用法:
|
||
|
||
cm ^admin ^readonly (^enter | ^leave | ^status) [<服务器>]
|
||
|
||
操作:
|
||
|
||
^enter 服务器进入只读模式。写操作将被拒绝。
|
||
^leave 服务器退出只读模式。
|
||
^status 显示服务器只读模式状态。
|
||
|
||
选项:
|
||
服务器 在指定服务器(服务器:端口)中执行命令。(使用
|
||
'cm ^help ^objectspec' 可进一步了解服务器规格。)
|
||
如果未指定服务器,则该命令适用于当前工作区的
|
||
服务器。
|
||
如果当前路径不在工作区中,则该命令适用于
|
||
client.conf 配置文件中定义的默认服务器。
|
||
|
||
== CMD_HELP_ADMIN_READONLY ==
|
||
备注:
|
||
只有服务器管理员才能进入服务器只读模式。
|
||
|
||
示例:
|
||
|
||
cm ^admin ^readonly ^enter diana:8086
|
||
cm ^admin ^readonly ^leave
|
||
|
||
== CMD_DESCRIPTION_ANNOTATE ==
|
||
显示文件每一行上次修改所在的变更集及其作者。
|
||
|
||
== CMD_USAGE_ANNOTATE ==
|
||
用法:
|
||
|
||
cm ^annotate | ^blame <规格>[ ...]
|
||
[--^format=<格式字符串>]
|
||
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
|
||
[--^dateformat=<日期格式字符串>]
|
||
[--^encoding=<名称>]
|
||
[--^stats]
|
||
[--^repository=<存储库规格>]
|
||
|
||
规格 要批注的文件的规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
使用双引号 (" ") 指定包含空格的路径。
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^ignore 设置指定的比较方法。
|
||
请参阅“备注”以了解更多信息。
|
||
--^dateformat 设置输出格式以打印日期。
|
||
--^encoding 指定输出编码,如:utf-8。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^stats 显示统计信息。
|
||
--^repository 指定用于计算批注的存储库
|
||
规格。默认情况下,此命令使用的
|
||
存储库存储了工作区中已加载的
|
||
修订存储库。(使用 'cm ^help ^objectspec' 可进一步
|
||
了解存储库规格。)
|
||
|
||
== CMD_HELP_ANNOTATE ==
|
||
备注:
|
||
|
||
无法批注二进制文件。
|
||
|
||
--^ignore 选项:
|
||
^none 检测行尾和空格差异。
|
||
^eol 忽略行尾差异。
|
||
^whitespaces 忽略空格差异。
|
||
^"eol&whitespaces" 忽略行尾和空格差异。
|
||
|
||
--^format 选项:
|
||
此命令的输出参数如下:
|
||
{^owner} 上次更改行的用户。
|
||
{^rev} 行的源修订规格。
|
||
{^content} 行内容。
|
||
{^date} 签入行的日期。
|
||
{^comment} 行的源修订的注释。
|
||
{^changeset} 行的源修订的变更集。
|
||
{^line} 文件中的行号。
|
||
{^id} 项 ID。
|
||
{^parentid} 项的父级 ID。
|
||
{^rep} 项的存储库。
|
||
{^branch} 行的源修订的分支。
|
||
{^ismergerev} 是否在合并中创建了行的修订。
|
||
|
||
--^dateformat:
|
||
指定打印日期的输出格式。
|
||
请参阅以下网址中指明的受支持格式:
|
||
https://docs.microsoft.com/en-us/dotnet/standard/base-types/custom-date-and-time-format-strings
|
||
|
||
--^repository:
|
||
从远程存储库检索数据。适合用于分布式
|
||
场景。
|
||
|
||
示例:
|
||
|
||
cm ^blame c:\workspace\src --^ignore=^"eol&whitespaces" --^encoding=utf-8
|
||
cm ^annotate c:\workspace\file.txt --^ignore=^eol
|
||
|
||
cm ^annotate c:\workspace\file.txt --^format="{^owner} {^date, 10} {^content}"
|
||
(依次写入 owner 字段、一个空格、date 字段(右对齐)、
|
||
一个空格以及 content 字段。)
|
||
|
||
cm ^blame c:\workspace\file.txt --^format="{^owner, -7} {^comment} {^date}" \
|
||
--^dateformat=yyyyMMdd
|
||
(依次写入 owner 字段(占用 7 个空格,左对齐)、
|
||
一个空格、comment 字段、另一个空格以及结尾的
|
||
格式化日期(例如,20170329)。)
|
||
|
||
cm ^annotate c:\workspace\file.txt --^repository=centralRep@myserver:8084
|
||
|
||
cm ^blame ^serverpath:/src/client/checkin/Checkin.cs#^cs:73666
|
||
(使用服务器路径对变更集 73666 中开始的文件进行批注。)
|
||
|
||
== CMD_DESCRIPTION_APPLYLOCAL ==
|
||
检查是否有本地更改(本地移动、本地删除和本地更改)
|
||
并应用这些更改,以便 Unity VCS 开始跟踪这些更改。
|
||
|
||
== CMD_USAGE_APPLYLOCAL ==
|
||
用法:
|
||
|
||
cm ^applylocal | ^al [--^dependencies] [<项路径>[ ...]]
|
||
[--^machinereadable [--^startlineseparator=<分隔符>]
|
||
[--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
|
||
|
||
选项:
|
||
|
||
--^dependencies 将本地更改依赖项添加到要应用
|
||
的项。
|
||
项路径 要应用的项。使用空格对各个路径进行
|
||
分隔。使用双引号 (" ") 指定包含空格
|
||
的路径。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何开头。
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何结尾。
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
应如何分隔字段。
|
||
|
||
== CMD_HELP_APPLYLOCAL ==
|
||
备注:
|
||
|
||
如果未指定 --^dependencies 和 <项路径>,则该操作涉及
|
||
工作区中的所有本地更改。
|
||
始终以递归方式从给定路径应用。
|
||
|
||
示例:
|
||
|
||
cm ^applylocal foo.c bar.c
|
||
|
||
cm ^applylocal .
|
||
(应用当前目录中的所有本地更改。)
|
||
|
||
cm ^applylocal
|
||
(应用工作区中的所有本地更改。)
|
||
|
||
cm ^applylocal --^machinereadable
|
||
(应用工作区中的所有本地更改,并以易于解析的
|
||
简化格式打印结果。)
|
||
|
||
cm ^applylocal --^machinereadable --^startlineseparator=">" \
|
||
--^endlineseparator="<" --^fieldseparator=","
|
||
(应用工作区中的所有本地更改,并以易于解析的
|
||
简化格式打印结果,以指定的字符串作为行的开头和结尾以及
|
||
对各字段进行分隔。)
|
||
|
||
== CMD_DESCRIPTION_ARCHIVE ==
|
||
将数据存档在外部存储中。
|
||
|
||
== CMD_USAGE_ARCHIVE ==
|
||
用法:
|
||
|
||
cm ^archive | ^arch <修订规格>[ ...][-^c | --^comment=<注释字符串>]
|
||
[--^file=<基项文件>]
|
||
(从存储库中提取数据并将这些数据存储在外部存储中。)
|
||
|
||
cm ^archive | ^arch <修订规格>[ ...]--^restore
|
||
(将以前存档的修订还原到存储库中。)
|
||
|
||
修订规格 一个或多个修订规格。可通过 "-" 修饰符从 STDIN
|
||
进行读取。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解修订规格。)
|
||
--^restore 从生成的存档文件中还原以前存档的
|
||
数据。
|
||
|
||
选项:
|
||
|
||
-^c | --^comment 在要创建的存档存储文件中设置注释。
|
||
--^file 新存档数据文件的名称前缀和
|
||
(可选)路径。
|
||
|
||
== CMD_HELP_ARCHIVE ==
|
||
备注:
|
||
|
||
此命令从存储库数据库中提取数据并将这些数据存储在
|
||
外部存储中,从而节省数据库空间。
|
||
此命令还可以将以前存档的修订还原到
|
||
存储库数据库中 (--^restore)。
|
||
|
||
使用 'cm ^help ^objectspec' 可了解如何指定修订规格。
|
||
|
||
运行此命令的用户必须是 Unity VCS 服务器管理员
|
||
(存储库服务器所有者)才能完成操作。
|
||
|
||
来自指定修订中的每个数据段都将存储在
|
||
不同的文件中,且文件名以 --^file
|
||
参数定义的值开头。此参数可以包含完整路径值,其中包括
|
||
未来存档文件的前缀,也可以仅包含此前缀值。
|
||
|
||
存档后可以通过两种方式访问来自指定修订中的
|
||
数据:
|
||
|
||
- 从客户端:客户端将检测数据是否已存档,
|
||
并提示用户输入文件的位置。
|
||
用户可以通过创建一个名为 externaldata.conf 的
|
||
文件(在标准配置文件位置,使用适用于
|
||
client.conf 文件的相同规则)来配置外部数据位置,
|
||
其中包含已存档数据所在的路径。
|
||
|
||
- 从服务器:通过这种方式,用户将不必知道数据
|
||
是否已存档,因为请求将以透明的方式由服务器
|
||
解析。为此,管理员将在服务器目录中创建一个
|
||
名为 externaldata.conf 的文件,并在该文件中填充
|
||
已存档的卷所在的路径。
|
||
|
||
要取消存档(还原)一个修订(或一组修订),必须能够
|
||
从客户端访问已存档的文件。因此,无法取消存档
|
||
服务器正在解析的数据(方法 2),原因是客户端
|
||
无法将数据识别为已存档。如果使用了方法 2,
|
||
为了成功取消存档,管理员必须首先编辑
|
||
externaldata.conf 服务器文件,以便删除对必须取消存档的
|
||
已存档文件的访问权限。
|
||
|
||
设置 PLASTICEDITOR 环境变量可指定用于键入注释的
|
||
编辑器。
|
||
|
||
示例:
|
||
|
||
cm ^archive bigfile.zip#^br:/main
|
||
(在分支 'main' 中存档 'bigfile.zip' 的最后一个修订。)
|
||
|
||
cm ^archive ^rev:myfile.pdf#^cs:2 -^c="大型 PDF 文件" --^file=c:\arch_files\arch
|
||
(将变更集 2 中 myfile.pdf 的修订存档在 'c:\archived_files'
|
||
文件夹中。存档的文件名将以 'arch' 开头(例如 arch_11_56)。)
|
||
|
||
cm ^find "^revs ^where ^size > 26214400" --^format="{^item}#{^branch}" \
|
||
--^nototal | cm ^archive --^comment="volume00" --^file="volume00" -
|
||
(将所有大于 25Mb 的文件存档在名称 'volume00' 开头的
|
||
文件中。)
|
||
|
||
cm ^find "^revs ^where ^size > 26214400 ^and ^archived='true'" \
|
||
--^format="{^item}#{^branch}" --^nototal | cm ^archive --^restore
|
||
(还原所有大于 25Mb 的存档文件。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE ==
|
||
允许用户管理属性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE ==
|
||
用法:
|
||
|
||
cm ^attribute | ^att <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^set
|
||
^unset
|
||
^rename
|
||
^edit
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^attribute <命令> --^usage
|
||
cm ^attribute <命令> --^help
|
||
|
||
== CMD_HELP_ATTRIBUTE ==
|
||
示例:
|
||
|
||
cm ^attribute ^create 状态
|
||
cm ^attribute ^set ^att:status ^br:/main/SCM105 未完成
|
||
cm ^attribute ^unset ^att:status ^br:/main/SCM105
|
||
cm ^attribute ^delete ^att:status
|
||
cm ^attribute ^rename ^att:status "构建状态"
|
||
cm ^attribute ^edit ^att:status "CI 管道中任务的状态"
|
||
|
||
== CMD_DESCRIPTION_CHANGELIST ==
|
||
对更改列表中的待定更改进行分组。
|
||
|
||
== CMD_USAGE_CHANGELIST ==
|
||
用法:
|
||
|
||
a) 管理更改列表对象:
|
||
|
||
cm ^changelist | ^clist [--^symlink]
|
||
(显示所有更改列表。)
|
||
|
||
cm ^changelist | ^clist ^add <更改列表名称>
|
||
[<更改列表描述>] [--^persistent | --^notpersistent] [--^symlink]
|
||
(创建更改列表。)
|
||
|
||
cm ^changelist | ^clist ^rm <更改列表名称> [--^symlink]
|
||
(删除所选的更改列表。如果此更改列表包含待定更改,
|
||
这些更改将移至 ^default 更改列表。)
|
||
|
||
cm ^changelist | ^clist ^edit <更改列表名称> [<操作名称> <操作值>]
|
||
[--^persistent | --^notpersistent] [--^symlink]
|
||
(编辑所选的更改列表。)
|
||
|
||
b) 管理给定更改列表的内容:
|
||
|
||
cm ^changelist | ^clist <更改列表名称> (^add | ^rm) <路径名称>[ ...]
|
||
[--^symlink]
|
||
(通过添加 ('^add') 或删除 ('^rm') 与给定路径名称匹配的更改
|
||
来添加所选的更改列表。使用空格
|
||
对各个路径名称进行分隔。使用双引号 (" ") 指定包含空格的
|
||
路径。路径的状态必须为 '^Added' 或 '^Checked-out'。)
|
||
|
||
选项:
|
||
|
||
更改列表名称 更改列表的名称。
|
||
更改列表描述 更改列表的描述。
|
||
操作名称 选择 '^rename' 或 '^description' 来编辑
|
||
更改列表。
|
||
操作值 在编辑更改列表时应用新名称或
|
||
新描述。
|
||
--^persistent 即使更改列表的内容已被签入或还原,
|
||
更改列表也会保留在工作区中。
|
||
--^notpersistent (默认值)即使更改列表的内容已被签入
|
||
或还原,更改列表也不会保留在
|
||
工作区中。
|
||
--^symlink 将操作应用于符号链接而不是
|
||
目标。
|
||
|
||
== CMD_HELP_CHANGELIST ==
|
||
备注:
|
||
|
||
'^changelist' 命令会处理工作区待定更改列表以及更改列表中
|
||
包含的更改。
|
||
|
||
示例:
|
||
|
||
cm ^changelist
|
||
(显示当前工作区更改列表。)
|
||
|
||
cm ^changelist ^add 配置更改 "dotConf 文件" --^persistent
|
||
(创建一个名为 '配置更改' 和描述为 'dotConf
|
||
文件' 的新更改列表,该更改列表在待定更改列表被签入
|
||
或还原后将在当前工作区中持久保留。)
|
||
|
||
cm ^changelist ^edit 配置更改 ^rename 配置文件 --^notpersistent
|
||
(编辑名为 '配置更改' 的更改列表,并将该更改列表重命名为
|
||
'配置文件'。此外还会将更改列表变为“非持久性”。)
|
||
|
||
cm ^changelist ^edit 配置更改 --^notpersistent
|
||
(编辑名为 '配置更改' 的更改列表,并将该更改列表变为“非持久性”。)
|
||
|
||
cm ^changelist ^rm 配置文件
|
||
(从当前工作区中删除待定更改列表 '配置文件'。)
|
||
|
||
cm ^changelist 配置文件 ^add foo.conf
|
||
(将文件 'foo.conf' 添加到 '配置文件' 更改列表中。)
|
||
|
||
cm ^changelist 配置文件 ^rm foo.conf readme.txt
|
||
(从 '配置文件' 更改列表中删除文件 'foo.conf' 和 'readme.txt',
|
||
并将这些文件移至系统默认更改列表。)
|
||
|
||
== CMD_DESCRIPTION_CHANGESET ==
|
||
对变更集执行高级操作。
|
||
|
||
== CMD_USAGE_CHANGESET ==
|
||
用法:
|
||
|
||
cm ^changeset <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^move | ^mv
|
||
^delete | ^rm
|
||
^editcomment | ^edit
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^changeset <命令> --^usage
|
||
cm ^changeset <命令> --^help
|
||
|
||
== CMD_HELP_CHANGESET ==
|
||
示例:
|
||
|
||
cm ^changeset ^move ^cs:15@myrepo ^br:/main/scm005@myrepo
|
||
cm ^changeset ^delete ^cs:2b55f8aa-0b29-410f-b99c-60e573a309ca@devData
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_EDITCOMMENT ==
|
||
修改变更集的注释。
|
||
|
||
== CMD_USAGE_CHANGESET_EDITCOMMENT ==
|
||
用法:
|
||
|
||
cm ^changeset ^editcomment | ^edit <变更集规格> <新注释>
|
||
|
||
选项:
|
||
|
||
变更集规格 要修改注释的目标变更集。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集
|
||
规格。)
|
||
新注释 要添加到目标变更集的
|
||
新注释。
|
||
|
||
== CMD_HELP_CHANGESET_EDITCOMMENT ==
|
||
备注:
|
||
|
||
- 目标变更集规格必须有效。
|
||
|
||
示例:
|
||
|
||
cm ^changeset ^editcomment ^cs:15@myrepo "我忘了添加签入详细信息"
|
||
cm ^changeset ^edit ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a \
|
||
"此注释文本将替代先前的注释文本。"
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_MOVE ==
|
||
将变更集及其所有后代移动到另一个分支。
|
||
|
||
== CMD_USAGE_CHANGESET_MOVE ==
|
||
用法:
|
||
|
||
cm ^changeset ^move | ^mv <变更集规格> <分支规格>
|
||
|
||
选项:
|
||
|
||
变更集规格 要移动到另一个分支的第一个变更集。All
|
||
同一分支中的所有后代变更集也将作为
|
||
该命令的目标。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集
|
||
规格。)
|
||
分支规格 存储目标变更集的目标
|
||
分支。目标分支需要为空或不存在;
|
||
如果目标分支不存在,该命令将创建
|
||
目标分支。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支
|
||
规格。)
|
||
|
||
== CMD_HELP_CHANGESET_MOVE ==
|
||
备注:
|
||
|
||
- 目标变更集规格必须有效。
|
||
- 目标分支必须为空或不存在。
|
||
- 如果目标分支不存在,则会创建目标分支。
|
||
- 合并链接将保持不变,因为分支不会影响它们。
|
||
|
||
示例:
|
||
|
||
cm ^changeset ^move ^cs:15@myrepo ^br:/main/scm005@myrepo
|
||
cm ^changeset ^move ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a ^br:/hotfix/TL-352
|
||
|
||
== CMD_DESCRIPTION_CHANGESET_DELETE ==
|
||
从存储库中删除变更集。
|
||
|
||
== CMD_USAGE_CHANGESET_DELETE ==
|
||
用法:
|
||
|
||
cm ^changeset ^delete | ^rm <变更集规格>
|
||
|
||
选项:
|
||
|
||
变更集规格 要删除的目标变更集。必须满足
|
||
某些特定条件。请参阅“备注”以了解更多信息。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集
|
||
规格。)
|
||
|
||
== CMD_HELP_CHANGESET_DELETE ==
|
||
备注:
|
||
|
||
- 目标变更集必须是其分支中的最后一个变更集。
|
||
- 目标变更集不能是任何其他变更集的父级。
|
||
- 目标变更集既不能作为合并链接的源,也不能
|
||
在间隔合并中作为源。
|
||
- 不得将任何标签应用于目标变更集。
|
||
- 目标变更集不能是根变更集 ('^cs:0')
|
||
|
||
示例:
|
||
|
||
cm ^changeset ^rm ^cs:4525@myrepo@myserver
|
||
cm ^changeset ^delete ^cs:cb11ecdb-1aa9-4f11-8698-dcab14e5885a
|
||
|
||
== CMD_DESCRIPTION_CHANGEUSERPASSWORD ==
|
||
更改用户密码 (UP)。
|
||
|
||
== CMD_USAGE_CHANGEUSERPASSWORD ==
|
||
用法:
|
||
|
||
cm ^changepassword | ^passwd
|
||
|
||
== CMD_HELP_CHANGEUSERPASSWORD ==
|
||
备注:
|
||
|
||
仅当安全性配置为 UP(用户/密码)时,
|
||
此命令才可用。请参阅《管理指南》以了解更多信息。
|
||
需要新旧密码。
|
||
|
||
示例:
|
||
|
||
cm ^passwd
|
||
|
||
== CMD_DESCRIPTION_CHECKCONNECTION ==
|
||
检查与服务器的连接。
|
||
|
||
== CMD_USAGE_CHECKCONNECTION ==
|
||
用法:
|
||
|
||
cm ^checkconnection | ^cc
|
||
|
||
== CMD_HELP_CHECKCONNECTION ==
|
||
备注:
|
||
|
||
- 此命令返回一条消息,指示是否存在与配置的
|
||
Unity VCS 服务器之间的有效连接。
|
||
- 此命令检查配置的用户是否有效。此外
|
||
还会检查与服务器的版本兼容性。
|
||
|
||
== CMD_DESCRIPTION_CHECKDB ==
|
||
检查存储库的完整性。
|
||
|
||
== CMD_USAGE_CHECKDB ==
|
||
用法:
|
||
|
||
cm ^checkdatabase | ^chkdb [<存储库服务器规格> | <存储库规格>]
|
||
|
||
使用 'cm ^help ^objectspec' 可进一步了解存储库服务器和存储库规格。
|
||
|
||
== CMD_HELP_CHECKDB ==
|
||
备注:
|
||
|
||
- 如果未指定存储库服务器规格和存储库规格,
|
||
则将在 client.conf 文件内指定的服务器中执行检查。
|
||
|
||
示例:
|
||
|
||
cm ^checkdatabase ^repserver:localhost:8084
|
||
cm ^chkdb ^rep:default@localhost:8084
|
||
|
||
== CMD_DESCRIPTION_CHECKIN ==
|
||
将更改存储在存储库中。
|
||
|
||
== CMD_USAGE_CHECKIN ==
|
||
用法:
|
||
|
||
cm ^checkin | ^ci [<项路径>[ ...]]
|
||
[-^c=<注释字符串> | -^commentsfile=<注释文件>]
|
||
[--^all|-^a] [--^applychanged] [--^private] [--^update] [--^symlink]
|
||
[--^noshowchangeset]
|
||
[--^machinereadable [--^startlineseparator=<分隔符>]
|
||
[--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
|
||
|
||
选项:
|
||
|
||
项路径 要签入的项。使用双引号 (" ")
|
||
指定包含空格的路径。使用空格
|
||
对各个项路径进行分隔。
|
||
使用 . 将签入应用到当前目录。
|
||
-^c 将指定的注释应用于在签入操作中创建的
|
||
变更集。
|
||
-^commentsfile 将指定文件中的注释应用于在签入操作中
|
||
创建的变更集。
|
||
--^all | -^a 还包括在给定路径上进行了本地更改、移动
|
||
和删除的项。
|
||
--^applychanged 将签入操作应用于在工作区中
|
||
检测到的已更改项以及
|
||
签出的项。
|
||
--^private 还包括在工作区中检测到的
|
||
私有项。
|
||
--^update 自动处理更新合并
|
||
(如果最终发生此行为)。
|
||
--^symlink 将签入操作应用于符号链接而不是
|
||
目标。
|
||
--^noshowchangeset 不打印结果变更集。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何开头。
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何结尾。
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
应如何分隔字段。
|
||
|
||
== CMD_HELP_CHECKIN ==
|
||
备注:
|
||
|
||
- 如果未指定 <项路径>,则签入操作涉及
|
||
工作区中的所有待定更改。
|
||
- 签入操作始终以递归方式从给定路径应用。
|
||
- 要签入项,必须满足以下条件:
|
||
- 项必须受源代码管理。
|
||
- 如果是私有项(不受源代码管理),则必须有 --^private
|
||
标志才能签入该项。
|
||
- 必须签出项。
|
||
- 如果已更改但未签出项,则除非 <项路径> 是目录
|
||
或包含通配符 ('*'),否则不需要
|
||
--^applychanged 标志。
|
||
|
||
修订内容必须与以前的修订不同才能
|
||
签入。
|
||
|
||
设置 PLASTICEDITOR 环境变量可指定用于键入注释的
|
||
编辑器。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^checkin' 命令可从 stdin 读取路径。为此,请传递一个
|
||
破折号 "-"。
|
||
示例:cm ^checkin -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要签入的文件。
|
||
示例:
|
||
dir /S /B *.c | cm ^checkin --^all -
|
||
(在 Windows 中,签入工作区中的所有 .c 文件。)
|
||
|
||
示例:
|
||
|
||
cm ^checkin file1.txt file2.txt
|
||
(签入已签出的文件 'file1.txt' 和 'file2.txt'。)
|
||
|
||
cm ^checkin .-^commentsfile=mycomment.txt
|
||
(签入当前目录并在 'mycomment.txt' 文件中
|
||
设置注释。)
|
||
|
||
cm ^checkin 链接 --^symlink
|
||
(签入 '链接' 文件而不是目标;适用于 UNIX
|
||
环境。)
|
||
|
||
cm ^ci file1.txt -^c="我的注释"
|
||
(签入 'file1.txt' 并包含注释。)
|
||
|
||
cm ^status --^short --^compact --^changelist=pending_to_review | cm ^checkin -
|
||
(列出名为 'pending_to_review' 的更改列表中的路径,并将此列表
|
||
重定向到 checkin 命令的输入。)
|
||
|
||
cm ^ci .--^machinereadable
|
||
(签入当前目录,并以易于解析的简化格式
|
||
打印结果。)
|
||
|
||
cm ^ci .--^machinereadable --^startlineseparator=">" --^endlineseparator="<" --^fieldseparator=","
|
||
(签入当前目录,并以易于解析的简化格式
|
||
打印结果,以指定的字符串作为行的开头和结尾以及
|
||
对各字段进行分隔。)
|
||
|
||
== CMD_DESCRIPTION_CHECKOUT ==
|
||
将文件标记为修改就绪。
|
||
|
||
== CMD_USAGE_CHECKOUT ==
|
||
用法:
|
||
|
||
cm ^checkout | ^co [<项路径>[ ...]] [-^R | -^r | --^recursive]
|
||
[--^format=<格式字符串>]
|
||
[--^errorformat=<格式字符串>] [--^resultformat=<格式字符串>]
|
||
[--^silent] [--^symlink] [--^ignorefailed]
|
||
[--^machinereadable [--^startlineseparator=<分隔符>]
|
||
[--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
|
||
|
||
选项:
|
||
|
||
项路径 要签出的项。使用双引号 (" ")
|
||
指定包含空格的路径。使用空格
|
||
对各个项路径进行分隔。
|
||
使用 . 将签出应用到当前目录。
|
||
-^R 以递归方式签出文件。
|
||
--^format 检索特定格式的输出进度
|
||
消息。请查看示例以了解更多信息。
|
||
--^errorformat 检索特定格式的错误消息
|
||
(如果有)。请查看示例以了解更多信息。
|
||
--^resultformat 检索特定格式的输出结果
|
||
消息。请查看示例以了解更多信息。
|
||
--^silent 不显示任何输出。
|
||
--^symlink 将签出操作应用于符号链接而不是
|
||
目标。
|
||
--^ignorefailed 如果无法锁定某项(无法执行独占签出),
|
||
则签出操作将在没有这一项的情况下
|
||
继续进行。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何开头。
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何结尾。
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
应如何分隔字段。
|
||
|
||
== CMD_HELP_CHECKOUT ==
|
||
备注:
|
||
|
||
要签出项,必须满足以下条件:
|
||
- 项必须受源代码管理。
|
||
- 必须签入项。
|
||
|
||
如果在服务器上配置了锁(存在 lock.conf),则每次
|
||
在某条路径上进行签出时,Unity VCS 都会检查是否符合规则,
|
||
如果符合,该路径将处于独占签出(锁定)状态,以便任何其他人
|
||
都无法同时进行签出。
|
||
可使用 'cm ^lock ^list' 获取服务器中的所有锁。
|
||
请参阅《管理员指南》以了解更多信息:
|
||
https://www.plasticscm.com/download/help/adminguide
|
||
|
||
格式字符串将占位符 '{0}' 替换为要签出的
|
||
项的路径。请查看示例以了解具体用法。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^checkout' 命令可从 stdin 读取路径。为此,请传递一个
|
||
破折号 "-"。
|
||
示例:cm ^checkout -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要签出的文件。
|
||
示例:
|
||
dir /S /B *.c | cm ^checkout -
|
||
(在 Windows 中,签出工作区中的所有 .c 文件。)
|
||
|
||
示例:
|
||
|
||
cm ^checkout file1.txt file2.txt
|
||
(签出 'file1.txt' 和 'file2.txt' 文件。)
|
||
|
||
cm ^co *.txt
|
||
(签出所有文本文件。)
|
||
|
||
cm ^checkout .
|
||
(签出当前目录。)
|
||
|
||
cm ^checkout -^R c:\workspace\src
|
||
(以递归方式签出 'src' 文件夹。)
|
||
|
||
cm ^co file.txt --^format="正在签出项 {0}"
|
||
--^errorformat="签出项 {0} 时出错" /
|
||
--^resultformat="项 {0} 已签出"
|
||
(签出 'file.txt',并使用指定的格式字符串
|
||
显示操作的进度、结果和错误。)
|
||
|
||
cm ^checkout 链接 --^symlink
|
||
(签出 '链接' 文件而不是签出到目标;适用于 UNIX
|
||
环境。)
|
||
|
||
cm ^checkout .-^R --^ignorefailed
|
||
(以递归方式签出当前文件夹,忽略无法签出的
|
||
文件。)
|
||
|
||
cm ^co .--^machinereadable --^startlineseparator=">"
|
||
(签出当前目录,并以易于解析的简化格式打印结果,
|
||
以指定的字符串作为行的开头。)
|
||
|
||
== CMD_DESCRIPTION_CHECKSELECTORSYNTAX ==
|
||
检查选择器的语法。
|
||
|
||
== CMD_USAGE_CHECKSELECTORSYNTAX ==
|
||
用法:
|
||
|
||
cm ^checkselectorsyntax | ^css --^file=<选择器文件>
|
||
(检查选择器文件语法。)
|
||
|
||
^cat <选择器文件> | cm ^checkselectorsyntax | ^css -
|
||
(适用于 Unix。在标准输入中检查选择器文件。)
|
||
|
||
^type <选择器文件> | cm ^checkselectorsyntax | ^css -
|
||
(适用于 Windows。在标准输入中检查选择器文件。)
|
||
|
||
|
||
--^file 要从中读取选择器的文件。
|
||
|
||
== CMD_HELP_CHECKSELECTORSYNTAX ==
|
||
备注:
|
||
|
||
此命令在文件或标准输入中读取选择器,并检查
|
||
选择器是否为有效语法。如果语法检查结果为失败,则会将原因
|
||
打印在标准输出中。
|
||
|
||
示例:
|
||
|
||
cm ^checkselectorsyntax --^file=myselector.txt
|
||
(检查 'myselector.txt' 文件的语法。)
|
||
|
||
^cat myselector.txt | cm ^checkselectorsyntax
|
||
(在标准输入中检查 'myselector.txt' 的语法。)
|
||
|
||
== CMD_DESCRIPTION_CHANGEREVISIONTYPE ==
|
||
更改某个项的修订类型(二进制或文本)。
|
||
|
||
== CMD_USAGE_CHANGEREVISIONTYPE ==
|
||
用法:
|
||
|
||
cm ^changerevisiontype | ^chgrevtype | ^crt <项路径>[ ...]--^type=(^bin | ^txt)
|
||
|
||
项路径 要更改修订类型的项。使用双引号 (" ")
|
||
指定包含空格的路径。使用空格
|
||
对各个项路径进行分隔。
|
||
--^type 目标修订类型。选择 '^bin' 或 '^txt'。
|
||
|
||
== CMD_HELP_CHANGEREVISIONTYPE ==
|
||
备注:
|
||
|
||
此命令只能应用于文件,而不能应用于目录。
|
||
指定的类型必须是系统支持的类型:'^bin' 或 '^txt'(二进制
|
||
或文本)。
|
||
|
||
示例:
|
||
|
||
cm ^changerevisiontype c:\workspace\file.txt --^type=^txt
|
||
(将 'file.txt' 修订类型更改为文本。)
|
||
|
||
cm ^chgrevtype comp.zip "image file.jpg" --^type=^bin
|
||
(将 'comp.zip' 和 "image file.jpg" 修订类型更改为二进制。)
|
||
|
||
cm ^crt *.* --^type=^txt
|
||
(将所有文件的修订类型更改为文本。)
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_EDIT ==
|
||
编辑触发器。
|
||
|
||
== CMD_USAGE_TRIGGER_EDIT ==
|
||
用法:
|
||
|
||
cm ^trigger | ^tr ^edit <子类型_类型> <位置编号>
|
||
[--^position=<新位置>]
|
||
[--^name=<新名称>] [--^script=<脚本路径>]
|
||
[--^filter=<筛选器字符串>] [--^server=<存储库服务器规格>]
|
||
|
||
子类型_类型 触发器执行和触发器操作。
|
||
键入 'cm ^showtriggertypes' 可查看触发器类型
|
||
列表。
|
||
位置编号 要修改的触发器占用位置。
|
||
|
||
选项:
|
||
|
||
--^position 指定触发器的新位置。
|
||
此位置不能正在由相同类型的另一个
|
||
触发器使用。
|
||
--^name 指定触发器的新名称。
|
||
--^script 指定触发器脚本的新执行路径。
|
||
如果脚本以 "^webtrigger " 开头,则认为
|
||
这是 Web 触发器。请参阅“备注”以了解
|
||
更多详细信息。
|
||
--^filter 仅检查与指定筛选条件匹配的项。
|
||
--^server 修改指定服务器上的触发器。
|
||
如果未指定服务器,则在客户端上配置的
|
||
服务器上执行命令。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解服务器
|
||
规格。)
|
||
|
||
== CMD_HELP_TRIGGER_EDIT ==
|
||
备注:
|
||
|
||
Web 触发器:创建 Web 触发器的方法是键入 "^webtrigger <目标-URI>"
|
||
作为触发器命令。在这种情况下,触发器将针对指定的 URI
|
||
执行 POST 查询,其中,请求主体包含带有触发器
|
||
环境变量的 JSON 字典,还有一个指向字符串数组的
|
||
固定 INPUT 键。
|
||
|
||
示例:
|
||
|
||
cm ^trigger ^edit ^after-setselector 6 --^name="Backup2 管理器" --^script="/new/path/al/script"
|
||
cm ^tr ^edit ^before-mklabel 7 --^position=4 --^server=myserver:8084
|
||
cm ^trigger ^edit ^after-add 2 --^script="^webtrigger http://myserver.org/api"
|
||
|
||
== CMD_DESCRIPTION_CODEREVIEW ==
|
||
创建、编辑或删除代码审查。
|
||
|
||
== CMD_USAGE_CODEREVIEW ==
|
||
用法:
|
||
|
||
cm ^codereview <规格> <标题> [--^status=<状态名称>]
|
||
[--^assignee=<用户名>] [--^format=<格式字符串>]
|
||
[--^repository=<存储库规格>]
|
||
(创建代码审查。)
|
||
|
||
cm ^codereview -^e <ID> [--^status=<状态名称>] [--^assignee=<用户名>]
|
||
[--^repository=<存储库规格>]
|
||
(编辑代码审查。)
|
||
|
||
cm ^codereview -^d <ID> [ ...][--^repository=<存储库规格>]
|
||
(删除一个或多个代码审查。)
|
||
|
||
|
||
规格 可以是变更集规格或分支规格。此规格
|
||
将作为新代码审查的目标。(使用
|
||
'cm ^help ^objectspec' 可进一步了解变更集规格
|
||
或分支规格。)
|
||
标题 用作新代码审查的标题的
|
||
文本字符串。
|
||
ID 代码审查标识号。也可以使用
|
||
GUID。
|
||
|
||
选项:
|
||
|
||
-^e 编辑现有代码审查的参数。
|
||
-^d 删除一个或多个现有代码审查。使用
|
||
空格对各个代码审查 ID 进行分隔。
|
||
--^status 设置代码审查的新状态。请参阅“备注”
|
||
以了解更多信息。
|
||
--^assignee 设置代码审查的新被分派人。
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^repository 设置要用作默认存储库的存储库。(使用
|
||
'cm ^help ^objectspec' 可进一步了解存储库
|
||
规格。)
|
||
|
||
== CMD_HELP_CODEREVIEW ==
|
||
备注:
|
||
|
||
此命令允许用户管理代码审查:为变更集或分支
|
||
创建、编辑和删除代码审查。
|
||
|
||
要创建新的代码审查,必须提供变更集/分支规格和
|
||
标题。也可以设置初始状态和被分派人。结果将返回
|
||
一个 ID(如果请求返回 GUID,则返回 GUID)。
|
||
|
||
要编辑或删除现有代码审查,必须提供目标代码
|
||
审查 ID(或 GUID)。如果没有错误,则不会显示任何消息。
|
||
|
||
状态参数只能是以下值之一:^"Under review"
|
||
(默认值)、^"Reviewed" 或 ^"Rework required"。
|
||
|
||
repository 参数可用于设置默认的工作
|
||
存储库。当用户想要在其他服务器上而不是在与当前工作区
|
||
关联的服务器上管理审查时,或者根本没有
|
||
当前工作区时,此参数很有用。
|
||
|
||
输出格式自定义:
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{0} ID
|
||
{1} GUID
|
||
|
||
请注意,'--^format' 参数仅在创建新的代码
|
||
审查时生效。
|
||
|
||
示例:
|
||
|
||
cm ^codereview ^cs:1856@myrepo@myserver:8084 "我的代码审查" --^assignee=dummy
|
||
cm ^codereview ^br:/main/task001@myrepo@myserver:8084 "我的代码审查" \
|
||
--^status=^"Rework required" --^assignee=newbie --^format="{^id} -> {^guid}"
|
||
|
||
cm ^codereview 1367 -^e --^assignee=新的被分派人
|
||
cm ^codereview -^e 27658884-5dcc-49b7-b0ef-a5760ae740a3 --^status=已审查
|
||
|
||
cm ^codereview -^d 1367 --^repository=myremoterepo@myremoteserver:18084
|
||
cm ^codereview 27658884-5dcc-49b7-b0ef-a5760ae740a3 -^d
|
||
|
||
== CMD_DESCRIPTION_CRYPT ==
|
||
对密码进行加密。
|
||
|
||
== CMD_USAGE_CRYPT ==
|
||
用法:
|
||
|
||
cm ^crypt <我的密码>
|
||
|
||
我的密码 要加密的密码。
|
||
|
||
== CMD_HELP_CRYPT ==
|
||
备注:
|
||
|
||
此命令用于加密作为参数传递的给定密码。
|
||
旨在对配置文件中的密码进行加密并提高
|
||
安全性。
|
||
|
||
示例:
|
||
|
||
cm ^crypt dbconfpassword -> ENCRYPTED: encrypteddbconfpassword
|
||
(对数据库配置文件 'db.conf' 中的密码进行加密。)
|
||
|
||
== CMD_DESCRIPTION_DEACTIVATEUSER ==
|
||
停用许可的用户。
|
||
|
||
== CMD_USAGE_DEACTIVATEUSER ==
|
||
用法:
|
||
|
||
cm ^deactivateuser | ^du <用户名>[ ...][--^server=<名称:端口>]
|
||
[--^nosolveuser]
|
||
|
||
用户名 要停用的一个或多个用户名。使用空格
|
||
对各个用户名进行分隔。
|
||
如果是 SID,则需要 '--^nosolveuser'。
|
||
|
||
选项:
|
||
|
||
--^server 停用指定服务器上的用户。
|
||
如果未指定服务器,则在客户端上配置的
|
||
服务器上执行命令。
|
||
--^nosolveuser 使用此选项时,该命令将不会检查身份验证系统上
|
||
是否存在相应的用户名。而且
|
||
<用户名> 必须是用户 SID。
|
||
|
||
== CMD_HELP_DEACTIVATEUSER ==
|
||
备注:
|
||
|
||
此命令将用户设置为非活动状态,从而禁止该用户使用
|
||
Unity VCS。
|
||
|
||
有关激活 Unity VCS 用户的更多信息,请参阅 'cm ^activateuser'
|
||
命令。
|
||
|
||
此命令检查用户是否在基础身份验证系统(例如 ActiveDirectory、
|
||
LDAP、用户/密码...)上存在。
|
||
要强制停用在身份验证系统上不再存在的
|
||
用户,可以使用 '--^nosolveuser' 选项。
|
||
|
||
示例:
|
||
|
||
cm ^deactivateuser john
|
||
cm ^du peter "mary collins"
|
||
cm ^deactivateuser john --^server=myserver:8084
|
||
cm ^deactivateuser S-1-5-21-3631250224-3045023395-1892523819-1107 --^nosolveuser
|
||
|
||
== CMD_DESCRIPTION_DIFF ==
|
||
显示文件、变更集和标签之间的差异。
|
||
|
||
== CMD_USAGE_DIFF ==
|
||
用法:
|
||
|
||
cm ^diff <变更集规格> | <标签规格> | <搁置规格> [<变更集规格> | <标签规格> | <搁置规格>]
|
||
[<路径>]
|
||
[--^added] [--^changed] [--^moved] [--^deleted]
|
||
[--^repositorypaths] [--^download=<下载路径>]
|
||
[--^encoding=<名称>]
|
||
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
|
||
[--^clean]
|
||
[--^format=<格式字符串>] [--^dateformat=<格式字符串>]
|
||
|
||
显示“源”变更集或搁置集与“目标”变更集或搁置集
|
||
之间的差异。可使用变更集或标签规格
|
||
来指定变更集。
|
||
如果给出了两个规格,则第一个是差异比较的“源”,
|
||
第二个是“目标”。
|
||
如果仅给出一个规格,则“源”将是指定“目标”的
|
||
父变更集。
|
||
如果指定了可选路径,则将启动“差异比较窗口”以显示
|
||
该文件的两个修订之间的差异。
|
||
|
||
cm ^diff <修订规格1> <修订规格2>
|
||
|
||
显示一对修订之间的差异。这些差异
|
||
显示在“差异比较窗口”中。指定的第一个修订将
|
||
显示在左侧。
|
||
|
||
cm ^diff <分支规格> [--^added] [--^changed] [--^moved] [--^deleted]
|
||
[--^repositorypaths] [--^download=<下载路径>]
|
||
[--^encoding=<名称>]
|
||
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
|
||
[--^clean]
|
||
[--^format=<格式字符串>] [--^dateformat=<格式字符串>]
|
||
[--^fullpaths | --^fp]
|
||
|
||
显示分支差异。
|
||
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
选项:
|
||
|
||
--^added 仅打印包含已添加到存储库的项
|
||
的差异。
|
||
--^changed 仅打印包含已更改的项
|
||
的差异。
|
||
--^moved 仅打印包含已移动或已重命名的项
|
||
的差异。
|
||
--^deleted 仅打印包含已删除的项
|
||
的差异。
|
||
|
||
如果未指定 '--^added'、'--^changed'、'--^moved' 或 '--^deleted',
|
||
则该命令将打印所有差异。
|
||
'^A' 表示已添加的项。
|
||
'^C' 表示已更改的项。
|
||
'^D' 表示已删除的项。
|
||
'^M' 表示已移动的项。左侧的项是原始项,
|
||
右侧是目标项。
|
||
|
||
--^repositorypaths 打印存储库路径而不是工作区路径。
|
||
(此选项将覆盖 '--^fullpaths' 选项。)
|
||
--^download 将差异内容存储在指定的输出
|
||
路径中。
|
||
--^encoding 指定输出编码,如:utf-8。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^ignore 设置指定的比较方法。
|
||
请参阅“备注”以了解更多信息。
|
||
--^clean 不考虑由于合并而产生的
|
||
差异,仅考虑简单签入所创建的
|
||
差异。
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^dateformat 用于输出日期的格式。
|
||
--^fullpaths, --^fp 如果可能,强制打印文件和目录的完整
|
||
工作区路径。
|
||
|
||
== CMD_HELP_DIFF ==
|
||
备注:
|
||
|
||
比较方法:
|
||
^eol 忽略行尾差异。
|
||
^whitespaces 忽略空格差异。
|
||
^"eol&whitespaces" 忽略行尾和空格差异。
|
||
^none 检测行尾和空格差异。
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的参数如下:
|
||
{^path} 项路径。
|
||
{^date} 更改日期/时间。
|
||
{^owner} 更改作者。
|
||
{^revid} 在差异比较中被视为目标的修订的
|
||
修订 ID。
|
||
{^parentrevid} 在差异比较中被视为目标的修订的
|
||
父级修订 ID。
|
||
{^baserevid} 在差异比较中被视为源的修订的
|
||
修订 ID。
|
||
{^srccmpath} 移动项(移动操作)之前的服务器路径。
|
||
{^dstcmpath} 移动项(移动操作)之后的服务器路径。
|
||
{^type} 项类型:
|
||
^D 目录,
|
||
^B 二进制文件,
|
||
^F 文本文件,
|
||
^S 符号链接,
|
||
^X Xlink。
|
||
{^repository} 项的存储库。
|
||
{^status} 项状态:
|
||
^A 已添加,
|
||
^D 已删除,
|
||
^M 已移动,
|
||
^C 已更改。
|
||
{^fsprotection} 显示项权限 (Linux/Mac chmod)。
|
||
{^srcfsprotection} 显示父修订项权限。
|
||
{^newline} 插入一个新行。
|
||
|
||
有关 '^revid' 的注意事项:
|
||
对于已添加的项,'^baserevid' 和 '^parentrevid' 将为 -1,因为
|
||
在这种情况下不存在以前的修订。
|
||
对于已删除的项,'^revid' 是源修订的 ID,而
|
||
'^baserevid' 将为 -1,因为没有目标修订。
|
||
对于 Xlink,'^baserevid' 和 '^parentrevid' 都始终为 -1。
|
||
|
||
示例:
|
||
|
||
比较分支:
|
||
|
||
cm ^diff ^br:/main/task001
|
||
cm ^diff ^br:/main/task001 \doc\readme.txt
|
||
|
||
比较变更集树:
|
||
|
||
cm ^diff 19
|
||
cm ^diff 19 25
|
||
cm ^diff ^cs:19 ^cs:25 --^format="{^path} {^parentrevid}"
|
||
cm ^diff ^cs:19 ^cs:23 --^format="{^date} {^path}" --^dateformat="yy/dd/MM HH:mm:ss"
|
||
cm ^diff ^cs:19 ^cs:23 --^changed
|
||
cm ^diff ^cs:19 ^cs:23 --^repositorypaths
|
||
cm ^diff ^cs:19 ^cs:23 --^download="D:\temp"
|
||
cm ^diff ^cs:19 ^cs:23 --^clean
|
||
cm ^diff ^cs:19 ^cs:23 \doc\readme.txt
|
||
|
||
比较标签树:
|
||
|
||
cm ^diff ^lb:FirstReleaseLabel ^lb:SecondReleaseLabel
|
||
cm ^diff ^lb:tag_193.2 ^cs:34214
|
||
cm ^diff ^cs:31492 ^lb:tag_193.2
|
||
|
||
比较搁置树:
|
||
|
||
cm ^diff ^sh:2
|
||
cm ^diff ^sh:2 ^sh:4
|
||
|
||
比较修订规格:
|
||
cm ^diff ^rev:readme.txt#^cs:19 ^rev:readme.txt#^cs:20
|
||
cm ^diff ^serverpath:/doc/readme.txt#^cs:19@myrepo \
|
||
^serverpath:/doc/readme.txt#^br:/main@myrepo@localhost:8084
|
||
|
||
== CMD_DESCRIPTION_DIFFMETRICS ==
|
||
显示两个修订之间的差异比较指标。
|
||
|
||
== CMD_USAGE_DIFFMETRICS ==
|
||
用法:
|
||
|
||
cm ^diffmetrics | ^dm <修订规格 1> <修订规格 2> [--^format=<格式字符串>]
|
||
[--^encoding=<名称>]
|
||
[--^ignore=(^eol | ^whitespaces | ^"eol&whitespaces" | ^none)]
|
||
|
||
修订规格 用于比较的修订。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解修订规格。)
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^encoding 指定输出编码,如:utf-8。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^ignore 设置指定的比较方法。
|
||
请参阅“备注”以了解更多信息。
|
||
|
||
== CMD_HELP_DIFFMETRICS ==
|
||
备注:
|
||
|
||
指标为:已更改、添加和删除的行数。
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{0} 已更改的行数。
|
||
{1} 已添加的行数。
|
||
{2} 已删除的行数。
|
||
|
||
示例:
|
||
|
||
cm ^diffmetrics file.txt#^cs:2 file.txt#^br:/main/scm0211 \
|
||
--^format="已更改 {0} 行,已添加 {1} 行,已删除 {2} 行。"
|
||
(检索已格式化的差异比较指标结果。)
|
||
|
||
cm ^dm file.txt#^cs:2 file.txt#^cs:3 --^encoding=utf-8 --^ignore=^whitespaces
|
||
|
||
== CMD_DESCRIPTION_FASTEXPORT ==
|
||
以快速导出格式导出存储库。
|
||
|
||
== CMD_USAGE_FASTEXPORT ==
|
||
用法:
|
||
|
||
cm ^fast-export | ^fe <存储库规格> <快速导出文件>
|
||
[--^import-marks=<标记文件>]
|
||
[--^export-marks=<标记文件>]
|
||
[--^branchseparator=<分隔符>]
|
||
[--^nodata] [--^from=<变更集ID>] [--^to=<变更集ID>]
|
||
|
||
选项:
|
||
|
||
存储库规格 要从中导出数据的存储库。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库规格。)
|
||
快速导出文件 具有存储库数据并采用 Git 快速导出格式的
|
||
文件。
|
||
--^import-marks 用于增量导入的标记文件。此文件
|
||
已在先前由 '--^export-marks' 导出。此
|
||
文件中描述的变更集将不会被导入,
|
||
因为这些变更集已在先前被导入。
|
||
--^export-marks 所导入的变更集将保存到的文件。
|
||
此文件在以后的快速导入中用于表示
|
||
已导入的变更集。
|
||
--^branchseparator Unity VCS 使用 "/" 作为分支层次结构中的默认
|
||
分隔符。此选项允许将字符用作层次结构
|
||
分隔符,因此 main-task-sub 将在 Unity VCS 中
|
||
映射为 /main/task/sub。
|
||
--^nodata 导出存储库,但不包括数据。这对于
|
||
检查导出功能是否可正确运行很有用。
|
||
--^from 从特定变更集导出。
|
||
--^to 导出到特定变更集。
|
||
|
||
== CMD_HELP_FASTEXPORT ==
|
||
备注:
|
||
|
||
- 为了将 Unity VCS 存储库导入到 Git,请使用诸如以下命令的命令:
|
||
^cat repo.fe.00 | ^git ^fast-import --^export-marks=marks.git --^import-marks=marks.git
|
||
|
||
- 支持使用一个包含先前导入的变更集的
|
||
标记文件('--^import-marks' 和 '--^export-marks' 文件)进行增量
|
||
导出。
|
||
这意味着将仅导出在先前快速导出中未导出的
|
||
新变更集。
|
||
|
||
示例:
|
||
|
||
cm ^fast-export repo@localhost:8087 repo.fe.00 --^import-marks=marks.cm \
|
||
--^export-marks=marks.cm
|
||
(将本地服务器中的存储库 'repo' 以 Git 快速导出格式
|
||
导出到 'repo.fe.00' 文件中,并创建标记文件以稍后
|
||
执行增量导出。)
|
||
|
||
cm ^fast-export repo@localhost:8087 repo.fe.00 --^from=20
|
||
(将本地服务器中的存储库 'repo' 以 Git 快速导出格式
|
||
从变更集 '20' 导出到 'repo.fe.00' 文件中。)
|
||
|
||
== CMD_DESCRIPTION_FASTIMPORT ==
|
||
将 Git 快速导出数据导入到存储库中。
|
||
|
||
== CMD_USAGE_FASTIMPORT ==
|
||
用法:
|
||
|
||
cm ^fast-import | ^fi <存储库规格> <快速导出文件>
|
||
[--^import-marks=<标记文件>]
|
||
[--^export-marks=<标记文件>]
|
||
[--^stats] [--^branchseparator=<分隔符>]
|
||
[--^nodata] [--^ignoremissingchangesets] [--^mastertomain]
|
||
|
||
选项:
|
||
|
||
存储库规格 要将数据导入到的
|
||
存储库。如果事先不存在存储库,
|
||
则会创建该存储库。(使用 'cm ^help ^objectspec' 可进一步
|
||
了解存储库规格。)
|
||
快速导出文件 具有存储库数据并采用 Git 快速
|
||
导出格式的文件。
|
||
--^import-marks 用于增量导入的标记文件。
|
||
此文件已在先前由
|
||
'--^export-marks' 导出。此文件中描述的
|
||
变更集将不会被导入,因为这些变更集
|
||
已在先前被导入。
|
||
--^export-marks 所导入的变更集将保存到的
|
||
文件。此文件在以后的
|
||
快速导入中用于表示
|
||
已导入的变更集。
|
||
--^stats 打印一些有关导入过程的统计信息。
|
||
--^branchseparator Unity VCS 使用 "/" 作为分支层次结构
|
||
中的默认分隔符。此选项允许
|
||
将字符用作层次结构分隔符,因此 main-task-sub
|
||
将在 Unity VCS 中映射为 /main/task/sub。
|
||
--^nodata 导入 Git 快速导出结果,但不包括
|
||
数据。这对于检查导入功能是否可正确
|
||
运行很有用。
|
||
--^ignoremissingchangesets 无法导入的任何变更集都将被丢弃,
|
||
然后在没有这些变更集的情况下继续
|
||
进行快速导入操作。
|
||
--^mastertomain 使用 "^main" 而不是 "^master" 进行导入。
|
||
|
||
== CMD_HELP_FASTIMPORT ==
|
||
备注:
|
||
|
||
- 为了导出 Git 存储库,请使用诸如以下命令的命令:
|
||
^git ^fast-export --^all -^M --^signed-tags=^strip --^tag-of-filtered-object=^drop> ..\git-fast-export.dat
|
||
-^M 选项对于检测移动的项很重要。
|
||
|
||
- 如果指定的存储库不存在,则会创建该存储库。
|
||
|
||
- 支持使用一个包含先前导入的变更集的
|
||
标记文件('--^import-marks' 和 '--^export-marks' 文件)进行增量
|
||
导入。
|
||
这意味着将仅导入在先前快速导入中未导入的
|
||
新变更集。
|
||
|
||
示例:
|
||
|
||
cm ^fast-import mynewrepo@atenea:8084 repo.fast-export
|
||
(将导出到 'repo.fast-export' 文件中的内容导入到
|
||
服务器 'atenea:8084' 上的 'mynewrepo' 存储库中。)
|
||
|
||
cm ^fast-import repo@atenea:8084 repo.fast-export --^export-marks=rep.marks
|
||
(将导出到 'repo.fast-export' 文件中的内容导入到
|
||
服务器 'atenea:8084' 上的 'repo' 存储库中,并创建一个标记文件
|
||
以稍后执行增量导入。)
|
||
|
||
cm ^fast-import repo@server:8084 repo.fast-export --^import-marks=repo.marks \
|
||
--^export-marks=repo.marks
|
||
(导入 'repo.fast-export' 文件的内容。仅导入
|
||
不在标记文件中的新变更集。同样的这个
|
||
标记文件还用于再次保存变更集列表,以便进行
|
||
下一次增量导入。)
|
||
|
||
== CMD_DESCRIPTION_FILEINFO ==
|
||
检索有关工作区中的项的详细信息。
|
||
|
||
== CMD_USAGE_FILEINFO ==
|
||
用法:
|
||
|
||
cm ^fileinfo <项路径>[ ...][--^fields=<字段值>[,...]]
|
||
[[--^xml | -^x [=<输出文件>]] | [--^format=<格式字符串>]]
|
||
[--^symlink] [--^encoding=<名称>]
|
||
|
||
项路径 要显示的项。使用空格对各个项进行
|
||
分隔。
|
||
使用双引号 (" ") 指定包含空格的
|
||
路径。
|
||
|
||
选项:
|
||
|
||
--^fields 一串用逗号分隔的值。此字符串用于
|
||
选择要为每项打印的字段。请参阅“备注”
|
||
以了解更多信息。
|
||
--^xml | -^x 以 XML 格式将输出打印到标准输出。
|
||
可以指定输出文件。此选项
|
||
不能与 '--^format' 结合使用。
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。此选项不能与 '--^xml'
|
||
结合使用。
|
||
此 '--^format' 选项优先于 '--^fields'(如果同时
|
||
指定了这两者)。
|
||
--^symlink 将 fileinfo 操作应用于符号链接而不是
|
||
目标。
|
||
--^encoding 指定输出编码,如:utf-8。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
|
||
|
||
== CMD_HELP_FILEINFO ==
|
||
备注:
|
||
|
||
此命令为每个所选项打印详细的属性列表。
|
||
默认情况下,每个属性都打印在新行上。
|
||
|
||
可以修改属性列表以仅显示用户所需的
|
||
属性。为实现此目的,可以使用 '--^fields=<字段列表>',
|
||
其中会接受一串用逗号分隔的属性名称。这样就只会显示
|
||
已指明名称的那些参数。
|
||
|
||
修订头部变更集:
|
||
|
||
默认情况下会禁用此选项。请注意,检索此属性的
|
||
速度明显慢于其余属性,因此我们建议用户
|
||
将尽可能多的项组合在一起。这样可以避免
|
||
多次单独执行 'cm ^fileinfo',从而缩短执行时间。
|
||
另外,此功能当前不适用于受控目录。
|
||
|
||
您可以在下面找到可用属性名称的完整列表。
|
||
默认情况下不会显示标有星号 ('*') 的名称:
|
||
^ClientPath 项在磁盘上的本地路径。
|
||
^RelativePath 相对于工作区的路径。
|
||
^ServerPath 项的存储库路径。
|
||
(注意:此选项当前
|
||
不支持已变换的工作区)。
|
||
^Size 项大小。
|
||
^Hash 项哈希值总和。
|
||
^Owner 项所属的用户。
|
||
^RevisionHeadChangeset (*) 已加载到分支头部变更集内的
|
||
修订变更集。
|
||
(请参阅上面的注意事项。)
|
||
^RevisionChangeset 当前已加载到工作区内的
|
||
修订变更集。
|
||
^RepSpec 项的存储库规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解
|
||
存储库规格。)
|
||
^Status 工作区项状态:已添加、已签出、
|
||
已删除,等等。
|
||
^Type 修订类型(文本、二进制、目录、符号链接
|
||
或未知)。
|
||
^Changelist 项所属的更改列表(如果有)。
|
||
^IsLocked (*) 项是否已被独占签出
|
||
锁定。
|
||
^LockedBy (*) 将项独占签出的用户。
|
||
^LockedWhere (*) 将项独占签出的
|
||
位置。
|
||
^IsUnderXlink 项是否位于 Xlink
|
||
之下。
|
||
^UnderXlinkTarget 项所在的 Xlink 的目标
|
||
(如果有)。
|
||
^UnderXlinkPath 通过 Xlink 链接的存储库中的项服务器路径
|
||
(如果有)。
|
||
^UnderXlinkWritable 项所属的 Xlink 是否
|
||
可写。
|
||
^UnderXlinkRelative 项所属的 Xlink 是否
|
||
是相对 Xlink。
|
||
^IsXlink 项本身是否是 Xlink。
|
||
^XlinkTarget 项指向的目标存储库(如果项
|
||
是 Xlink)。
|
||
^XlinkName 项的 Xlink 名称(如果项实际上
|
||
是 Xlink)。
|
||
^XlinkWritable Xlink 项是否为
|
||
可写 Xlink。
|
||
^XlinkRelative Xlink 项是否为
|
||
相对 Xlink。
|
||
|
||
输出格式自定义:
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{^ClientPath}
|
||
{^RelativePath}
|
||
{^ServerPath}
|
||
{^Size}
|
||
{^Hash}
|
||
{^Owner}
|
||
{^RevisionHeadChangeset}
|
||
{^RevisionChangeset}
|
||
{^Status}
|
||
{^Type}
|
||
{^Changelist}
|
||
{^IsLocked}
|
||
{^LockedBy}
|
||
{^LockedWhere}
|
||
{^IsUnderXlink}
|
||
{^UnderXlinkTarget}
|
||
{^UnderXlinkPath}
|
||
{^UnderXlinkWritable}
|
||
{^UnderXlinkRelative}
|
||
{^IsXlink}
|
||
{^XlinkTarget}
|
||
{^XlinkName}
|
||
{^XlinkWritable}
|
||
{^XlinkRelative}
|
||
{^RepSpec}
|
||
|
||
请注意,'--^format' 和 '--^xml' 选项是互斥的,
|
||
因此不能同时使用。
|
||
|
||
示例:
|
||
|
||
cm ^fileinfo file1.txt file2.txt dir/
|
||
cm ^fileinfo "New Project.csproj" --^xml
|
||
cm ^fileinfo assets.art --^fields=^ServerPath,^Size,^IsLocked,^LockedBy
|
||
cm ^fileinfo proj_specs.docx --^fields=^ServerPath,^RevisionChangeset --^xml
|
||
cm ^fileinfo samples.ogg --^format="{^ServerPath}[{^Owner}] -> {^Size}"
|
||
|
||
== CMD_DESCRIPTION_FIND ==
|
||
运行类似 SQL 的查询以查找 Unity VCS 对象。
|
||
|
||
== CMD_USAGE_FIND ==
|
||
用法:
|
||
|
||
cm ^find <对象类型>
|
||
[^where <条件字符串>]
|
||
[^on ^repository '<存储库规格>' | ^on ^repositories '<存储库规格1>','<存储库规格2>'[,...]]
|
||
[--^format=<格式字符串>] [--^dateformat=<日期格式>]
|
||
[--^nototal] [--^file=<转储文件>] [--^xml]
|
||
[--^encoding=<名称>]
|
||
|
||
对象类型 要查找的对象类型。
|
||
(使用 'cm ^help ^showfindobjects' 可了解如何指定
|
||
这些对象。)
|
||
您还可以阅读 'cm ^find' 指南:
|
||
https://www.plasticscm.com/download/help/cmfind
|
||
|
||
选项:
|
||
|
||
条件字符串 搜索对象属性的条件。
|
||
存储库规格 搜索存储库别名或规格。
|
||
如果是 '^on ^repositories',请使用逗号
|
||
对存储库规格字段进行分隔。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
规格。)
|
||
--^format 检索特定格式的输出消息。
|
||
请阅读 'cm ^find' 指南以查看所有
|
||
可用作输出格式字符串的对象属性:
|
||
https://www.plasticscm.com/download/help/cmfind
|
||
--^dateformat 用于输出日期的格式。
|
||
--^nototal 最后不输出记录数。
|
||
--^file 转储结果的文件。
|
||
--^xml 以 XML 格式将输出打印到标准输出。
|
||
--^encoding 指定输出编码,如:utf-8。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
|
||
== CMD_HELP_FIND ==
|
||
备注:
|
||
|
||
如果未指定存储库,则在工作区中配置的存储库上
|
||
进行搜索。
|
||
|
||
从命令行中使用比较运算符(>、<、>=、<=)
|
||
运行查询时,请注意,shell 将这些运算符视为 IO
|
||
重定向。因此,需要用双引号将查询
|
||
引起来。
|
||
|
||
'cm ^find' 命令接受格式字符串以显示输出。
|
||
每个输出参数由字符串进行标识,用户可以通过
|
||
在 '{' 和 '}' 花括号之间键入参数编号来引用参数。
|
||
输出参数通常对应于对象的属性。
|
||
|
||
一些有效的输出格式字符串如下:
|
||
--^format={^id}{^date}{^name}
|
||
--^format="{^item}#{^branch} ^with ^date {^date}"
|
||
|
||
XML 和编码注意事项:
|
||
|
||
指定 '--^xml' 选项后,该命令在标准输出中将命令结果
|
||
显示为 XML 文本。文本将以操作系统的
|
||
默认编码显示,因此在控制台中可能会
|
||
错误地显示非 ANSI 字符。如果将命令输出重定向到
|
||
文件,则将正确显示输出内容。当同时指定了 '--^xml' 和 '--^file'
|
||
选项时,默认编码为 utf-8。
|
||
|
||
示例:
|
||
|
||
cm ^find ^revision
|
||
cm ^find ^revision "^where ^changeset=23 ^and ^owner='maria'"
|
||
cm ^find ^branch "^on ^repository 'rep1'"
|
||
cm ^find ^label "^on ^repositories 'rep1', '^rep:default@localhost:8084'"
|
||
cm ^find ^branch "^where ^parent='^br:/main' ^on ^repository 'rep1'"
|
||
cm ^find ^revision "^where ^item='^item:.'" --^format="{^item}#{^branch}"
|
||
cm ^find ^revision "^where ^item='^item:.'" --^xml --^file=c:\queryresults\revs.xml
|
||
|
||
== CMD_DESCRIPTION_FINDCHANGED ==
|
||
获取已更改文件的列表。已弃用此命令,保留此命令只是为了
|
||
向后兼容。请改用 'cm ^status'。
|
||
|
||
== CMD_USAGE_FINDCHANGED ==
|
||
用法:
|
||
|
||
cm ^findchanged | ^fc [-^R | -^r | --^recursive] [--^checkcontent]
|
||
[--^onlychanged] [<路径>]
|
||
|
||
选项:
|
||
|
||
-^R 以递归方式在目录中查找。
|
||
--^checkcontent 按内容比较文件。
|
||
--^onlychanged 仅查找已更改的文件;无法获得
|
||
签出。
|
||
路径 (默认值:当前目录。)
|
||
查找已更改文件的初始路径。
|
||
|
||
== CMD_HELP_FINDCHANGED ==
|
||
备注:
|
||
|
||
如果未给出 '--^checkcontent' 选项,Unity VCS 将根据文件时间戳
|
||
查找更改。当指定了 '--^checkcontent' 选项时,比较的是
|
||
文件或文件夹内容,而不使用时间戳。
|
||
|
||
与 Unity VCS 服务器断开连接的情况下,此命令对于检测
|
||
已更改的文件很有用。可以将输出通过管道传递到 checkout 命令,
|
||
从而在稍后检查更改(请参阅示例)。
|
||
|
||
示例:
|
||
|
||
cm ^findchanged .
|
||
(在当前目录中查找已更改的文件。)
|
||
|
||
cm ^findchanged -^R .| cm ^checkout -
|
||
(签出已更改的元素。)
|
||
|
||
== CMD_DESCRIPTION_FINDCHECKEDOUT ==
|
||
获取已签出项的列表。已弃用此命令,保留此命令只是为了
|
||
向后兼容。请改用 'cm ^status'。
|
||
|
||
== CMD_USAGE_FINDCHECKEDOUT ==
|
||
用法:
|
||
|
||
cm ^findcheckouts | ^fco [--^format=<格式字符串>] [--^basepath]
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^basepath 开始搜索签出的起始路径。如果
|
||
未指定,则使用当前路径。
|
||
|
||
== CMD_HELP_FINDCHECKEDOUT ==
|
||
备注:
|
||
|
||
此命令适合用于在一个步骤中签入项或撤销签出所有
|
||
已签出的项,并将标准输出重定向到其他命令。
|
||
请参阅示例。
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{0} 日期。
|
||
{1} 所有者。
|
||
{2} 工作区信息。
|
||
{3} 客户端机器名称。
|
||
{4} 项路径。
|
||
{5} 分支和存储库信息。
|
||
|
||
示例:
|
||
|
||
cm ^findcheckouts --^format="分支 {5} 上已更改的文件 {4}"
|
||
(查找已签出的项,并使用文件路径以及分支和存储库信息
|
||
来格式化输出。)
|
||
|
||
cm ^findcheckouts --^format={4} | cm ^checkin -
|
||
(签入所有已签出的项。)
|
||
|
||
cm ^findcheckouts --^format={4} | cm ^undocheckout -
|
||
(撤销签出所有已签出的项。)
|
||
|
||
== CMD_DESCRIPTION_FINDPRIVATE ==
|
||
获取私有项的列表。已弃用此命令,保留此命令只是为了
|
||
向后兼容。请改用 'cm ^status'。
|
||
|
||
== CMD_USAGE_FINDPRIVATE ==
|
||
用法:
|
||
cm ^findprivate | ^fp [-^R | -^r | --^recursive] [--^exclusions] [<路径>]
|
||
|
||
选项:
|
||
|
||
-^R 以递归方式在目录中查找。
|
||
--^exclusions 此选项允许在文件 ignore.conf 定义的
|
||
已忽略路径内禁止搜索。
|
||
路径 (默认值:当前目录。)
|
||
查找私有文件的初始路径。
|
||
|
||
== CMD_HELP_FINDPRIVATE ==
|
||
备注:
|
||
|
||
如果指定了任何路径,Unity VCS 将开始从当前目录
|
||
搜索。
|
||
|
||
此命令适合用于在文件夹上添加私有项,并将输出通过管道
|
||
传递到 add 命令。请参阅示例。
|
||
|
||
示例:
|
||
|
||
cm ^findprivate .
|
||
|
||
cm ^findprivate -^R | cm ^add -
|
||
(以递归方式搜索私有项并添加这些项。)
|
||
|
||
== CMD_DESCRIPTION_GETCONFIG ==
|
||
获取配置信息。
|
||
|
||
== CMD_USAGE_GETCONFIG ==
|
||
用法:
|
||
|
||
cm ^getconfig [^setfileasreadonly] [^location] [^extensionworkingmode]
|
||
[^extensionprefix] [^defaultrepserver]
|
||
|
||
^setfileasreadonly 返回受保护文件是否保留为
|
||
只读。
|
||
^location 返回客户端配置路径。
|
||
^extensionworkingmode 返回扩展工作模式。
|
||
^extensionprefix 返回已配置的扩展前缀。
|
||
^defaultrepserver 返回默认存储库服务器的
|
||
位置。
|
||
|
||
== CMD_HELP_GETCONFIG ==
|
||
示例:
|
||
|
||
cm ^getconfig ^setfileasreadonly
|
||
|
||
== CMD_DESCRIPTION_GETFILE ==
|
||
下载给定修订的内容。
|
||
|
||
== CMD_USAGE_GETFILE ==
|
||
用法:
|
||
|
||
cm ^getfile | ^cat <修订规格> [--^file=<输出文件>] [--^debug]
|
||
[--^symlink] [--^raw]
|
||
|
||
修订规格 对象规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解规格。)
|
||
|
||
选项:
|
||
|
||
--^file 用于保存输出的文件。默认情况下会打印在
|
||
标准输出中。
|
||
--^debug 使用目录规格时,该命令
|
||
将显示目录中的所有项、目录的修订 ID
|
||
和文件系统保护。
|
||
--^symlink 将操作应用于符号链接而不是
|
||
目标。
|
||
--^raw 显示文件的原始数据。
|
||
|
||
== CMD_HELP_GETFILE ==
|
||
示例:
|
||
|
||
cm ^cat myfile.txt#^br:/main
|
||
(在 'myfile.txt' 的分支 '^br:/main' 中获取最后一个修订。)
|
||
|
||
cm ^getfile myfile.txt#^cs:3 --^file=tmp.txt
|
||
(获取 'myfile.txt' 的变更集 3 并将该变更集写入文件 'tmp.txt'。)
|
||
|
||
cm ^cat ^serverpath:/src/foo.c#^br:/main/task003@myrepo
|
||
(在存储库 'myrepo' 中的分支 '/main/task003' 的最后一个变更集处
|
||
获取 '/src/foo.c' 的内容)
|
||
|
||
cm ^cat ^revid:1230@^rep:myrep@^repserver:myserver:8084
|
||
(获得 ID 为 1230 的修订。)
|
||
|
||
cm ^getfile ^rev:info\ --^debug
|
||
(获取 'info' 目录中的所有修订。)
|
||
|
||
== CMD_DESCRIPTION_GETREVISION ==
|
||
在工作区中加载修订。
|
||
|
||
== CMD_USAGE_GETREVISION ==
|
||
此命令会修改工作区中加载的修订,因此可能影响
|
||
以后的合并。
|
||
这是从旧版本继承的高级命令,因此请谨慎使用。
|
||
|
||
用法:
|
||
cm ^getrevision <修订规格>
|
||
|
||
修订规格 对象规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解修订规格。)
|
||
|
||
== CMD_HELP_GETREVISION ==
|
||
示例:
|
||
|
||
cm ^getrevision file.txt#^cs:3
|
||
(获取 'file.txt' 的变更集 3 修订。)
|
||
|
||
== CMD_DESCRIPTION_GETSTATUS ==
|
||
获取项的状态。
|
||
|
||
== CMD_USAGE_GETSTATUS ==
|
||
这是一个自动化命令,仅用于自动执行 'cm'。
|
||
此命令的用户友好度不如预期。
|
||
|
||
用法:
|
||
|
||
cm ^getstatus | ^gs <项路径>[ ...][--^format=<格式字符串>] [--^stats]
|
||
[-^R | -^r | --^recursive]
|
||
|
||
项路径 要获取相应状态的一个或多个项。使用双引号
|
||
(" ") 指定包含空格的路径。使用
|
||
空格对各个路径进行分隔。
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^stats 打印一些有关获取状态过程的统计信息。
|
||
-^R 以递归方式显示目录中的状态。
|
||
|
||
== CMD_HELP_GETSTATUS ==
|
||
备注:
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{0} 项路径。
|
||
{1} 项状态:
|
||
0 私有,
|
||
1 已签入,
|
||
2 已签出。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^getstatus' 命令可从 stdin 读取路径。为此,请传递
|
||
一个破折号 "-"。
|
||
示例:cm ^getstatus -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要获取哪些路径的状态。
|
||
示例:
|
||
dir /S /B *.c | cm ^getstatus --^format="路径 {0} 状态 {1}" -
|
||
(在 Windows 中,获取工作区中所有 .c 文件的状态。)
|
||
|
||
示例:
|
||
|
||
cm ^getstatus file1.txt file2.txt
|
||
(获取文件的状态。)
|
||
|
||
cm ^gs info\ -^R --^format="项 {0} 的状态为 {1}"
|
||
(获取目录及其所有项的状态,并显示
|
||
格式化的输出。)
|
||
|
||
== CMD_DESCRIPTION_GETTASKBRANCHES ==
|
||
获取与某个任务链接的分支。
|
||
|
||
== CMD_USAGE_GETTASKBRANCHES ==
|
||
这是一个自动化命令,仅用于自动执行 'cm'。
|
||
此命令的用户友好度不如预期。
|
||
|
||
用法:
|
||
|
||
cm ^gettaskbranches | ^gtb <任务名称> [--^format=<格式字符串>]
|
||
[--^dateformat=<日期格式>]
|
||
|
||
任务名称 任务标识符。
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^dateformat 用于输出日期的格式。
|
||
|
||
== CMD_HELP_GETTASKBRANCHES ==
|
||
备注:
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{^tab} 插入一个制表符空格位。
|
||
{^newline} 插入一个新行。
|
||
{^name} 分支名称。
|
||
{^owner} 分支的所有者。
|
||
{^date} 创建分支的日期。
|
||
{^type} 分支类型(如果是智能分支,则为 'T',否则为 'F')。
|
||
{^parent} 父分支。
|
||
{^comment} 分支的注释。
|
||
{^repname} 分支所在的存储库。
|
||
{^repserver} 服务器名称。
|
||
|
||
示例:
|
||
|
||
cm ^gettaskbranches 4311
|
||
cm ^gtb 4311 --^format="^br:{^name}"
|
||
cm ^gtb 4311 --^format="^br:{^name} {^date}" --^dateformat="yyyy/MM/dd HH:mm:ss"
|
||
|
||
== CMD_DESCRIPTION_GETWORKSPACEINFO ==
|
||
显示有关工作区选择器的信息。
|
||
|
||
== CMD_USAGE_GETWORKSPACEINFO ==
|
||
用法:
|
||
|
||
cm ^wi [<工作区路径>]
|
||
|
||
选项:
|
||
|
||
工作区路径 工作区在机器上的路径。
|
||
|
||
== CMD_HELP_GETWORKSPACEINFO ==
|
||
备注:
|
||
'^wi' 命令显示工作区(存储库、分支和/或标签)
|
||
的工作配置。
|
||
|
||
示例:
|
||
cm ^wi c:\mywk
|
||
|
||
== CMD_DESCRIPTION_GETWORKSPACEFROMPATH ==
|
||
从路径获取工作区信息。
|
||
|
||
== CMD_USAGE_GETWORKSPACEFROMPATH ==
|
||
这是一个自动化命令,仅用于自动执行 'cm'。
|
||
此命令的用户友好度不如预期。
|
||
|
||
用法:
|
||
|
||
cm ^getworkspacefrompath | ^gwp <项路径> [--^format=<格式字符串>]
|
||
|
||
项路径 磁盘上的文件或文件夹。
|
||
|
||
选项:
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
|
||
== CMD_HELP_GETWORKSPACEFROMPATH ==
|
||
备注:
|
||
|
||
此命令显示有关路径中的工作区的信息。
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{0} | {^wkname} 工作区名称。
|
||
{1} | {^wkpath} 工作区路径。
|
||
{2} | {^machine} 客户端机器名称。
|
||
{3} | {^owner} 工作区所有者。
|
||
{4} | {^guid} 工作区 GUID。
|
||
|
||
{^tab} 插入一个制表符空格位。
|
||
{^newline} 插入一个新行。
|
||
|
||
示例:
|
||
|
||
cm ^gwp c:\myworkspace\code\file1.cpp --^format="工作区名称:{^wkname}"
|
||
|
||
== CMD_DESCRIPTION_HELP ==
|
||
获取有关 Unity VCS 命令的帮助。
|
||
|
||
== CMD_USAGE_HELP ==
|
||
用法:
|
||
|
||
cm ^help <命令>
|
||
|
||
== CMD_HELP_HELP ==
|
||
|
||
== CMD_DESCRIPTION_IOSTATS ==
|
||
显示有关硬件的统计信息。
|
||
|
||
== CMD_USAGE_IOSTATS ==
|
||
用法:
|
||
|
||
cm ^iostats [<存储库服务器规格>] [<测试列表>[ ...]]
|
||
[--^nettotalmb=<值_mb>] [--^networkiterations=<值_迭代>]
|
||
[--^diskdatasize=<值_大小>] [--^disktestpath=<值_路径>]
|
||
[--^systemdisplaytime=<值_时间>]
|
||
[--^systemdisplaytimeinterval=<值_间隔>]
|
||
|
||
选项:
|
||
|
||
存储库服务器规格 用于执行网络测试的可用 Unity VCS
|
||
服务器,例如 "serverUploadTest"
|
||
和/或 "serverDownloadTest"。
|
||
如果未提供服务器,该命令
|
||
将尝试与默认配置的服务器
|
||
通信。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解
|
||
服务器规格。)
|
||
测试列表 可用的测试。使用空格对各个测试字段
|
||
进行分隔。
|
||
请参阅“备注”以了解更多信息。
|
||
--^nettotalmb 表示在网络测试中传输的
|
||
用户数据量(以兆字节为单位),
|
||
例如 "^serverDownloadTest" 或
|
||
"^serverUploadTest"。
|
||
值必须介于 "4" 到 "512" 之间。
|
||
(默认值:16)
|
||
--^networkiterations 表示要运行的
|
||
"^serverDownloadTest" 和/或 "^serverUploadTest"
|
||
的迭代次数。
|
||
值必须介于 "1" 到 "100" 之间。
|
||
(默认值:1)
|
||
--^diskdatasize 表示将在 "^diskTest" 上写入
|
||
并随后读取的数据量(以兆字节
|
||
为单位)。
|
||
值必须介于 "100" 到 "4096" 之间。
|
||
(默认值:512)
|
||
--^disktestpath "^diskTest" 将测试文件写入到的
|
||
路径。如果未提供此参数,
|
||
该命令将尝试使用系统临时
|
||
路径。
|
||
--^systemdisplaytime 显示系统资源使用情况的时间间隔
|
||
(单位:秒)。此选项可用于
|
||
以下测试:"^systemNetworkUsage"
|
||
和 "^systemDiskUsage"。
|
||
值必须介于 "1" 到 "3600" 之间。
|
||
(默认值:5 秒)。
|
||
--^systemdisplaytimeinterval 系统性能采样的时间间隔
|
||
(单位:秒)。此选项可用于
|
||
以下测试:
|
||
"^systemNetworkUsage" 和 "^systemDiskUsage"。
|
||
值必须介于 "1" 到 "60" 之间。
|
||
(默认值:1 秒)。
|
||
|
||
== CMD_HELP_IOSTATS ==
|
||
备注:
|
||
|
||
此命令要求在网速测试("^serverUploadTest" 和/或
|
||
"^serverDownloadTest")期间使用可用的服务器。
|
||
|
||
'--^diskTestPath' 必须指向属于要测试的物理
|
||
磁盘驱动器的路径。如果未指定路径,该命令将尝试
|
||
使用系统默认的临时路径。
|
||
指定路径的磁盘驱动器必须具有足够的可用空间才能执行
|
||
测试。
|
||
|
||
在执行命令期间,执行的测试可能导致
|
||
系统性能下降。
|
||
|
||
可用的测试:
|
||
--^serveruploadtest (默认值)测量从 Unity VCS 客户端到
|
||
服务器的数据上传速度。
|
||
--^serverdownloadtest (默认值)测量从 Unity VCS 服务器到
|
||
客户端的数据下载速度。
|
||
--^disktest (默认值)测量磁盘读取速度和磁盘
|
||
写入速度。
|
||
--^systemnetworkusage 显示当前的系统网络资源
|
||
使用情况。
|
||
(显示 Microsoft Windows 提供的网络接口
|
||
性能计数器)。
|
||
仅在 Microsoft Windows 中可用。
|
||
--^systemdiskusage 显示当前的系统物理磁盘
|
||
使用情况。
|
||
(显示 Microsoft Windows 提供的网络接口
|
||
性能计数器)。
|
||
仅在 Microsoft Windows 中可用。
|
||
|
||
示例:
|
||
|
||
cm ^iostats MYSERVER:8087 --^serveruploadtest --^serverdownloadtest --^nettotalmb=32
|
||
|
||
== CMD_DESCRIPTION_ISSUETRACKER ==
|
||
在指定的问题跟踪程序中获取、更新或查找问题状态。
|
||
|
||
== CMD_USAGE_ISSUETRACKER ==
|
||
用法:
|
||
|
||
cm ^issuetracker <名称> ^status ^get <任务_ID> <参数>[ ...]
|
||
cm ^issuetracker <名称> ^status ^update <任务_ID> <状态> <参数>[ ...]
|
||
cm ^issuetracker <名称> ^status ^find <状态> <参数>[ ...]
|
||
cm ^issuetracker <名称> ^connection ^check <参数>[ ...]
|
||
|
||
名称 要连接的问题跟踪程序的名称。
|
||
目前仅支持 Jira。
|
||
任务_ID 要查询或更新的问题的编号。
|
||
^status 问题跟踪程序中某个问题的有效状态。
|
||
|
||
Jira 参数(全部为必需参数):
|
||
|
||
--^user=<用户> 要验证身份的用户。
|
||
--^password=<密码> 用于身份验证的密码。
|
||
--^host=<URL> 问题跟踪程序的目标 URL。
|
||
--^projectkey=<密钥> Jira 项目的项目密钥。
|
||
|
||
== CMD_HELP_ISSUETRACKER ==
|
||
示例:
|
||
|
||
cm ^issuetracker jira ^status ^get 11 --^user=user@mail.es --^password=pwd \
|
||
--^host=https://user.atlassian.net --^projectkey=PRJ
|
||
(获取 'PRJ' 项目的问题 11 的状态。)
|
||
|
||
cm ^issuetracker jira ^status ^update 11 "完成" --^user=user@mail.es \
|
||
--^password=pwd --^host=https://user.atlassian.net --^projectkey=PRJ
|
||
(将 'PRJ' 项目的问题 11 的状态更新为“完成”。)
|
||
|
||
cm ^issuetracker jira ^status ^find "完成" --^user=user@mail.es --^password=pwd \
|
||
--^host=https://user.atlassian.net --^projectkey=PRJ
|
||
(为 'PRJ' 项目获取相应状态设置为“完成”的任务 ID)
|
||
|
||
cm ^issuetracker jira ^connection ^check --^user=user@mail.es --^password=pwd \
|
||
--^host=https://user.atlassian.net --^projectkey=PRJ
|
||
(检查配置参数是否有效。)
|
||
|
||
== CMD_DESCRIPTION_LICENSEINFO ==
|
||
显示许可证信息和许可证使用情况。
|
||
|
||
== CMD_USAGE_LICENSEINFO ==
|
||
用法:
|
||
|
||
cm ^licenseinfo | ^li [--^server=<存储库服务器规格>] [--^inactive] [--^active]
|
||
[--^sort=(^name|^status)]
|
||
|
||
选项:
|
||
|
||
--^server 从指定的服务器获取许可证信息。
|
||
如果未指定服务器,则在客户端上配置的
|
||
服务器上执行命令。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
服务器规格。)
|
||
--^inactive 在“许可证使用情况”部分中仅显示非活动用户。
|
||
--^active 在“许可证使用情况”部分中仅显示活动用户。
|
||
--^sort 按指定的排序选项之一对用户进行排序:
|
||
'^name' 或 '^status'。
|
||
|
||
== CMD_HELP_LICENSEINFO ==
|
||
备注:
|
||
|
||
显示的信息包括到期日期、已激活的用户和
|
||
已停用的用户等。
|
||
|
||
示例:
|
||
|
||
cm ^licenseinfo
|
||
cm ^licenseinfo --^server=myserver:8084
|
||
cm ^licenseinfo --^sort=^name
|
||
|
||
== CMD_DESCRIPTION_LINKTASK ==
|
||
将变更集链接到任务。
|
||
|
||
== CMD_USAGE_LINKTASK ==
|
||
这是一个自动化命令,仅用于自动执行 'cm'。
|
||
此命令的用户友好度不如预期。
|
||
|
||
用法:
|
||
|
||
cm ^linktask | ^lt <变更集规格> <扩展前缀> <任务名称>
|
||
|
||
变更集规格 要链接到任务的完整变更集规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集
|
||
规格。)
|
||
扩展前缀 要使用的已配置问题跟踪系统的
|
||
扩展前缀。
|
||
任务名称 问题跟踪系统上的任务标识符。
|
||
|
||
== CMD_HELP_LINKTASK ==
|
||
示例:
|
||
|
||
cm ^lt ^cs:8@^rep:default@^repserver:localhost:8084 jira PRJ-1
|
||
|
||
== CMD_DESCRIPTION_LOCK_LIST ==
|
||
显示服务器上的锁定情况。
|
||
|
||
== CMD_USAGE_LOCK_LIST ==
|
||
用法:
|
||
|
||
cm ^lock ^list | ^ls [<修订规格 > [ ...]] [--^server=<服务器>]
|
||
[--^onlycurrentuser] [--^onlycurrentworkspace]
|
||
[--^ignorecase]
|
||
|
||
修订规格 如果存在一个或多个修订,则此命令将
|
||
为每个指定的修订显示一个锁定行
|
||
(如果在服务器中锁定了该修订的关联项)。否则,
|
||
此命令将列出默认服务器中的所有锁定项
|
||
(或者使用 '--^server' 选项来设置的已锁定项)
|
||
使用多个修订规格时,使用空格对各个修订规格
|
||
进行分隔。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解修订规格。)
|
||
|
||
选项:
|
||
|
||
--^server 存储库服务器规格。
|
||
此选项将覆盖从当前工作区
|
||
或 client.conf 文件检索到的默认
|
||
服务器。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解
|
||
服务器规格。)
|
||
--^onlycurrentuser 筛选结果,仅显示当前用户
|
||
执行的锁定。
|
||
--^onlycurrentworkspace 筛选结果,仅显示对当前工作区
|
||
执行的锁定(按名称进行匹配)。
|
||
--^ignorecase 使用服务器路径规格时,忽略路径中的
|
||
大小写。使用此标志后,即使用户写入 "/sRc/fOO.c",
|
||
该命令也将对 "/src/foo.c" 有效。
|
||
|
||
== CMD_HELP_LOCK_LIST ==
|
||
备注:
|
||
|
||
该命令将列出默认服务器中当前
|
||
已锁定的项。该命令还接受若干修订规格;在这种
|
||
情况下,仅显示属于所选项的锁定。
|
||
可使用 '--^server=<服务器>' 来设置要查询的默认服务器。
|
||
|
||
该命令针对指定服务器中的每个锁定都会显示一行:
|
||
- 已锁定项的 GUID。
|
||
- 执行锁定的用户名。
|
||
- 锁定操作所在的工作区的名称。
|
||
- 锁定项的路径(服务器路径格式)。
|
||
|
||
示例:
|
||
|
||
cm ^lock ^list
|
||
cm ^lock ^list --^server=myserver:8084
|
||
cm ^lock ^ls ^serverpath:/src/foo.c#^cs:99@default@localhost:8084
|
||
cm ^lock ^list ^revid:3521@default ^itemid:2381@secondary --^onlycurrentuser
|
||
cm ^lock ^ls --^onlycurrentuser
|
||
cm ^lock ^ls --^onlycurrentuser --^onlycurrentworkspace
|
||
|
||
== CMD_DESCRIPTION_LISTUSERS ==
|
||
列出用户和组。
|
||
|
||
== CMD_USAGE_LISTUSERS ==
|
||
用法:
|
||
|
||
cm ^listusers | ^lu <存储库服务器规格> [--^onlyusers] [--^onlygroups]
|
||
[--^filter= <筛选器字符串>]
|
||
|
||
存储库服务器规格 存储库服务器规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
选项:
|
||
|
||
--^onlyusers 仅列出用户。
|
||
--^onlygroups 仅列出组。
|
||
--^filter 仅列出匹配指定筛选器的用户
|
||
和/或组。
|
||
|
||
== CMD_HELP_LISTUSERS ==
|
||
示例:
|
||
|
||
cm ^lu localhost:8084
|
||
(列出服务器中的所有用户。)
|
||
|
||
cm ^listusers localhost:8084 --^onlyusers --^filter=m
|
||
(仅列出服务器中包含 "m" 的用户。)
|
||
|
||
== CMD_DESCRIPTION_LOCATION ==
|
||
返回 'cm' 的路径。
|
||
|
||
== CMD_USAGE_LOCATION ==
|
||
用法:
|
||
|
||
cm ^location
|
||
|
||
== CMD_HELP_LOCATION ==
|
||
|
||
== CMD_DESCRIPTION_LOCK ==
|
||
此命令允许用户管理锁定。
|
||
|
||
== CMD_USAGE_LOCK ==
|
||
用法:
|
||
|
||
cm ^lock <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^list | ^ls
|
||
^unlock
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^lock <命令> --^usage
|
||
cm ^lock <命令> --^help
|
||
|
||
== CMD_HELP_LOCK ==
|
||
示例:
|
||
|
||
cm ^lock ^list
|
||
cm ^lock
|
||
(如果没有参数,则 '^list' 为可选项。)
|
||
cm ^lock ^ls ^serverpath:/src/foo.c#^cs:99@default@localhost:8084
|
||
cm ^lock ^unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
|
||
|
||
== CMD_DESCRIPTION_LOG ==
|
||
获取有关变更集内的修订的信息。
|
||
|
||
== CMD_USAGE_LOG ==
|
||
用法:
|
||
|
||
cm ^log [<变更集规格> | <存储库规格>] [--^from=<变更集规格起点>] [--^allbranches]
|
||
[--^ancestors] [--^csformat=<格式字符串>] [--^itemformat=<格式字符串>]
|
||
[--^xml[=<输出文件>]] [--^encoding=<名称>]
|
||
[--^repositorypaths | --^fullpaths | --^fp]
|
||
|
||
选项:
|
||
|
||
变更集规格 该命令将返回在相应规格的变更集内
|
||
所做的所有更改。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集
|
||
规格。)
|
||
存储库规格 该命令将列出在指定存储库中进行的
|
||
所有更改。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
规格。)
|
||
--^from 列出从变更集规格 [变更集规格起点]
|
||
到变更集规格 [变更集规格] 的每个变更集内
|
||
进行的所有更改。
|
||
[变更集规格起点] 变更集不包含在
|
||
输出中。
|
||
提供存储库规格后会忽略此选项。
|
||
--^allbranches 对于创建了相应变更集的所有分支,
|
||
显示指定时间间隔内创建的
|
||
这些变更集的相关信息。
|
||
--^ancestors 显示可通过给定变更集([变更集规格])的
|
||
父链接和合并链接来访问的变更集
|
||
的相关信息。如果也提供了起点
|
||
变更集([变更集规格起点]),此变更集将用作
|
||
所有路径的下限。备注:使用此选项时,
|
||
不会显示变更集更改。
|
||
--^csformat 检索特定格式的变更集信息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^itemformat 检索特定格式的项信息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^xml 以 XML 格式将输出打印到标准输出。
|
||
可以指定输出文件。
|
||
--^encoding 与 '--^xml' 选项结合使用,指定要在 XML 输出
|
||
中使用的编码(例如:utf-8)。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^fullpaths, --^fp 如果可能,强制打印文件和目录的完整
|
||
工作区路径。
|
||
--^repositorypaths 打印存储库路径(服务器路径)
|
||
而不是工作区路径。(此选项将覆盖
|
||
'--^fullpaths' 选项。)
|
||
|
||
== CMD_HELP_LOG ==
|
||
备注:
|
||
|
||
- 如果“变更集规格”和选项均未指定,该命令将显示
|
||
每个分支中上个月内创建的每个变更集的
|
||
相关信息。
|
||
- 如果仅包含 '--^from' 选项,该命令显示
|
||
在创建指定变更集的分支中从该变更集到最后一个
|
||
变更集的每个变更集的相关信息。
|
||
- 如果显示不带时间间隔的选项 '--^allbranches',
|
||
该命令会检索与仅指定“变更集规格”时相同的
|
||
信息。
|
||
- 如果使用 '--^from',输出包含从“变更集规格起点”+1 开始的
|
||
变更集的信息。
|
||
- 用于显示变更集信息的存储库就是在执行命令的
|
||
路径中加载的存储库。
|
||
|
||
此命令接受项的格式字符串 ('--^itemformat') 以及
|
||
变更集的格式字符串 ('--^csformat')。
|
||
|
||
'--^csformat' 的输出参数如下:
|
||
{^tab} 插入一个制表符空格位。
|
||
{^newline} 插入一个新行。
|
||
{^changesetid} 变更集编号。
|
||
{^branch} 在其中创建变更集的分支。
|
||
{^date} 变更集的日期。
|
||
{^owner} 变更集的所有者。
|
||
{^comment} 变更集的注释。
|
||
{^items} 变更集内涉及的项。
|
||
{^repository} 变更集所在的存储库。
|
||
{^repserver} 服务器名称。
|
||
|
||
'--^itemformat' 的输出参数如下:
|
||
{^tab} 插入一个制表符空格位。
|
||
{^newline} 插入一个新行。
|
||
{^path} 项路径。
|
||
{^branch} 在其中创建变更集的分支。
|
||
{^date} 变更集的日期。
|
||
{^owner} 变更集的所有者。
|
||
{^shortstatus} 打印短格式。请参阅下文。
|
||
{^fullstatus} 打印长格式。请参阅下文。
|
||
|
||
短格式及其对应的长格式:
|
||
'^A' ^Added
|
||
'^D' ^Deleted
|
||
'^M' ^Moved
|
||
'^C' ^Changed
|
||
|
||
这些是有效的输出字符串:
|
||
--^csformat="{^newline}变更集 {^changesetid} 创建于 {^date};{^tab} 已更改项:{^items}。"
|
||
--^itemformat="{^newline}分支 {^branch} 中的项 {^path} 已更改。"
|
||
|
||
示例:
|
||
|
||
cm ^log
|
||
(显示每个分支中上个月创建的每个变更集的相关
|
||
信息。)
|
||
|
||
cm ^log ^cs:16
|
||
(显示在其中创建变更集的分支内的变更集 16 中
|
||
所做更改的相关信息。)
|
||
|
||
cm ^log ^cs:16 --^csformat="{^newline}变更集 {^changesetid} 创建于 \
|
||
{^date};{^tab} 已更改项:{^items}。"
|
||
(按指定格式显示此信息。)
|
||
|
||
cm ^log --^from=^cs:20 ^cs:50
|
||
(显示从变更集 21 到变更集 50 的每个变更集中包含的
|
||
每个修订的相关信息。)
|
||
|
||
cm ^log --^from=^cs:20 ^cs:50 --^allbranches
|
||
(显示存储库的每个分支中从变更集 21 到
|
||
变更集 50 的每个变更集中包含的每个修订的
|
||
相关信息。)
|
||
|
||
cm ^log ^rep:myrep@localhost:8084
|
||
(显示在指定存储库中进行的更改的相关信息。
|
||
无需工作区也可运行此命令。)
|
||
|
||
cm ^log --^from=^cs:20@^rep:mainRep@localhost:8084
|
||
(显示从变更集 21 开始的每个变更集内包含的每个修订
|
||
的相关信息。无需工作区也可运行此命令,因为
|
||
已指定完整变更集规格。)
|
||
|
||
== CMD_DESCRIPTION_LIST ==
|
||
列出树的内容。
|
||
|
||
== CMD_USAGE_LIST ==
|
||
用法:
|
||
|
||
cm ^ls | ^dir [<路径>[ ...]] [--^format=<格式字符串>] [--^symlink]
|
||
[--^selector[=<选择器格式>]] [--^tree=<对象规格>]
|
||
[-^R | -^r | --^recursive]
|
||
[--^xml[=<输出文件>]] [--^encoding=<名称>]
|
||
|
||
选项:
|
||
|
||
路径 要显示的路径的列表。使用空格对各个路径进行
|
||
分隔。
|
||
使用双引号 (" ") 指定包含空格的
|
||
路径。
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^symlink 将操作应用于符号链接而不是
|
||
目标。
|
||
--^selector 从活动的工作区选择器获取内容。
|
||
如果已指定选择器格式,则列出
|
||
指定的选择器。
|
||
自 Plastic SCM 4.x 开始,选择器不再是 Unity VCS
|
||
的重要特性,因此大多数情况下已弃用。
|
||
--^tree 列出指定变更集或分支中的树。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
-^R 以递归方式列出。
|
||
--^xml 以 XML 格式将输出打印到标准输出。
|
||
可以指定输出文件。
|
||
--^encoding 与 '--^xml' 选项结合使用,指定要在 XML 输出
|
||
中使用的编码(例如:utf-8)。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
|
||
== CMD_HELP_LIST ==
|
||
备注:
|
||
|
||
- 可以使用元字符来键入路径。
|
||
- 此列表取决于工作区选择器。
|
||
- 可以指定格式字符串,从而将命令的输出格式化。
|
||
- 如果指定 '--^tree' 或 '--^selector' 选项,则给定的
|
||
路径必须是服务器路径(也就是:'cm path'):/dir/file.txt,而不是
|
||
工作区路径:C:\Users\myuser\mywk\dir\file.txt
|
||
- 如果未提供路径,则认为工作区路径是当前
|
||
目录。如果使用 '--^tree' 或 '--^selector' 选项,
|
||
则采用根路径 ("/")。
|
||
|
||
默认格式字符串为:
|
||
"{^size,10} {^date:dd/MM/yyyy} {^date:HH:mm}\
|
||
{^type,-6} {^location,-12} {^checkout,-5} {^name}\
|
||
{^symlinktarget}"
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{^size}
|
||
{^formattedsize}
|
||
{^date}
|
||
{^type}
|
||
^dir 目录,
|
||
^txt 文本文件,
|
||
^File 文件。
|
||
{^location} 示例:^br:branch#cset
|
||
{^checkout}
|
||
{^name}
|
||
{^changeset}
|
||
{^path}
|
||
{^repspec}
|
||
{^owner}
|
||
{^revid}
|
||
{^parentrevid}
|
||
{^itemid}
|
||
{^brid}
|
||
{^repid}
|
||
{^server}
|
||
{^symlinktarget}
|
||
{^hash}
|
||
{^chmod}
|
||
{^wkpath} 相对于工作区根目录的路径
|
||
{^branch}
|
||
{^newlocation} cset@branch
|
||
{^guid} (将需要更长时间来解析)
|
||
{^itemguid}
|
||
{^transformed} 显示已变换项的适用规则
|
||
|
||
可以设置 PLASTIC_LS_FORMAT 环境变量以便自定义
|
||
'^ls' 格式。
|
||
|
||
示例:
|
||
|
||
cm ^ls
|
||
cm ^ls c:\workspace\src
|
||
|
||
cm ^ls --^format={^name}
|
||
(仅文件名。)
|
||
|
||
cm ^ls --^symlink
|
||
(显示有关符号链接的信息,而不是“符号链接”的文件或
|
||
目录。适用于 UNIX 环境。)
|
||
|
||
cm ^ls code --^selector
|
||
(显示当前工作区选择器中 'code' 子目录的
|
||
内容。)
|
||
|
||
cm ^ls /code --^selector="^rep 'myrep' ^path '/' ^branch '/^main'"
|
||
(显示指定选择器中 '/code' 子目录的内容。
|
||
请注意,该路径是按服务器格式指定的。)
|
||
|
||
cm ^ls /code --^tree=44@myrep@denver:7070
|
||
(列出服务器 'denver:7070' 存储库 'myrep' 变更集 44 的
|
||
'/code' 子目录。)
|
||
|
||
cm ^ls /code --^tree=^br:/main/scm13596@myrep@denver:7070
|
||
(列出服务器 'denver:7070' 存储库 'myrep' 分支
|
||
'/main/scm13596' 中的最新变更集的 '/code' 子目录。)
|
||
|
||
cm ^ls /code --^tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@myrep@denver:7070
|
||
(列出服务器 'denver:7070' 存储库 'myrep'
|
||
的变更集 ae1390ed-7ce9-4ec3-a155-e5a61de0dc77 的
|
||
'/code' 子目录。)
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_LIST ==
|
||
列出服务器上给定类型的触发器。
|
||
|
||
== CMD_USAGE_TRIGGER_LIST ==
|
||
用法:
|
||
|
||
cm ^trigger | ^tr ^list | ^ls [<子类型-类型>] [--^server=<存储库服务器规格>]
|
||
[--^format=<格式字符串>]
|
||
|
||
选项:
|
||
|
||
子类型-类型 触发器执行和触发器操作。
|
||
键入 'cm ^showtriggertypes' 可查看触发器类型
|
||
列表。
|
||
--^server 列出指定服务器上的触发器。
|
||
如果未指定服务器,则在客户端上配置的
|
||
服务器上执行命令。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解服务器
|
||
规格。)
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
|
||
== CMD_HELP_TRIGGER_LIST ==
|
||
备注:
|
||
|
||
如果未指定类型,则列出服务器上的所有触发器。
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{0} 触发器位置。
|
||
{1} 触发器名称。
|
||
{2} 触发器路径。
|
||
{3} 触发器所有者。
|
||
{4} 触发器类型。
|
||
{5} 触发器筛选器。
|
||
|
||
示例:
|
||
cm ^trigger list after-mklabel
|
||
cm ^tr ^ls ^before-mkbranch --^server=myserver:8084
|
||
|
||
== CMD_DESCRIPTION_MANIPULATESELECTOR ==
|
||
将选择器更改为日期。
|
||
|
||
== CMD_USAGE_MANIPULATESELECTOR ==
|
||
这是一个自动化命令,仅用于自动执行 'cm'。
|
||
此命令的用户友好度不如预期。
|
||
|
||
用法:
|
||
|
||
cm ^manipulateselector | ^ms [<工作区路径> | <工作区规格>] --^atdate=<选择器日期>
|
||
|
||
工作区路径 工作区的路径。
|
||
工作区规格 工作区的规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解规格。)
|
||
选项:
|
||
|
||
--^atdate 返回一个选择器以用于重新创建工作区,
|
||
就像在指定日期看到的工作区一样。
|
||
|
||
== CMD_HELP_MANIPULATESELECTOR ==
|
||
备注:
|
||
|
||
如果路径和工作区规格均未指定,则该命令将采用
|
||
当前目录作为工作区路径。
|
||
|
||
示例:
|
||
|
||
cm ^manipulateselector c:\workspace --^atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm ^manipulateselector --^atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm ^manipulateselector > mySelector.txt --^atdate=yyyy-MM-ddTHH:mm:ss
|
||
cm ^manipulateselector ^wk:build_wk@BUILDER --^atdate=yyyy-MM-ddTHH:mm:ss
|
||
|
||
== CMD_DESCRIPTION_MERGE ==
|
||
将一个分支与另一个分支合并。
|
||
|
||
== CMD_USAGE_MERGE ==
|
||
用法:
|
||
|
||
cm ^merge <源规格> [--^merge] [--^cherrypicking] [--^forced]
|
||
[--^mergetype=(^onlyone|^onlysrc|^onlydst|^try|^forced)]
|
||
[--^interval-origin=<变更集规格> | --^ancestor=<变更集规格>]
|
||
[--^keepsource | --^ks] [--^keepdestination | --^kd]
|
||
[--^automaticresolution=<冲突类型>[;...]]
|
||
[--^subtractive] [--^mount] [--^printcontributors]
|
||
[--^noprintoperations] [--^silent]
|
||
[(--^to=<分支规格> | --^destination=<分支规格>)[--^shelve]]
|
||
[--^no-dst-changes]
|
||
[-^c=<注释字符串> | --^commentsfile=<注释文件>]
|
||
[--^resolveconflict --^conflict=<索引>
|
||
--^resolutionoption=(^src|^dst|(^rename --^resolutioninfo=<字符串名称>))
|
||
--^mergeresultfile=<路径> --^solvedconflictsfile=<路径>]
|
||
[--^nointeractiveresolution]
|
||
[--^machinereadable [--^startlineseparator=<分隔符>]
|
||
[--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
|
||
|
||
源规格 要合并的源对象的规格:
|
||
- 分支规格:'[^br:/]br_name'
|
||
- 标签规格:'^lb:lb_name'
|
||
- 变更集规格:'^cs:cs_number'
|
||
- 搁置规格:'^sh:shelve_number'
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
选项:
|
||
|
||
--^merge 执行合并。否则,打印找到的
|
||
冲突。
|
||
--^cherrypicking 合并源变更集内包含的
|
||
变更。如果合并源规格是标签,
|
||
则不会使用此选项。
|
||
--^forced 不检查源和目标是否
|
||
已连接。
|
||
此选项仅可用于间隔合并
|
||
和挑拣。
|
||
--^mergetype 请参阅“备注”以了解更多信息。
|
||
--^interval-origin 指定将哪个变更集选为
|
||
间隔原点,以便合并仅考虑
|
||
源变更集与指定间隔原点
|
||
之间的差异。
|
||
--^ancestor 这是 --^interval-origin 的别名。
|
||
--^keepsource 对于有冲突的项,接受源参与者
|
||
的所有更改。
|
||
--^keepdestination 对于有冲突的项,保留目标参与者
|
||
的更改。
|
||
--^automaticresolution 用于解决目录冲突。此选项
|
||
可让您决定应该自动选择
|
||
源参与者还是目标参与者
|
||
来解决冲突。
|
||
使用分号对各个冲突类型进行分隔。
|
||
请参阅“备注”以了解更多信息。
|
||
--^subtractive 删除由合并引入的更改。传递给
|
||
命令的参数(源规格)用于
|
||
指定要删除哪个源的
|
||
更改。必须是变更集。如果是变更集
|
||
间隔,必须使用 '--^interval-origin' 来
|
||
定义间隔原点。为了删除更改,
|
||
系统将创建一个新的已签出修订,
|
||
该修订将具有上一个
|
||
修订的内容(不包含已删除的更改)。
|
||
--^mount 给定存储库的装入点。
|
||
--^printcontributors 打印参与者(基项、源和
|
||
目标)。
|
||
--^noprintoperations 以静默方式解决合并问题,
|
||
不显示有关解决情况的信息。
|
||
--^silent 不显示任何输出。
|
||
--^to | --^destination 对指定分支执行“合并到”操作
|
||
(通过输入分支规格)
|
||
并完全解决冲突。
|
||
“合并到”(或无工作区的合并)是在
|
||
服务器端进行的合并。正常的合并
|
||
发生在“从”分支、标签或变更集合并的
|
||
工作区上,而“合并到”完全发生
|
||
在服务器上。在正常合并中,
|
||
“目标”是工作区,而在“合并到”中,
|
||
必须始终指定目标(这就是称之为
|
||
“到”的原因)。
|
||
请查看以下链接以了解关于
|
||
“合并到”功能的更多信息:
|
||
https://www.plasticscm.com/download/help/mergeto
|
||
--^shelve 使用合并结果的更改(加上合并
|
||
可追溯性信息)来创建一个搁置,
|
||
而不是创建新的变更集。合并源为
|
||
搁置时,此选项不可用。该选项
|
||
仅可用于服务器端合并
|
||
(又称为“合并到”)。因此,需要 '--^to' 和
|
||
'--^merge' 选项。
|
||
--^no-dst-changes 确保目标参与者不具有
|
||
更改(目标变更集也是
|
||
共同上级)。目标上存在更改时,
|
||
不允许合并。
|
||
-^c 将指定的注释应用于合并操作中
|
||
创建的变更集。
|
||
--^commentsfile 将指定文件中的注释应用于合并操作中
|
||
创建的变更集。
|
||
--^resolveconflict (主要由插件使用。请参阅“备注”以了解更多信息。)
|
||
用于解决目录冲突。
|
||
--^conflict 与 '--^resolveconflict' 标志结合使用,指定
|
||
要解决的冲突的索引(从 1 开始)。
|
||
--^resolutionoption 与 '--^resolveconflict' 标志结合使用,指示
|
||
冲突解决类型。使用以下
|
||
选项之一:'^src'、'^dst'、'^rename'。
|
||
请参阅“备注”以了解更多信息。
|
||
--^resolutioninfo 与 '--^resolveconflict' 标志结合使用,提供在
|
||
'--^resolutionoption' 选项为 'rename' 时
|
||
要使用的名称。
|
||
--^mergeresultfile 与 '--^resolveconflict' 标志结合使用,将
|
||
不同调用之间的合并结果的信息
|
||
输出到文件中。指定的路径将在第一次
|
||
调用期间创建,并在每个后续
|
||
调用时更新。
|
||
--^solvedconflictsfile 与 '--^resolveconflict' 标志结合使用,
|
||
将不同调用之间已解决的冲突
|
||
的信息输出到文件中。指定的路径
|
||
将在第一次调用期间创建,并在每个
|
||
后续调用时更新。
|
||
--^nointeractiveresolution (主要由插件使用。请参阅“备注”以了解更多信息。)
|
||
避免提示用户已发生手动冲突。
|
||
这样就不会解决目录冲突。
|
||
--^machinereadable (主要由插件使用。请参阅“备注”以了解更多信息。)
|
||
以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何开头。(默认值:空字符串。)
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何结尾。(默认值:空字符串。)
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
应如何分隔字段。(默认值:
|
||
空格。)
|
||
|
||
== CMD_HELP_MERGE ==
|
||
备注:
|
||
|
||
此命令用于合并两个分支之间或标签与
|
||
分支之间的更改。合并的目标必须始终为分支。
|
||
合并源将指定为参数。
|
||
目标是工作区的当前内容。
|
||
例如,要显示从分支 task001 合并到主分支
|
||
的元素,选择器必须指向主分支,
|
||
工作区必须完成更新,然后:
|
||
cm ^merge ^br:/task001
|
||
|
||
添加 '--^merge' 选项来切实执行合并:
|
||
cm ^merge ^br:/task001 --^merge
|
||
|
||
要定义合并源,可以使用以下规格:
|
||
|
||
- 分支规格:
|
||
[^br:/]br_name
|
||
示例:^br:/main/task001
|
||
(以上示例从此分支上的最后一个变更集执行合并。)
|
||
|
||
- 标签规格:
|
||
^lb:lb_name
|
||
示例:^lb:BL001
|
||
(从标记的变更集合并。)
|
||
|
||
- 变更集规格:
|
||
^cs:cs_number
|
||
示例:^cs:25
|
||
(从给定的变更集内容合并。)
|
||
|
||
- 搁置规格:
|
||
^sh:shelve_number
|
||
示例:^sh:2
|
||
(从给定的搁置内容合并。)
|
||
|
||
要自动解决目录冲突,请使用 '--^automaticresolution'
|
||
选项并指定冲突类型,然后指定在合并操作
|
||
期间必须选择的参与者(源或目标)。
|
||
(使用分号 (;) 对各个“冲突类型”-“参与者”对进行分隔。)
|
||
例如:
|
||
cm ^merge ^cs:2634 --^merge --^automaticresolution=^eviltwin-src;^changedelete-src
|
||
(自变更集 2634 开始的合并操作将会解决 "^eviltwin" 和
|
||
"^changedelete" 冲突,解决方法是在两种情况下保留源 ("-^src")
|
||
参与者)。
|
||
- 冲突类型之后的 "-^src" 后缀告诉合并命令保留
|
||
源参与者更改。
|
||
- "-^dst" 后缀将保留目标参与者更改。
|
||
以下是合并命令支持的冲突类型的列表:
|
||
"^movedeviltwin"、"^eviltwin"、"^changedelete"、"^deletechange"、"^movedelete"、
|
||
"^deletemove"、"^loadedtwice"、"^addmove"、"^moveadd"、"^divergentmove"、
|
||
"^cyclemove"、"^all"。
|
||
"^all" 值会覆盖其他选项。在以下示例中,
|
||
"^eviltwin-dst" 将被忽略:
|
||
cm ^merge ^br:/main/task062 --^merge --^automaticresolution=^all-src;^eviltwin-dst
|
||
请查看以下链接以了解关于合并冲突的更多信息:
|
||
https://www.plasticscm.com/download/help/directorymerges
|
||
|
||
以下是 '--^mergetype' 的选项:
|
||
^onlyone 仅有一个参与者修改了该项的情况下,才进行
|
||
自动合并。
|
||
^onlysrc 仅有一个源参与者修改了该项的情况下,才进行
|
||
自动合并。
|
||
^onlydst 仅有一个目标参与者修改了该项的情况下,才进行
|
||
自动合并。
|
||
^try 仅有一个参与者修改了冲突代码段(每个冲突)
|
||
的情况下,才进行自动合并。
|
||
^forced 始终尝试解决所有非自动冲突。
|
||
|
||
以下是主要由插件和集成使用的选项:
|
||
- '--^resolveconflict',用于解决目录冲突。还必须使用
|
||
以下选项:
|
||
- '--^conflict' 是要解决的冲突的索引
|
||
(从 1 开始)。
|
||
- '--^resolutionoption' 指示要使用的冲突解决
|
||
方法。选项可以是:
|
||
- '^src',用于保留源更改而放弃
|
||
目标更改
|
||
- '^dst',用于保留目标更改而放弃
|
||
源更改
|
||
- '^rename'(仅在冲突类型支持此解决方法
|
||
的情况下),用于将目标重命名为
|
||
通过 '--^resolutioninfo' 选项提供的给定名称。
|
||
- '--^resolutioninfo',用于提供在 '^rename' 解决
|
||
方法中使用的名称
|
||
- '--^mergeresultfile' 和 '--^solvedconflictsfile',这两者用于
|
||
存储不同调用之间的合并信息。
|
||
- '--^nointeractiveresolution' 指示合并操作不要求用户
|
||
进行手动冲突解决。
|
||
- '--^machinereadable' 和 '--^startlineseparator'、'--^endlineseparator'、
|
||
'--^fieldseparator' 选项,用于以机器可读的方式
|
||
(易于解析)打印输出。
|
||
示例:
|
||
cm ^merge --^machinereadable --^startlineseparator=start@_@line \
|
||
--^endlineseparator=new@_@line --^fieldseparator=def#_#sep \
|
||
--^mergeresultfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6C.tmp \
|
||
--^solvedconflictsfile=C:\Users\Borja\AppData\Local\Temp\2tmp4D6D.tmp \
|
||
--^resolveconflict --^conflict=1 --^resolutionoption=rename \
|
||
--^resolutioninfo=bin_dst ^br:/main/task --^merge
|
||
|
||
示例:
|
||
|
||
cm ^merge ^br:/task001
|
||
(不合并,仅打印要合并的项。)
|
||
|
||
cm ^merge ^br:/task001 --^merge
|
||
(从分支 'task001' 进行合并。)
|
||
|
||
cm ^merge ^cs:5 --^merge --^cherrypicking --^interval-origin=^cs:2
|
||
(从变更集间隔 (2,5] 进行挑拣。)
|
||
|
||
cm ^merge ^cs:8 --^merge --^subtractive --^keepdestination
|
||
(从变更集 8 进行减法合并,保留那些有冲突的
|
||
元素的目标更改。)
|
||
|
||
cm ^merge ^br:/main/task001 --^to=^br:/main --^merge -^c="集成的新 UI"
|
||
(进行从分支 'task001' 到分支 'main' 的服务器端合并
|
||
(又称为“合并到”),并设置注释。)
|
||
|
||
cm ^merge ^br:/main/task001 --^to=^br:/main --^merge --^shelve
|
||
(进行从分支 'task001' 到分支 'main' 的服务器端合并,
|
||
并将结果保留在搁置中。)
|
||
|
||
cm ^merge ^sh:2 --^to=^br:/main --^merge --^no-dst-changes
|
||
(仅在从当前的 'main' 头部创建时,才将搁置 2
|
||
应用于 'main')
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_CREATE ==
|
||
创建新的属性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_CREATE ==
|
||
用法:
|
||
|
||
cm ^attribute | ^att ^create | ^mk <属性名>
|
||
|
||
属性名 属性名称
|
||
|
||
== CMD_HELP_ATTRIBUTE_CREATE ==
|
||
示例:
|
||
|
||
cm ^attribute ^create 状态
|
||
(创建属性 '状态'。)
|
||
|
||
cm ^att ^mk 集成
|
||
(创建属性 '集成'。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH ==
|
||
允许用户管理分支。
|
||
|
||
== CMD_USAGE_BRANCH ==
|
||
用法:
|
||
|
||
cm ^branch | ^br <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^rename
|
||
^history
|
||
^showmain
|
||
^showmerges
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^branch <命令> --^usage
|
||
cm ^branch <命令> --^help
|
||
|
||
== CMD_HELP_BRANCH ==
|
||
示例:
|
||
|
||
cm ^branch /main/scm21345
|
||
cm ^branch ^create /main/scm21345
|
||
cm ^branch ^delete /main/scm21345
|
||
cm ^branch ^rename /main/scm21345 scm21346
|
||
cm ^branch ^history /main/scm21345
|
||
cm ^branch ^showmain
|
||
cm ^branch ^showmerges file.txt
|
||
|
||
== CMD_DESCRIPTION_BRANCH_CREATE ==
|
||
创建新的分支。
|
||
|
||
== CMD_USAGE_BRANCH_CREATE ==
|
||
用法:
|
||
|
||
cm ^branch | ^br [^create | ^mk] <分支规格>
|
||
[--^changeset=<变更集规格> | --^label=<标签规格>]
|
||
[-^c=<注释字符串> | -^commentsfile=<注释文件>]
|
||
|
||
分支规格 新分支名称或规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支规格。)
|
||
|
||
选项:
|
||
|
||
--^changeset 用作新分支的起点的变更集。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集规格。)
|
||
--^label 用作新分支的起点的标签。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解标签规格。)
|
||
-^c 用指定的文本填充新分支的“注释”
|
||
字段。
|
||
-^commentsfile 用指定文件的内容填充新分支的“注释”
|
||
字段。
|
||
|
||
== CMD_HELP_BRANCH_CREATE ==
|
||
备注:
|
||
|
||
要创建顶级分支,请指定不含任何层次结构的名称。
|
||
例如:
|
||
|
||
cm ^br /dev
|
||
|
||
如果未指定可选参数 '--^changeset',新分支的基项
|
||
将是父分支上的最后一个变更集。如果新分支
|
||
是顶级分支,则使用的基础变更集将为变更集 0。
|
||
|
||
可以使用 '-^c' 或 '-^m' 开关来指定注释:
|
||
|
||
cm ^branch /main/task001 -^c="这是注释"
|
||
cm ^branch /main/task001 -^m "这是注释"
|
||
|
||
设置 PLASTICEDITOR 环境变量可指定用于输入注释的
|
||
编辑器。如果已设置 PLASTICEDITOR 环境变量,
|
||
并且注释为空,则会自动启动编辑器
|
||
以用于指定注释。
|
||
|
||
示例:
|
||
|
||
cm ^branch task001
|
||
cm ^branch ^create task001
|
||
cm ^branch ^mk task001
|
||
cm ^br ^mk task001
|
||
(在当前工作区的存储库中创建顶级分支
|
||
'task001'。)
|
||
|
||
cm ^branch ^br:/task001/task002@
|
||
(创建 'task002' 分支作为 'task001' 的子级。)
|
||
|
||
cm ^br /main/task001@myrep@myserver:8084 -^c="我的注释"
|
||
(在存储库 'myrep@myserver:8084' 中,创建 'task001' 分支
|
||
作为 'main' 的子级,并包含注释 '我的注释'。)
|
||
|
||
cm ^branch ^br:/main/task001 --^changeset=2837 -^commentsfile=commenttask001.txt
|
||
(创建 'task001' 分支作为 'main' 的子级,基础变更集 'changeset=2837',
|
||
并应用 'commenttask001.txt' 文件中的注释。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_DELETE ==
|
||
删除一个或多个分支。
|
||
|
||
== CMD_USAGE_BRANCH_DELETE ==
|
||
用法:
|
||
|
||
cm ^branch | ^br ^delete | ^rm <分支规格>[ ...]
|
||
|
||
分支规格 要删除的分支。使用空格对各个分支进行分隔。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支
|
||
规格。)
|
||
|
||
== CMD_HELP_BRANCH_DELETE ==
|
||
备注:
|
||
|
||
此命令将删除一个或多个分支。
|
||
|
||
示例:
|
||
|
||
cm ^branch ^delete /main/task001
|
||
(在当前工作区的存储库中删除名为 'task001' 分支
|
||
('main' 的子级)。)
|
||
|
||
cm ^br ^rm main/task002 /main/task012@reptest@myserver:8084
|
||
(删除当前工作区的存储库中的分支 '/main/task002
|
||
以及存储库 'reptest@myserver:8084' 中的分支 '/main/task012'。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_RENAME ==
|
||
重命名分支。
|
||
|
||
== CMD_USAGE_BRANCH_RENAME ==
|
||
用法:
|
||
|
||
cm ^branch | ^br ^rename <分支规格> <新名称>
|
||
|
||
分支规格 要重命名的分支。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支规格。)
|
||
新名称 分支的新名称。
|
||
|
||
== CMD_HELP_BRANCH_RENAME ==
|
||
备注:
|
||
|
||
此命令将重命名分支。
|
||
|
||
示例:
|
||
|
||
cm ^branch ^rename /main/task0 task1
|
||
(将分支 '/main/task0' 重命名为 '/main/task1'。)
|
||
|
||
cm ^br ^rename ^br:/main@reptest@server2:8084 secondary
|
||
(将存储库 'reptest' 的 'main' 分支重命名为 'secondary'。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_HISTORY ==
|
||
显示分支的历史记录。
|
||
|
||
== CMD_USAGE_BRANCH_HISTORY ==
|
||
用法:
|
||
|
||
cm ^branch | ^br ^history <分支规格> [--^dateformat=<日期格式>]
|
||
[--^machinereadable]
|
||
|
||
分支规格 用于获取历史记录的分支规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支规格。)
|
||
|
||
选项:
|
||
|
||
--^dateformat 用于输出日期的格式。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
|
||
== CMD_HELP_BRANCH_HISTORY ==
|
||
示例:
|
||
|
||
cm ^branch ^history ^br:/main/scm001@myrepository@myserver:8084
|
||
(显示 'myserver' 服务器中的 'myrepository' 存储库的 '/main/scm001'
|
||
分支的历史记录。)
|
||
|
||
cm ^br ^history main --^dateformat="yyyy, dd MMMM" --^machinereadable
|
||
(以给定的日期格式和易于解析的格式,显示当前
|
||
存储库的 'main' 分支的历史记录。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_SHOWMAIN ==
|
||
显示存储库的主分支。
|
||
这是一个自动化命令,仅用于自动执行 'cm'。
|
||
存储库的主分支很有可能是 '/main'。
|
||
|
||
== CMD_USAGE_BRANCH_SHOWMAIN ==
|
||
用法:
|
||
|
||
cm ^branch | ^br ^showmain [<存储库规格>] [--^encoding=<名称>]
|
||
[--^format=<格式字符串>] [--^dateformat=<日期格式>]
|
||
|
||
存储库规格 要显示分支的存储库
|
||
规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库规格。)
|
||
|
||
选项:
|
||
|
||
--^encoding 指定输出中使用的编码,
|
||
如:utf-8。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^dateformat 用于输出日期的格式。
|
||
|
||
== CMD_HELP_BRANCH_SHOWMAIN ==
|
||
备注:
|
||
|
||
此命令将显示存储库的主分支。
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{^id} 分支 ID。
|
||
{^comment} 注释。
|
||
{^date} 日期。
|
||
{^name} 名称。
|
||
{^owner} 所有者。
|
||
{^parent} 父分支名称。
|
||
{^repository} 存储库。
|
||
{^repname} 存储库名称。
|
||
{^repserver} 服务器。
|
||
{^changeset} 分支的头部变更集。
|
||
|
||
示例:
|
||
|
||
cm ^branch ^showmain
|
||
(显示当前工作区的存储库的主分支。)
|
||
|
||
cm ^branch ^showmain repo@server:8084
|
||
(显示服务器 'server:8084' 中的存储库 'repo' 的
|
||
主分支。)
|
||
|
||
cm ^br ^showmain --^dateformat="yyyy, dd MMMM" --^encoding=utf8
|
||
(以给定日期格式显示存储库的主分支,
|
||
输出编码为 utf8。)
|
||
|
||
cm ^br ^showmain --^format="{^id} - {^name}"
|
||
(显示存储库的主分支,仅打印其 ID 和名称。)
|
||
|
||
== CMD_DESCRIPTION_BRANCH_SHOWMERGES ==
|
||
显示待合并的分支。
|
||
|
||
== CMD_USAGE_BRANCH_SHOWMERGES ==
|
||
这是一个自动化命令,仅用于自动执行 'cm'。
|
||
此命令的用户友好度不如预期。
|
||
|
||
用法:
|
||
|
||
cm ^branch | ^br ^showmerges <项路径>[ ...]
|
||
[--^format=<格式字符串>]
|
||
[--^dateformat=<日期格式>]
|
||
|
||
选项:
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^dateformat 用于输出日期的格式。
|
||
|
||
== CMD_HELP_BRANCH_SHOWMERGES ==
|
||
备注:
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{^id} 分支 ID。
|
||
{^comment} 注释。
|
||
{^date} 日期。
|
||
{^name} 名称。
|
||
{^owner} 所有者。
|
||
{^parent} 父分支名称。
|
||
{^parentid} 父分支 ID。
|
||
{^repid} 存储库 ID。
|
||
{^repository} 存储库。
|
||
{^repname} 存储库名称。
|
||
{^repserver} 存储库服务器。
|
||
|
||
示例:
|
||
|
||
cm ^branch ^showmerges file.txt
|
||
(显示 'file.txt' 的待定合并中涉及的分支。)
|
||
|
||
cm ^branch ^showmerges file.txt --^format="{^date} {^name}" --^dateformat="yyMMdd"
|
||
(显示合并中涉及的分支,仅以给定的日期格式打印
|
||
日期和名称。)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY ==
|
||
允许用户管理存储库。
|
||
|
||
== CMD_USAGE_REPOSITORY ==
|
||
用法:
|
||
|
||
cm ^repository | ^repo <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^list | ^ls
|
||
^rename
|
||
^add
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^repository <命令> --^usage
|
||
cm ^repository <命令> --^help
|
||
|
||
== CMD_HELP_REPOSITORY ==
|
||
示例:
|
||
|
||
cm ^repository
|
||
cm ^repository ^list
|
||
cm ^repository 新存储库
|
||
cm ^repository ^create 新存储库
|
||
cm ^repository ^rename 旧名称 新名称
|
||
cm ^repository ^add C:\repo\
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_CREATE ==
|
||
在服务器上创建存储库。
|
||
|
||
== CMD_USAGE_REPOSITORY_CREATE ==
|
||
用法:
|
||
|
||
cm ^repository | ^repo <存储库名称>
|
||
cm ^repository | ^repo <存储库服务器规格> <存储库名称>[ ...]
|
||
cm ^repository | ^repo [^create | ^mk] <存储库名称>
|
||
|
||
存储库服务器规格 存储库服务器规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
服务器规格。)
|
||
存储库名称 一个或多个新存储库的名称。
|
||
使用空格对各个存储库名称进行分隔。
|
||
|
||
== CMD_HELP_REPOSITORY_CREATE ==
|
||
示例:
|
||
|
||
cm ^repository MyRep
|
||
cm ^repo 192.168.1.140:8087 Rep01 Rep01/ModuleA Rep01/ModuleB
|
||
cm ^repo ^create Rep01
|
||
cm ^repo ^mk 列表
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_DELETE ==
|
||
从服务器删除存储库。
|
||
|
||
== CMD_USAGE_REPOSITORY_DELETE ==
|
||
用法:
|
||
|
||
cm ^repository | ^repo ^delete | ^rm <存储库规格>
|
||
|
||
选项:
|
||
|
||
存储库规格 存储库的规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库规格。)
|
||
|
||
== CMD_HELP_REPOSITORY_DELETE ==
|
||
备注:
|
||
|
||
从存储库服务器删除存储库。
|
||
不会从数据库后端删除数据,而是会断开,
|
||
因此将无法再进行访问。
|
||
(以后可以重新连接数据,请参阅 'cm ^repository ^add'。)
|
||
|
||
示例:
|
||
|
||
cm ^repository ^delete myrepository@^repserver:myserver:8084
|
||
cm ^repository ^rm myrepository@myserver:8084
|
||
cm ^repo ^rm myrepository
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_LIST ==
|
||
列出服务器上的存储库。
|
||
|
||
== CMD_USAGE_REPOSITORY_LIST ==
|
||
用法:
|
||
|
||
cm ^repository | ^repo [^list | ^ls] [<存储库服务器规格>] [--^format=<格式字符串>]
|
||
|
||
选项:
|
||
|
||
存储库服务器规格 存储库服务器规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
服务器规格。)
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
|
||
== CMD_HELP_REPOSITORY_LIST ==
|
||
备注:
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
|
||
此命令的输出参数如下:
|
||
|
||
{^repid} | {0} 存储库标识符。
|
||
{^repname} | {1} 存储库名称。
|
||
{^repserver} | {2} 服务器名称。
|
||
{^repowner} | {3} 存储库所有者。
|
||
{^repguid} | {4} 存储库的唯一标识符。
|
||
{^tab} 插入一个制表符空格位。
|
||
{^newline} 插入一个新行。
|
||
|
||
如果格式参数值为 '^TABLE',则会使用具有 {^repid}、
|
||
{^repname} 和 {^repserver} 字段的表格式来打印输出。
|
||
|
||
示例:
|
||
|
||
cm ^repository
|
||
(列出所有存储库。)
|
||
|
||
cm ^repository ^list localhost:8084 --^format="{1, -20} {3}"
|
||
(将存储库名称写入 20 个空格位,左对齐,然后留一个空白,
|
||
再然后是存储库所有者。)
|
||
|
||
cm ^repository ^ls localhost:8084 --^format="{^repname, -20} {^repowner}"
|
||
(写入方式与前一个示例相同。)
|
||
|
||
cm ^repo ^ls localhost:8084 --^format=^TABLE
|
||
(使用具有以下字段的表格式来写入存储库列表:
|
||
存储库 ID、存储库名称和存储库服务器名称。)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_RENAME ==
|
||
重命名存储库。
|
||
|
||
== CMD_USAGE_REPOSITORY_RENAME ==
|
||
用法:
|
||
|
||
cm ^repository | ^repo ^rename [<存储库规格>] <新名称>
|
||
|
||
存储库规格 要重命名的存储库。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
规格。)
|
||
新名称 存储库的新名称。
|
||
|
||
== CMD_HELP_REPOSITORY_RENAME ==
|
||
备注:
|
||
|
||
此命令将重命名存储库。
|
||
如果未指定存储库规格,则会采用当前存储库。
|
||
|
||
示例:
|
||
|
||
cm ^repository ^rename development
|
||
(将当前存储库重命名为 'development'。)
|
||
|
||
cm ^repo ^rename ^rep:default@SERVER:8084 development
|
||
(将 'SERVER' 上的 'default' 存储库重命名为 'development'。)
|
||
|
||
== CMD_DESCRIPTION_REPOSITORY_ADD ==
|
||
通过添加现有存储库的数据库来连接此存储库。
|
||
|
||
== CMD_USAGE_REPOSITORY_ADD ==
|
||
用法:
|
||
|
||
cm ^repository | ^repo ^add <数据库文件> <存储库名称> <存储库服务器规格>
|
||
|
||
数据库文件 数据库后端上的数据库文件的名称。
|
||
存储库名称 存储库的名称。
|
||
存储库服务器规格 存储库服务器规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
服务器规格。)
|
||
|
||
== CMD_HELP_REPOSITORY_ADD ==
|
||
备注:
|
||
|
||
将现有存储库数据库重新连接到服务器。
|
||
示例:使用 'cm ^repository ^delete' 命令后,使用 '^add' 命令
|
||
将存储库从一个服务器移动到另一个服务器或还原
|
||
已存档的存储库。
|
||
|
||
示例:
|
||
|
||
cm ^repository ^add rep_27 myrepository myserver:8084
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_CREATE ==
|
||
在服务器上创建新触发器。
|
||
|
||
== CMD_USAGE_TRIGGER_CREATE ==
|
||
用法:
|
||
|
||
cm ^trigger | ^tr ^create | ^mk <子类型-类型> <新名称> <脚本路径>
|
||
[--^position=<新位置>]
|
||
[--^filter=<筛选器字符串>]
|
||
[--^server=<存储库服务器规格>]
|
||
|
||
子类型-类型 触发器执行和触发器操作。
|
||
键入 'cm ^showtriggertypes' 可查看触发器类型
|
||
列表。
|
||
新名称 新触发器的名称。
|
||
脚本路径 服务器上包含要执行的脚本的
|
||
磁盘路径。如果命令行以 "^webtrigger " 开头,
|
||
则认为此触发器是 Web 触发器。请参阅
|
||
“备注”以了解更多信息。
|
||
|
||
选项:
|
||
|
||
--^position 指定触发器的新位置。
|
||
此位置不能正在由相同类型的另一个
|
||
触发器使用。
|
||
--^filter 仅检查与指定筛选器匹配的项。
|
||
--^server 在指定服务器上创建触发器。
|
||
如果未指定服务器,则在客户端上配置的
|
||
服务器上执行命令。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
服务器规格。)
|
||
|
||
== CMD_HELP_TRIGGER_CREATE ==
|
||
备注:
|
||
|
||
Web 触发器:创建 Web 触发器的方法是键入 "^webtrigger <目标-URI>"
|
||
作为触发器命令。在这种情况下,触发器将针对指定的 URI
|
||
执行 POST 查询,其中,请求主体包含带有触发器
|
||
环境变量的 JSON 字典,还有一个指向字符串数组的
|
||
固定 INPUT 键。
|
||
|
||
示例:
|
||
|
||
cm ^trigger ^create ^after-setselector "BackupMgr" "/path/to/script" --^position=4
|
||
|
||
cm ^tr ^mk ^before-mklabel new "/path/to/script" --^server=myserver:8084
|
||
|
||
cm ^tr ^mk ^after-mklabel Log "/path/to/script" --^filter="^rep:myRep,LB*"
|
||
(仅当标签名称以 'LB' 开头并且标签是在名为 'myRep' 的
|
||
存储库中创建时,才会执行此触发器。)
|
||
|
||
cm ^tr ^mk ^after-checkin NotifyTeam "^webtrigger http://myserver.org/api"
|
||
|
||
== CMD_DESCRIPTION_MOVE ==
|
||
移动或重命名文件或目录。
|
||
|
||
== CMD_USAGE_MOVE ==
|
||
用法:
|
||
|
||
cm ^move | ^mv <源路径> <目标路径> [--^format=<格式字符串>]
|
||
[--^errorformat=<格式字符串>]
|
||
|
||
源路径 源项的路径。
|
||
目标路径 目标项的路径。
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^errorformat 检索特定格式的错误消息。请参阅
|
||
“备注”以了解更多信息。
|
||
|
||
== CMD_HELP_MOVE ==
|
||
备注:
|
||
|
||
此命令将移动或重命名存储库中的项。
|
||
还会在本地文件系统中进行更改。
|
||
|
||
如果源路径是文件,则目标路径可以是文件或
|
||
目录。在第一种情况下会重命名文件;否则会移动
|
||
相应的项。
|
||
如果源路径是目录,则目标路径必须是目录。
|
||
|
||
要移动或重命名的项必须已存在。
|
||
|
||
格式:
|
||
{0} 源路径('--^format' 和 '--^errorformat')
|
||
{1} 目标路径('--^format' 和 '--^errorformat')
|
||
|
||
示例:
|
||
|
||
cm ^move file.txt file.old
|
||
(重命名相应的项。)
|
||
|
||
cm ^mv .\file.old .\oldFiles
|
||
(将 'file.old' 移到 'oldFiles'。)
|
||
|
||
cm ^move .\src .\src2
|
||
(重命名目录。)
|
||
|
||
== CMD_DESCRIPTION_LABEL ==
|
||
允许用户管理标签。
|
||
|
||
== CMD_USAGE_LABEL ==
|
||
用法:
|
||
|
||
cm ^label | ^lb <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^rename
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^label <命令> --^usage
|
||
cm ^label <命令> --^help
|
||
|
||
== CMD_HELP_LABEL ==
|
||
示例:
|
||
|
||
cm ^label myNewLabel ^cs:42
|
||
('^create' 命令是可选命令。)
|
||
|
||
cm ^label ^rename myNewLabel newLabelName
|
||
cm ^label ^delete newLabelName
|
||
|
||
== CMD_DESCRIPTION_LABEL_CREATE ==
|
||
将标签应用于变更集,并在需要时创建标签。
|
||
|
||
== CMD_USAGE_LABEL_CREATE ==
|
||
用法:
|
||
|
||
cm ^label [^create] <标签规格> [<变更集规格> | <工作区路径>]
|
||
[--^allxlinkedrepositories]
|
||
[-^c=<注释字符串> | -^commentsfile=<注释文件>]
|
||
|
||
标签规格 新标签名称。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解标签
|
||
规格。)
|
||
变更集规格 要标记的变更集的名称或完整规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集
|
||
规格。)
|
||
工作区路径 要标记的工作区的路径。(工作区指向的
|
||
变更集将被标记。)
|
||
|
||
选项:
|
||
|
||
--^allxlinkedrepositories 在所有通过 Xlink 链接的存储库中创建新标签。
|
||
-^c 将指定的注释应用于新标签。
|
||
-^commentsfile 将指定文件中的注释应用于
|
||
新标签。
|
||
|
||
== CMD_HELP_LABEL_CREATE ==
|
||
备注:
|
||
|
||
设置 PLASTICEDITOR 环境变量可指定用于键入注释的
|
||
编辑器。
|
||
|
||
示例:
|
||
|
||
cm ^label ^create ^lb:BL001 ^cs:1203 -^commentsfile=commentlb001.txt
|
||
(创建附加到变更集 1203 的标签 'BL001',并应用 'commentlb001.txt'
|
||
文件中的注释。)
|
||
|
||
cm ^label BL002 ^cs:1203 -^c="首次发布"
|
||
(创建带有注释的标签 'BL002',并附加到变更集 1203。)
|
||
|
||
== CMD_DESCRIPTION_LABEL_DELETE ==
|
||
删除一个或多个标签。
|
||
|
||
== CMD_USAGE_LABEL_DELETE ==
|
||
用法:
|
||
|
||
cm ^label ^delete <标签规格>[ ...]
|
||
|
||
标签规格 要删除的标签。使用空格对各个标签进行分隔。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解标签
|
||
规格。)
|
||
|
||
== CMD_HELP_LABEL_DELETE ==
|
||
备注:
|
||
|
||
此命令将删除一个或多个标签。
|
||
|
||
示例:
|
||
|
||
cm ^label ^delete ^lb:BL001
|
||
(删除标签 'BL001'。)
|
||
|
||
cm ^label ^delete ^lb:BL001 ^lb:BL002@reptest@server2:8084
|
||
(删除标签 'BL001' 和 'BL002'。)
|
||
|
||
== CMD_DESCRIPTION_LABEL_RENAME ==
|
||
重命名标签。
|
||
|
||
== CMD_USAGE_LABEL_RENAME ==
|
||
用法:
|
||
|
||
cm ^label ^rename <标签规格> <新名称>
|
||
|
||
标签规格 要重命名的标签。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解标签规格。)
|
||
新名称 标签的新名称。
|
||
|
||
== CMD_HELP_LABEL_RENAME ==
|
||
备注:
|
||
|
||
此命令将重命名标签。
|
||
|
||
示例:
|
||
|
||
cm ^label ^rename ^lb:BL001 BL002
|
||
(将标签 'BL001' 重命名为 'BL002'。)
|
||
|
||
== CMD_DESCRIPTION_OBJECTSPEC ==
|
||
描述如何编写对象规格。
|
||
|
||
== CMD_USAGE_OBJECTSPEC ==
|
||
用法:
|
||
cm ^objectspec
|
||
获取关于如何构建对象规格的所有信息。
|
||
|
||
== CMD_HELP_OBJECTSPEC ==
|
||
一些 Unity VCS 命令要求将 '对象规格' 作为输入来引用
|
||
给定对象(通常是分支、变更集、存储库等)。
|
||
|
||
本文档介绍可用的不同“规格”以及如何
|
||
构建规格。
|
||
|
||
每个规格类型以唯一标记(例如 "^rep:" 或 "^cs:")开头。必须为
|
||
采用一般对象规格的命令指定标记(例如:
|
||
"cm ^setowner 对象规格" 命令),但对于仅采用单一类型规格的命令
|
||
常常可以省略标记(例如:"cm ^getfile 修订规格" 命令)。
|
||
|
||
-- 存储库服务器规格 --
|
||
^repserver:name:port
|
||
|
||
示例:
|
||
cm ^repo ^list ^repserver:skull:8084
|
||
cm ^repo ^list skull:8084
|
||
|
||
旁注:
|
||
由于历史原因,我们称之为“存储库服务器规格”,而不只是
|
||
“服务器规格”。很久以前,我们有单独的工作区服务器和
|
||
存储库服务器,命名方式沿用至今。
|
||
|
||
-- 存储库规格 --
|
||
^rep:rep_name@[存储库服务器规格]
|
||
|
||
示例:
|
||
cm ^showowner ^rep:codice@localhost:6060
|
||
(此处的 "^rep:" 是必需的,因为 ^showowner 不仅容许存储库,
|
||
而且容许其他类型的对象。因此,需要用户指明
|
||
对象类型。)
|
||
|
||
-- 分支规格 --
|
||
^br:[/]br_name[@repspec]
|
||
|
||
示例:
|
||
cm ^switch ^br:/main@^rep:plastic@^repserver:skull:9095
|
||
(这种情况下不需要 "^br:"、"^rep" 和 "^repserver",所以
|
||
该命令容许简短很多的格式:
|
||
"cm ^switch main@plastic@skull:9095"。)
|
||
|
||
cm ^find ^revisions "^where ^branch='^br:/main/task001'"
|
||
|
||
备注:
|
||
分支上的初始 '/' 不是必需的。我们曾经将所有分支
|
||
指定为 /main、/main/task001,依此类推。但是现在,我们首选
|
||
更短的 main、main/task001 形式,这使命令更简洁。
|
||
|
||
-- 变更集规格 --
|
||
^cs:cs_number|cs_GUID[@repspec]
|
||
|
||
可以指定变更集的编号或 GUID。
|
||
|
||
示例:
|
||
cm ^ls /code --^tree=ae1390ed-7ce9-4ec3-a155-e5a61de0dc77@code@skull:7070
|
||
|
||
-- 标签规格 --
|
||
^lb:lb_name[@repspec]
|
||
|
||
示例:
|
||
cm ^switch ^lb:RELEASE2.0
|
||
cm ^switch ^lb:RELEASE1.4@myrep@MYSERVER:8084
|
||
|
||
-- 修订规格 --
|
||
有不同类型的修订规格:
|
||
|
||
^rev:item_path[#(分支规格|变更集规格|标签规格)]
|
||
|
||
^rev:^serverpath:item_path#(分支规格|变更集规格|标签规格)
|
||
|
||
^rev:^revid:rev_id[@rep_spec]
|
||
|
||
^rev:^itemid:item_id#(分支规格|变更集规格|标签规格)
|
||
|
||
示例:
|
||
cm ^diff ^rev:readme.txt#^cs:19 ^rev:readme.txt#^cs:20
|
||
|
||
cm ^diff ^serverpath:/doc/readme.txt#^cs:19@myrepo \
|
||
^serverpath:/doc/readme.txt#^br:/main@myrepo@localhost:8084
|
||
|
||
cm ^cat ^revid:1230@^rep:myrep@^repserver:myserver:8084
|
||
|
||
-- 项规格 --
|
||
^item:path
|
||
极少使用。
|
||
|
||
示例:
|
||
cm ^find ^revision "^where ^item='^item:.'"
|
||
|
||
-- 属性规格 --
|
||
^att:att_name[@repspec]
|
||
|
||
示例:
|
||
cm ^attribute ^set ^att:merged@code@doe:8084 ^cs:25@code@doe:8084 完成
|
||
|
||
-- 搁置规格 --
|
||
^sh:sh_number[@repspec]
|
||
|
||
示例:
|
||
cm ^diff ^sh:2 ^sh:4
|
||
|
||
-- 工作区规格 --
|
||
^wk:name@clientmachine
|
||
|
||
极少使用,因为仅适用于工作区相关的命令。适合用于
|
||
按名称和机器(而不是路径)来指定工作区。
|
||
|
||
示例:
|
||
cm ^showselector ^wk:codebase@modok
|
||
|
||
旁注:
|
||
这些规格来自早期的 Plastic SCM 2.x,当时的
|
||
“工作区服务器”是一种集中存储工作区元数据
|
||
的方式。后期由于性能问题而被弃用。
|
||
|
||
== CMD_DESCRIPTION_PARTIAL ==
|
||
在非完整的工作区中运行命令。
|
||
|
||
== CMD_USAGE_PARTIAL ==
|
||
用法:
|
||
|
||
cm ^partial <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^configure
|
||
^add
|
||
^undo
|
||
^co | ^checkout
|
||
^unco | ^undocheckout
|
||
^ci | ^checkin
|
||
^mv | ^move
|
||
^rm | ^remove
|
||
^stb | ^switch
|
||
^upd | ^update
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^partial <命令> --^usage
|
||
cm ^partial <命令> --^help
|
||
|
||
== CMD_HELP_PARTIAL ==
|
||
示例:
|
||
|
||
cm ^partial ^configure +/background-blue.png
|
||
cm ^partial ^update landscape-1024.png
|
||
cm ^partial ^checkin eyes-green.png eyes-black.png
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_ADD ==
|
||
向版本控制中添加项。
|
||
|
||
== CMD_USAGE_PARTIAL_ADD ==
|
||
用法:
|
||
|
||
cm ^partial ^add [-^R | -^r | --^recursive] [--^silent] [--^parents]
|
||
[--^ignorefailed] [--^skipcontentcheck] <项路径>[ ...]
|
||
|
||
项路径 要添加的项。使用双引号 (" ") 指定包含空格
|
||
的路径。使用空格对各个路径进行分隔。
|
||
使用 * 添加当前目录的所有内容。
|
||
|
||
选项:
|
||
|
||
-^R 以递归方式添加项。
|
||
--^silent 不显示任何输出。
|
||
--^parents 在操作中包含指定项
|
||
的父目录。
|
||
--^ignorefailed 如果无法添加某一项,则添加操作将在没有
|
||
这一项的情况下继续进行。注意:如果无法添加
|
||
某个目录,则不会添加目录中的内容。
|
||
--^skipcontentcheck 如果不足以根据扩展名将文件设置为
|
||
文本或二进制,默认情况下会将该文件设置为二进制,
|
||
而不是检查内容来检测类型。
|
||
|
||
== CMD_HELP_PARTIAL_ADD ==
|
||
备注:
|
||
|
||
添加项的要求:
|
||
- 要添加的项的父目录必须已事先添加。
|
||
|
||
示例:
|
||
|
||
cm ^partial ^add pic1.png pic2.png
|
||
(添加 'pic1.png' 和 'pic2.png' 项。)
|
||
|
||
cm ^partial ^add c:\workspace\picture.png
|
||
(添加路径 'c:\workspace' 中的 'picture.png' 项。)
|
||
|
||
cm ^partial ^add -^R c:\workspace\src
|
||
(以递归方式添加 'src'。)
|
||
|
||
cm ^partial ^add --^parents samples\design01.png
|
||
(添加 'design01.png' 文件和 'samples' 父文件夹。)
|
||
|
||
cm ^partial ^add -^R *
|
||
(以递归方式添加当前目录的所有内容。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CHECKIN ==
|
||
将更改存储在存储库中。
|
||
|
||
== CMD_USAGE_PARTIAL_CHECKIN ==
|
||
用法:
|
||
|
||
cm ^partial ^checkin | ^ci [<项路径>[ ...]]
|
||
[-^c=<注释字符串> | -^commentsfile=<注释文件>]
|
||
[--^all | -^a] [--^applychanged] [--^keeplock]
|
||
[--^symlink] [--^ignorefailed]
|
||
|
||
选项:
|
||
|
||
项路径 要签入的项。使用双引号 (" ") 指定
|
||
包含空格的路径。使用空格对各个路径进行
|
||
分隔。
|
||
使用 . 将签入应用到当前目录。
|
||
-^c 指定在签入操作中创建的变更集
|
||
的注释。
|
||
-^commentsfile 将指定文件中的注释应用于在签入操作中
|
||
创建的变更集。
|
||
--^all | -^a 还包括在指定路径上进行了本地更改、移动
|
||
和删除的项。
|
||
--^applychanged 将签入操作应用于在工作区中
|
||
检测到的已更改项以及
|
||
签出的项。
|
||
--^keeplock 签入操作后保持锁定项的
|
||
锁定状态。
|
||
--^symlink 将签入操作应用于符号链接而不是
|
||
目标。
|
||
--^ignorefailed 无法应用的任何更改(因为无法获得
|
||
锁定状态(又称为“独占签出”)或者
|
||
因为本地更改与服务器更改冲突)
|
||
将被丢弃,然后没有这些更改的情况下
|
||
继续进行签入操作。
|
||
|
||
== CMD_HELP_PARTIAL_CHECKIN ==
|
||
备注:
|
||
|
||
- 如果未指定 <项路径>,则签入操作将涉及
|
||
工作区中的所有待定更改。
|
||
- 签入操作始终以递归方式从给定路径应用。
|
||
- 要签入项,必须满足以下条件:
|
||
- 项必须受源代码管理。
|
||
- 必须签出项。
|
||
- 如果已更改但未签出项,则除非 <项路径> 是目录
|
||
或包含通配符 ('*'),否则不需要
|
||
'--^applychanged' 标志。
|
||
|
||
修订内容必须与以前的修订不同才能
|
||
签入。
|
||
|
||
设置 PLASTICEDITOR 环境变量可指定用于键入注释的
|
||
编辑器。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^partial ^checkin' 命令可从 stdin 读取路径。为此,请传递
|
||
一个破折号 "-"。
|
||
示例:cm ^partial ^checkin -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要签入的文件。
|
||
示例:
|
||
dir /S /B *.c | cm ^partial ^checkin --^all -
|
||
(在 Windows 中,签入工作区中的所有 .c 文件。)
|
||
|
||
示例:
|
||
|
||
cm ^partial ^checkin figure.png landscape.png
|
||
(将签入应用于已签出的文件 'figure.png' 和 'landscape.png'。)
|
||
|
||
cm ^partial ^checkin .-^commentsfile=mycomment.txt
|
||
(将签入应用于当前目录并设置 'mycomment.txt' 文件
|
||
中的注释。)
|
||
|
||
cm ^partial ^ci background.png -^c="我的注释" --^keeplock
|
||
(将签入应用于 'background.png',包含注释,并保持
|
||
锁定。)
|
||
|
||
cm ^partial ^checkin --^applychanged
|
||
(将签入应用于工作区中的所有待定更改。)
|
||
|
||
cm ^partial ^checkin 链接 --^symlink
|
||
(将签入应用于链接文件而非目标,适用于
|
||
UNIX 环境。)
|
||
|
||
cm ^partial ^checkin .--^ignorefailed
|
||
(将签入应用于当前目录,忽略无法应用的
|
||
更改。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CHECKOUT ==
|
||
将文件标记为修改就绪。
|
||
|
||
== CMD_USAGE_PARTIAL_CHECKOUT ==
|
||
用法:
|
||
|
||
cm ^partial ^checkout | ^co [<项路径>[ ...]] [--^resultformat=<格式字符串>]
|
||
[--^silent] [--^ignorefailed]
|
||
|
||
选项:
|
||
|
||
项路径 要签出的项。使用双引号 (" ") 指定
|
||
包含空格的路径。使用空格对各个路径进行
|
||
分隔。
|
||
使用 . 将签出应用到当前目录。
|
||
--^resultformat 检索特定格式的输出结果
|
||
消息。
|
||
--^silent 不显示任何输出。
|
||
--^ignorefailed 如果无法锁定某项(无法执行独占签出),
|
||
则签出操作将在没有这一项的情况下
|
||
继续进行。
|
||
|
||
== CMD_HELP_PARTIAL_CHECKOUT ==
|
||
备注:
|
||
|
||
要签出项,必须满足以下条件:
|
||
- 项必须受源代码管理。
|
||
- 必须签入项。
|
||
|
||
如果在服务器上配置了锁(存在 lock.conf),则每次
|
||
在某条路径上进行签出时,Unity VCS 都会检查是否符合规则,
|
||
如果符合,该路径将处于独占签出(锁定)状态,以便任何其他人
|
||
都无法同时进行签出。
|
||
可使用 'cm ^lock ^list' 获取服务器中的所有锁。
|
||
请查看《管理员指南》以了解锁定的工作原理:
|
||
https://www.plasticscm.com/download/help/locking
|
||
|
||
示例:
|
||
|
||
cm ^partial ^checkout pic1.png pic2.png
|
||
(签出 'pic1.png' 和 'pic2.png' 文件。)
|
||
|
||
cm ^partial ^co *.png
|
||
(签出所有 png 文件。)
|
||
|
||
cm ^partial ^checkout .
|
||
(签出当前目录。)
|
||
|
||
cm ^partial ^checkout -^R c:\workspace\src
|
||
(以递归方式签出 'src' 文件夹。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_CONFIGURE ==
|
||
可以通过在工作区中加载或卸载项来配置工作区。
|
||
|
||
== CMD_USAGE_PARTIAL_CONFIGURE ==
|
||
用法:
|
||
|
||
cm ^partial ^configure <+|-路径>[ ...][--^silent] [--^ignorefailed]
|
||
[--^ignorecase] [--^restorefulldirs]
|
||
|
||
路径 要加载或卸载的路径。使用双引号 (" ")
|
||
指定包含空格的路径。使用空格对各个路径进行
|
||
分隔。
|
||
路径必须以 "/" 开头。
|
||
|
||
选项:
|
||
|
||
--^silent 不显示任何输出。
|
||
--^ignorefailed 跳过该过程中的所有错误。错误路径
|
||
不会导致命令停止。
|
||
--^ignorecase 忽略路径中的大小写。使用此标志后,
|
||
即使用户写入 "/data/teXtures",'^configure' 也对
|
||
"/Data/Textures" 有效。
|
||
--^restorefulldirs 重置无效的目录配置(在非完整的工作区上
|
||
运行完整操作时发生)。
|
||
此列表中的目录将实现完全配置
|
||
(完全检查),这意味着这些目录将在
|
||
更新期间自动下载新内容。
|
||
此操作不会下载任何文件,只会
|
||
在非完整的工作区上还原目录
|
||
配置。
|
||
|
||
== CMD_HELP_PARTIAL_CONFIGURE ==
|
||
备注:
|
||
|
||
该命令采用递归操作。
|
||
|
||
示例:
|
||
|
||
cm ^partial ^configure +/landscape_grey.png
|
||
(加载 'landscape_grey.png' 项。)
|
||
|
||
cm ^partial ^configure -/landscape_black.png
|
||
(卸载 'landscape_black.png' 项。)
|
||
|
||
cm ^partial ^configure +/soft -/soft/soft-black.png
|
||
(加载除 'soft-black.png' 以外的所有 'soft' 目录子项。)
|
||
|
||
cm ^partial ^configure -/
|
||
(卸载整个工作区。)
|
||
|
||
cm ^partial ^configure -/ +/
|
||
(加载整个工作区。)
|
||
|
||
cm ^partial ^configure -/figure-64.png --^ignorefailed
|
||
(即使已卸载 'figure-64.png' 项,也要卸载该项。)
|
||
|
||
cm ^partial ^configure +/ --^restorefulldirs
|
||
(设置所有目录来自动下载新内容。)
|
||
|
||
cm ^partial ^configure +/src/lib --^restorefulldirs
|
||
(仅设置 '/src/lib' 及其子目录来自动下载
|
||
新内容。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_MOVE ==
|
||
移动或重命名文件或目录。
|
||
|
||
== CMD_USAGE_PARTIAL_MOVE ==
|
||
用法:
|
||
|
||
cm ^partial ^move | ^mv <源路径> <目标路径> [--^format=<格式字符串>]
|
||
|
||
源路径 源项的路径。
|
||
目标路径 目标项的路径。
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
|
||
== CMD_HELP_PARTIAL_MOVE ==
|
||
备注:
|
||
|
||
此命令将移动或重命名存储库中的项。
|
||
还会在本地文件系统中进行更改。
|
||
|
||
如果源路径是文件,则目标路径可以是文件或
|
||
目录。在第一种情况下将重命名文件;否则将移动
|
||
相应的项。
|
||
如果源路径是目录,则目标路径必须是目录。
|
||
|
||
要移动或重命名的项必须已存在。
|
||
|
||
格式:
|
||
{0} 源路径。
|
||
{1} 目标路径。
|
||
|
||
示例:
|
||
|
||
cm ^partial ^move file.png file-blue.png
|
||
(重命名相应的项。)
|
||
|
||
cm ^partial ^mv .\file-blue.png .\blueFiles
|
||
(将 'file-blue.png' 移动到 'blueFiles'。)
|
||
|
||
cm ^partial ^move .\design .\marketing
|
||
(重命名目录。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_REMOVE ==
|
||
从版本控制中删除一个文件或目录。
|
||
|
||
== CMD_USAGE_PARTIAL_REMOVE ==
|
||
用法:
|
||
|
||
cm ^partial ^remove | ^rm <项路径>[ ...][--^nodisk]
|
||
|
||
项路径 要删除的项路径。使用双引号 (" ")
|
||
指定包含空格的路径。使用空格对各个路径进行
|
||
分隔。
|
||
|
||
选项:
|
||
|
||
--^nodisk 从版本控制中删除相应的项,但是将该项保留在磁盘上。
|
||
|
||
== CMD_HELP_PARTIAL_REMOVE ==
|
||
备注:
|
||
|
||
磁盘中会删除项。删除的项会从源代码管理
|
||
中的父目录中被删除。
|
||
|
||
要求:
|
||
- 项必须受源代码管理。
|
||
|
||
示例:
|
||
|
||
cm ^partial ^remove src
|
||
(删除 'src'。如果 'src' 是目录,则等同于:
|
||
cm ^partial ^remove -^R src。)
|
||
|
||
cm ^partial ^remove c:\workspace\pic01.png --^nodisk
|
||
(从版本控制中删除 'pic01.png',但将其保留在磁盘上。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_SWITCH ==
|
||
将分支设置为工作分支。
|
||
|
||
== CMD_USAGE_PARTIAL_SWITCH ==
|
||
用法:
|
||
|
||
cm ^switch <分支规格> [--^report | --^silent] [--^workspace=<路径>]
|
||
(设置工作分支并更新工作区。)
|
||
|
||
cm ^switch <分支规格> --^configure <+|-路径>[ ...][--^silent]
|
||
[--^ignorefailed] [--^ignorecase] [--^workspace=<路径>]
|
||
(设置工作分支并运行工作区配置,就像 'cm
|
||
^partial ^configure' 命令一样。)
|
||
|
||
分支规格 分支的规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解分支规格。)
|
||
路径 要加载或卸载的路径。使用双引号 (" ")
|
||
指定包含空格的路径。使用空格对各个路径
|
||
进行分隔。路径必须以 "/" 开头。
|
||
|
||
选项:
|
||
|
||
--^silent 不显示任何输出。
|
||
--^report 命令完成后,打印已应用更改
|
||
的列表。使用 '--^silent' 将会覆盖此设置。
|
||
此选项仅在未指定 '--^configure' 选项
|
||
时有效。
|
||
--^configure 更新工作分支后配置
|
||
(加载/卸载项)工作区。查看 'cm ^partial
|
||
^configure --^help' 可了解如何指定要配置的
|
||
路径。
|
||
--^ignorefailed 跳过配置过程中的所有错误。
|
||
错误路径不会导致命令停止。
|
||
--^ignorecase 忽略路径中的大小写。使用此标志后,即使
|
||
用户写入 "/data/teXtures",选项 '--^configure' 也对
|
||
"/Data/Textures" 有效。
|
||
--^workspace=路径 工作区所在的路径。
|
||
|
||
== CMD_HELP_PARTIAL_SWITCH ==
|
||
备注:
|
||
|
||
此命令允许用户更新工作分支。更新分支之后,
|
||
该命令就像 'cm ^partial ^update' 命令一样会
|
||
将工作区更新到新分支。然而,如果指定了 '--^configure'
|
||
选项,该命令就像 'cm ^partial ^configure' 命令一样会
|
||
允许使用新的分支配置来配置工作区。
|
||
|
||
示例:
|
||
|
||
cm ^switch ^br:/main/task
|
||
(将 /main/task 设置为工作分支并更新工作区。)
|
||
|
||
cm ^switch ^br:/main/task --^configure +/art/images
|
||
(将 /main/task 设置为工作分支,并配置工作区来
|
||
加载 /art/images 文件夹。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UNDOCHECKOUT ==
|
||
撤销项的签出。
|
||
|
||
== CMD_USAGE_PARTIAL_UNDOCHECKOUT ==
|
||
用法:
|
||
|
||
cm ^partial ^undocheckout | ^unco <项路径>[ ...][--^silent]
|
||
|
||
项路径 要应用操作的项。使用双引号 (" ")
|
||
指定包含空格的路径。使用空格对各个路径
|
||
进行分隔。
|
||
使用 . 将操作应用到当前目录。
|
||
|
||
选项:
|
||
|
||
--^silent 不显示任何输出。
|
||
|
||
== CMD_HELP_PARTIAL_UNDOCHECKOUT ==
|
||
备注:
|
||
|
||
如果已签出某个项并且不想将这个项签入,则可以
|
||
使用此命令撤销签出。文件和文件夹都可以取消
|
||
签出。项将更新为签出之前的状态。
|
||
|
||
要求:
|
||
- 项必须受源代码管理。
|
||
- 必须签出项。
|
||
|
||
示例:
|
||
|
||
cm ^partial ^undocheckout .
|
||
(撤销当前目录中的签出。)
|
||
|
||
cm ^partial ^undocheckout pic1.png pic2.png
|
||
cm ^unco c:\workspace\design01.png
|
||
(撤销签出所选文件。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UNDO ==
|
||
撤销工作区中的更改。
|
||
|
||
== CMD_USAGE_PARTIAL_UNDO ==
|
||
用法:
|
||
|
||
cm ^partial ^undo [<路径>[ ...]] [--^symlink] [-^r | --^recursive]
|
||
[<筛选器>[ ...]]
|
||
[--^silent | --^machinereadable [--^startlineseparator=<分隔符>]
|
||
[--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
|
||
|
||
路径 要应用操作的文件或目录
|
||
的路径。使用双引号 (" ") 指定
|
||
包含空格的路径。使用空格对各个路径
|
||
进行分隔。
|
||
如果未指定路径,则默认情况下,
|
||
撤销操作将应用于当前目录中的所有
|
||
文件。
|
||
筛选器 将一个或多个指定筛选器应用于给定
|
||
路径。使用空格对各个筛选器进行分隔。请参阅
|
||
“筛选器”部分以了解更多信息。
|
||
|
||
选项:
|
||
|
||
--^symlink 将撤销操作应用于符号链接而不是
|
||
目标。
|
||
-^r 以递归方式执行撤销。
|
||
--^silent 不显示任何输出。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何开头。
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何结尾。
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
应如何分隔字段。
|
||
|
||
筛选器:
|
||
|
||
如果未指定标志,则默认情况下将撤销所有更改,但是
|
||
可以使用以下一个或多个标志来筛选路径。
|
||
如果文件或目录匹配一个或多个指定种类的更改,
|
||
则将撤销该文件或目录上的所有更改。
|
||
例如,如果同时指定了 '--^checkedout' 和 '--^moved',则在
|
||
已签出并移动文件的情况下,两项更改都将被撤销。
|
||
|
||
--^checkedout 选择已签出的文件和目录。
|
||
--^unchanged 选择内容不变的文件。
|
||
--^changed 选择本地更改的或签出的文件和
|
||
目录。
|
||
--^deleted 选择已删除的文件和目录。
|
||
--^moved 选择已移动的文件和目录。
|
||
--^added 选择已添加的文件和目录。
|
||
|
||
== CMD_HELP_PARTIAL_UNDO ==
|
||
备注:
|
||
|
||
^undo 命令有风险,因为该命令在撤销工作后将不可逆。
|
||
^undo 完成后,无法将受其影响的文件和目录
|
||
恢复到先前状态。如果参数中
|
||
未指定路径,则默认情况下,该命令将撤销
|
||
当前目录中的所有更改,但不采用递归方式。
|
||
从 /src 目录执行时,以下命令是等效的:
|
||
|
||
/src
|
||
|- file.txt
|
||
|- code.cs
|
||
\- /test
|
||
|- test_a.py
|
||
\- test_b.py
|
||
|
||
cm ^partial ^undo
|
||
cm ^partial ^undo *
|
||
cm ^partial ^undo file.txt code.cs /test
|
||
|
||
cm ^partial ^undo .
|
||
cm ^partial ^undo /src file.txt code.cs
|
||
|
||
如果希望操作以递归方式执行,必须指定 '-^r' 标志。
|
||
|
||
撤销某一目录下的所有更改(包括影响目录
|
||
本身的更改):
|
||
|
||
cm ^partial ^undo 目录路径 -^r
|
||
|
||
如果目录路径是工作区路径,则工作区中的每个更改都将
|
||
被撤销。
|
||
|
||
示例:
|
||
|
||
cm ^partial ^undo .-^r
|
||
(以递归方式撤销当前目录中的所有更改。如果从工作区的
|
||
根目录执行,则撤销整个工作区中的所有更改。)
|
||
|
||
cm ^partial ^co file.txt
|
||
cm ^partial ^undo file.txt
|
||
(撤销对 file.txt 的签出。)
|
||
|
||
^echo ^content >> file.txt
|
||
cm ^partial ^undo file.txt
|
||
(撤销对 file.txt 的本地更改。)
|
||
|
||
cm ^partial ^undo src
|
||
(撤销对 src 目录及其文件的更改。)
|
||
|
||
cm ^partial ^undo src/*
|
||
(撤销对 src 中包含的每个文件和目录的更改,而不会
|
||
影响 src。)
|
||
|
||
cm ^partial ^undo *.cs
|
||
(撤销对当前目录中与 *.cs 匹配的每个文件或目录的
|
||
更改。)
|
||
|
||
cm ^partial ^undo *.cs-^r
|
||
(撤销对当前目录以及下级每个目录中与 *.cs 匹配的
|
||
每个文件或目录的更改。)
|
||
|
||
cm ^partial ^co file1.txt file2.txt
|
||
^echo ^content >> file1.txt
|
||
cm ^partial ^undo --^unchanged
|
||
(撤销对未更改的 file2.txt 的签出,并忽略本地更改的
|
||
file1.txt。)
|
||
|
||
^echo ^content >> file1.txt
|
||
^echo ^content >> file2.txt
|
||
cm ^partial ^co file1.txt
|
||
cm ^partial ^undo --^checkedout
|
||
(撤销已签出文件 file1.txt 中的更改,并忽略 file2.txt,
|
||
因为后者未签出。)
|
||
|
||
cm ^partial ^add file.txt
|
||
cm ^partial ^undo file.txt
|
||
(撤销添加 file.txt,使该文件再次成为私有文件。)
|
||
|
||
^rm file1.txt
|
||
^echo ^content >> file2.txt
|
||
cm ^partial ^add file3.txt
|
||
cm ^partial ^undo --^deleted --^added *
|
||
(撤销 file1.txt 的删除和 file3.txt 的添加,并忽略 file2.txt
|
||
的更改。)
|
||
|
||
== CMD_DESCRIPTION_PARTIAL_UPDATE ==
|
||
更新非完整的工作区并下载最新的更改。
|
||
|
||
== CMD_USAGE_PARTIAL_UPDATE ==
|
||
用法:
|
||
|
||
cm ^partial ^update [<项路径>[ ...]] [--^changeset=<编号>]
|
||
[--^silent | --^report] [--^dontmerge]
|
||
|
||
项路径 要更新的项。使用双引号 (" ") 指定
|
||
包含空格的路径。使用空格对各个路径进行
|
||
分隔。
|
||
使用 . 将更新应用到当前目录。
|
||
如果未指定路径,则当前非完整的
|
||
工作区将完全更新。
|
||
|
||
选项:
|
||
|
||
--^changeset 将非完整的工作区更新到特定变更集。
|
||
--^silent 不显示任何输出。
|
||
--^report 命令完成后,打印已应用更改
|
||
的列表。使用 '--^silent' 将会覆盖此设置。
|
||
--^dontmerge 不合并文件冲突,只是跳过这些冲突。
|
||
其他更改会正确应用。此选项可用于
|
||
自动化,从而避免用户交互。
|
||
|
||
|
||
== CMD_HELP_PARTIAL_UPDATE ==
|
||
备注:
|
||
|
||
'^partial ^update' 命令将更新已过期的文件。
|
||
|
||
该命令采用递归操作。
|
||
|
||
在使用 '--^changeset' 选项时,如果所有指定的路径都是
|
||
同一 Xlink 内的文件,则会在通过 Xlink 链接的存储库的
|
||
指定变更集内搜索要下载的版本。
|
||
|
||
示例:
|
||
|
||
cm ^partial ^update
|
||
(更新当前非完整的工作区中的所有内容。)
|
||
|
||
cm ^partial ^update .
|
||
(更新所有当前目录子项。)
|
||
|
||
cm ^partial ^update backgroud-blue.png
|
||
(更新 'backgroud-blue.png' 项。)
|
||
|
||
cm ^partial ^update soft_black.png soft-grey.png
|
||
(更新 'soft_black.png' 和 'soft-grey.png' 项。)
|
||
|
||
cm ^partial ^update src --^report
|
||
(更新所有 'src' 目录子项,并在最后打印已应用的
|
||
更改列表。)
|
||
|
||
cm ^partial ^update src --^changeset=4
|
||
(将所有 'src' 目录子项更新为变更集 4 中
|
||
加载的相应内容。)
|
||
|
||
cm ^partial ^update xlink/first.png --^changeset=4
|
||
(将 'xlink/first.png' 项更新为通过 Xlink 链接的存储库的变更集 4 中
|
||
加载的相应内容。)
|
||
|
||
== CMD_DESCRIPTION_PATCH ==
|
||
从规格生成一个补丁文件,或者将生成的补丁应用于当前
|
||
工作区。
|
||
|
||
== CMD_USAGE_PATCH ==
|
||
用法:
|
||
|
||
cm ^patch <源规格> [<源规格>] [--^output=<输出文件>]
|
||
[--^tool=<差异比较路径>]
|
||
生成一个补丁文件,该文件包含分支的差异差、
|
||
变更集的差异差或变更集之间的差异。还用于跟踪
|
||
文本文件和二进制文件的差异。
|
||
|
||
cm ^patch --^apply <补丁文件> [--^tool=<修补路径>]
|
||
允许应用当前工作区中生成的补丁文件的
|
||
内容。
|
||
|
||
源规格 变更集或分支的完整规格。(使用
|
||
'cm ^help ^objectspec' 可进一步了解规格。)
|
||
输出文件 用于保存补丁内容的文件。如果未指定文件,
|
||
则会在标准输出中打印补丁内容。
|
||
补丁文件 要在当前工作区中应用的补丁文件。
|
||
|
||
选项:
|
||
|
||
--^output 设置 patch 命令的输出文件。
|
||
--^tool 设置要使用的应用程序(差异比较还是修补)。
|
||
|
||
== CMD_HELP_PATCH ==
|
||
限制:
|
||
|
||
如果输出补丁文件已经存在,该命令不会覆盖这个文件。
|
||
|
||
应用补丁时,如果磁盘上没有已修改的文件,该命令不会
|
||
将更改应用于这些文件。
|
||
|
||
重要信息:
|
||
|
||
此命令需要差异比较工具和修补工具;可从以下网址公开获得这些工具:
|
||
http://gnuwin32.sourceforge.net/packages/patch.htm 和
|
||
http://gnuwin32.sourceforge.net/packages/diffutils.htm
|
||
|
||
安装后,建议将工具的位置添加到 PATH
|
||
环境变量。
|
||
|
||
示例:
|
||
|
||
cm ^patch ^cs:4@default@localhost:8084
|
||
(以统一格式在控制台上打印变更集 4 的差异。)
|
||
|
||
cm ^patch ^br:/main --^output=file.patch
|
||
(使用分支 "main" 的差异来生成补丁文件。)
|
||
|
||
cm ^patch ^br:/main --^output=file.patch --^tool=C:\gnu\diff.exe
|
||
(同上,使用的是自定义执行程序。)
|
||
|
||
cm ^patch ^cs:2@default ^cs:4@default
|
||
(以统一格式在控制台上打印变更集 2 和 4 之间的差异。)
|
||
|
||
cm ^patch --^apply file.patch --^tool=C:\gnu\patch.exe
|
||
(使用自定义执行程序将 'file.patch' 中的补丁应用于本地工作区。)
|
||
|
||
== CMD_DESCRIPTION_QUERY ==
|
||
执行 SQL 查询。需要 SQL 存储。
|
||
|
||
== CMD_USAGE_QUERY ==
|
||
用法:
|
||
|
||
cm ^query <SQL_命令> [--^outputfile=<输出文件>]
|
||
[--^solveuser=<列名称>[,...]]
|
||
[--^solvepath=<列名称>[,...]]
|
||
[--^columnwidth=<值>] [--^nocolumnname]
|
||
[--^columnseparator=<分隔符>] [--^repository=<名称>]
|
||
|
||
SQL_命令 要执行的 SQL 查询。
|
||
|
||
选项:
|
||
|
||
--^outputfile 将结果写入输出文件中。
|
||
--^solveuser 将指定的列设置为用户名列。查询
|
||
解释器将假定这些列的数据将是用户,
|
||
并将尝试解析这些数据。
|
||
--^solvepath 将指定的列设置为 itemid 列。查询
|
||
解释器将尝试将项 ID 解析为文件系统
|
||
路径。
|
||
--^columnwidth 指定每列的宽度以便格式化输出。
|
||
--^nocolumnname 不打印列名称。
|
||
--^columnseparator 使用字符作为列分隔符,而不是使用制表符 (\t)。
|
||
--^repository 要查询的存储库。
|
||
|
||
== CMD_HELP_QUERY ==
|
||
备注:
|
||
|
||
此命令允许用户在服务器数据库中执行 SQL 查询。
|
||
|
||
为了编写 SQL 查询,请使用以下两个预定义的函数来管理
|
||
用户和路径:
|
||
- '^SolveUser(<用户名>)',将用户名解析为 Unity VCS 格式。
|
||
- '^SolvePath(<路径>)',将磁盘路径解析为项 ID。
|
||
|
||
此外,还可使用选项以便于人工阅读的形式显示查询结果。
|
||
|
||
可以使用选项 '--^solveuser=<列名称>' 和
|
||
'--^solvepath=<列名称>' 来指定必须由查询解释器
|
||
转换为易读文本的列。可以指定多个列名称,
|
||
以逗号分隔。
|
||
|
||
示例:
|
||
|
||
cm ^query "^SELECT * ^FROM ^revision" --^columnwidth=25 --^repository=reptest
|
||
(从存储库 'reptest' 中的 '修订' 表检索数据。)
|
||
|
||
cm ^query "^SELECT b.^sname ^as 分支名称, o.^dtimestamp ^as 日期 ^from ^branch b, \
|
||
^object o, ^seid s ^where b.^iobjid=o.^iobjid ^and o.^fidowner=s.^iseidid ^and \
|
||
s.^scode='^SolveUser(john)'" --^outputfile=query.txt
|
||
(将所有者为 'john' 的分支输出到文件中。)
|
||
|
||
cm ^query "^select r.^iobjid, r.^fiditem ^as 路径, s.^scode ^as 用户名 ^FROM \
|
||
^revision r, ^object o, ^seid s ^WHERE r.^iobjid=o.^iobjid ^and \
|
||
o.^fidowner=s.^iseidid ^and o.^dtimestamp>2014/04/25" \
|
||
--^solveuser=用户名 --^solvepath=路径 --^repository=reptest@server2:9095
|
||
(从所选存储库检索选定数据。)
|
||
|
||
cm ^query "^SELECT * ^FROM ^revision ^WHERE ^fiditem=^SolvePath(c:\mywkpath\info)"
|
||
(检索路径 'info' 的所有修订数据。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_DELETE ==
|
||
删除一个或多个属性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_DELETE ==
|
||
用法:
|
||
|
||
cm ^attribute | ^att ^delete | ^rm <属性规格>[ ...]
|
||
|
||
属性规格 要删除的属性。使用空格对各个属性进行
|
||
分隔。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解属性
|
||
规格。)
|
||
|
||
== CMD_HELP_ATTRIBUTE_DELETE ==
|
||
备注:
|
||
|
||
此命令将删除一个或多个属性。
|
||
|
||
示例:
|
||
|
||
cm ^attribute ^delete ^att:status
|
||
(删除属性 '状态'。)
|
||
|
||
cm ^att ^rm 状态 ^att:integrated@reptest@server2:8084
|
||
(删除属性 '状态' 和 '集成'。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_UNSET ==
|
||
取消设置对象的属性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_UNSET ==
|
||
用法:
|
||
|
||
cm ^attribute | ^att ^unset <属性规格> <对象规格>
|
||
|
||
属性规格 属性的规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解属性规格。)
|
||
对象规格 要删除相应属性的对象
|
||
的规格。可以在以下对象上设置属性:分支、变更集、
|
||
搁置集、标签、项和修订。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
== CMD_HELP_ATTRIBUTE_UNSET ==
|
||
备注:
|
||
|
||
该命令将取消设置先前在对象上设置的某个属性。该命令
|
||
不会删除属性对象本身。
|
||
|
||
示例:
|
||
|
||
cm ^attribute ^unset ^att:status ^br:/main/SCM105
|
||
(从分支 'main/SCM105' 删除属性实现 '状态'。)
|
||
|
||
cm ^att ^unset ^att:integrated@reptest@localhost:8084 ^cs:25@reptest@localhost:8084
|
||
(从变更集 25 删除属性实现 '集成',全都在
|
||
存储库 'reptest' 中。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_RENAME ==
|
||
为属性重命名。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_RENAME ==
|
||
用法:
|
||
|
||
cm ^attribute | ^att ^rename <属性规格> <新名称>
|
||
|
||
属性规格 要重命名的属性。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解属性规格。)
|
||
新名称 属性的新名称。
|
||
|
||
== CMD_HELP_ATTRIBUTE_RENAME ==
|
||
备注:
|
||
|
||
此命令将重命名一个属性。
|
||
|
||
示例:
|
||
|
||
cm ^attribute ^rename ^att:status state
|
||
(将属性 '状态' 重命名为 '状况'。)
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_EDIT ==
|
||
编辑属性的注释。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_EDIT ==
|
||
用法:
|
||
|
||
cm ^attribute | ^att ^edit <属性规格> <新注释>
|
||
|
||
属性规格 要更改相应注释的属性。(使用 'cm ^help ^objectspec'
|
||
可进一步了解属性规格。)
|
||
新注释 属性的新注释。还可以为属性指定
|
||
一个默认值列表。
|
||
|
||
== CMD_HELP_ATTRIBUTE_EDIT ==
|
||
备注:
|
||
|
||
此命令将更改属性的注释。
|
||
|
||
要指定属性的默认值列表,只需将
|
||
如下的行包含在属性注释中:
|
||
'default: 值_一, "值二", 值3, "最终值"'。
|
||
|
||
示例:
|
||
|
||
cm ^attribute ^edit ^att:status "CI 管道中分支的状态。"
|
||
(编辑属性 '状态' 的注释。)
|
||
|
||
cm ^attribute ^edit ^att:status "分支的状态。默认值:未完成、已解决、已审查"
|
||
(编辑属性 '状态' 的注释。还指定一个值
|
||
列表。因此,当属性 '状态' 设置为对象时,可以选择
|
||
以下值之一:"未完成"、"已解决" 或 "已审查"。)
|
||
|
||
== CMD_DESCRIPTION_REPLICATE ==
|
||
警告:已弃用此命令。
|
||
|
||
请使用 'cm ^pull'(等同于 '^replicate')和 'cm ^push'(等同于
|
||
'^replicate --^push')。
|
||
|
||
== CMD_USAGE_REPLICATE ==
|
||
|
||
== CMD_HELP_REPLICATE ==
|
||
|
||
== CMD_DESCRIPTION_PULL ==
|
||
从另一个存储库拉取分支。
|
||
|
||
== CMD_USAGE_PULL ==
|
||
用法:
|
||
|
||
cm ^pull <源分支规格> <目标存储库规格>
|
||
[--^preview] [--^nodata] [转换选项]
|
||
[--^user=<用户名> [--^password=<密码>] | 身份验证选项]
|
||
(服务器之间的直接复制。从存储库拉取分支。)
|
||
|
||
cm ^pull <目标存储库规格> --^package=<包文件> [身份验证选项]
|
||
(基于包的复制。将包导入目标存储库中。)
|
||
|
||
cm ^pull ^hydrate <目标分支规格> [<源存储库规格>]
|
||
[--^user=<用户名> [--^password=<密码>] | 身份验证选项]
|
||
(为分支中先前使用 '--^nodata' 复制的所有变更集
|
||
引入缺失的数据。如果未指定用于获取数据的存储库,
|
||
Unity VCS 会尝试使用“复制源”(复制分支
|
||
的来源))。
|
||
|
||
cm ^pull ^hydrate <目标变更集规格> [<源存储库规格>]
|
||
[--^user=<用户名> [--^password=<密码>] | 身份验证选项]
|
||
(为先前使用 '--^nodata' 复制的变更集引入缺失的
|
||
数据。如果未指定用于获取数据的存储库,Unity VCS 会尝试
|
||
使用“复制源”)。
|
||
|
||
源分支规格 要从远程存储库拉取的分支。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支规格。)
|
||
目标分支规格 要进行 hydrate 的分支。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支规格。)
|
||
目标变更集规格 要进行 hydrate 的变更集。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集
|
||
规格。)
|
||
目标存储库规格 目标存储库。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
规格。)
|
||
--^package 指定要导入的先前创建的包文件以进行
|
||
基于包的复制。
|
||
适合在没有直接网络连接时用于在服务器
|
||
之间移动数据。
|
||
请参阅 'cm ^push' 以创建包文件。
|
||
|
||
选项:
|
||
|
||
--^preview 提供关于将拉取哪些更改的信息,
|
||
但实际上不进行任何更改。此选项
|
||
可用于检查在复制更改之前要传输
|
||
的数据。
|
||
--^nodata 复制分支更改而不复制
|
||
数据。复制包时,不允许使用
|
||
此选项。
|
||
转换选项 请参阅“转换选项”部分以了解更多信息。
|
||
--^user, --^password 源和目标的身份验证模式不同并且
|
||
没有可用于目标身份验证的配置文件
|
||
的情况下使用的凭据。
|
||
身份验证选项 请参阅“身份验证选项”部分以了解更多
|
||
信息。
|
||
|
||
转换选项:
|
||
|
||
--^trmode=(^copy|^name|^table --^trtable=<转换表文件>)
|
||
源和目标存储库可能使用不同的身份验证
|
||
模式。'--^trmode' 选项指定如何将用户名从源
|
||
转换到目标。'--^trmode' 必须为以下值
|
||
之一:
|
||
^copy (默认值)。表示只会复制用户标识符。
|
||
^name 按名称来匹配用户标识符。
|
||
^table 使用选项 '--^trtable' 中指定的转换表
|
||
(见下文)。
|
||
|
||
--^trtable=<转换表文件>
|
||
如果转换模式为 'table',则转换表文件中包含
|
||
格式为 <旧名称;新名称> 的行(每行一个)。将分支
|
||
写入目标存储库时,源存储库中由“旧名称”
|
||
标识的用户所创建的对象将设置到目标上
|
||
具有“新名称”的用户。
|
||
|
||
身份验证选项:
|
||
|
||
可以使用以下两种模式之一来指定身份验证数据:
|
||
|
||
1) 使用身份验证参数:--^authmode=<模式> --^authdata=<数据>
|
||
|
||
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
|
||
示例:
|
||
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
'--^authdata' 行是 client.conf 文件和 profiles.conf 文件
|
||
中的 <^SecurityConfig> 条目的内容。可以从
|
||
Unity VCS GUI 中的“首选项”下的“复制配置文件”选项卡
|
||
轻松生成 profiles.conf 文件。
|
||
|
||
如果使用 ^UPWorkingMode,则只需指定:
|
||
|
||
--^authmode=^UPWorkingMode --^user=<用户> --^password=<密码>
|
||
|
||
2) 身份验证文件,对于连接到的每个服务器,文件可能会
|
||
有所不同,其中包含该服务器的凭据。
|
||
|
||
--^authfile=<身份验证文件>
|
||
该文件包含 2 行:
|
||
第 1 行是模式,如 '--^authmode' 中所述
|
||
第 2 行是身份验证数据,如 '--^authdata' 中所述
|
||
|
||
== CMD_HELP_PULL ==
|
||
备注:
|
||
|
||
'^pull' 命令可以在源存储库与目标存储库之间
|
||
复制分支(以及这些分支的变更集)。
|
||
这些存储库可以位于不同服务器中。
|
||
|
||
有两种复制操作:'^push' 和 '^pull'。
|
||
|
||
'^pull' 操作表示复制操作要求将数据从源存储库
|
||
存储到目标存储库。
|
||
客户端将连接到目标存储库,然后建立
|
||
从该主机到源存储库的连接以便检索
|
||
目标数据。在拉取期间,目标服务器将
|
||
连接到源。
|
||
|
||
尽管在典型的分布式场景中,开发者会将数据
|
||
从本地服务器推送到主服务器,但开发者可能也希望
|
||
从主服务器拉取最新的存储库更新。
|
||
|
||
复制操作可以解决在同一分支上两个复制的存储库
|
||
已进行并发更改的情况:
|
||
|
||
- 推送:如果尝试将数据推送到一个存储库,但这个存储库中的
|
||
更改比发送的更改更新,则系统会要求提取最新的更改,
|
||
解决合并操作问题,最后尝试再次推送。
|
||
|
||
- 拉取:每次从远程分支拉取变更集时,都会将这些变更集
|
||
正确链接到相应的父变更集。如果拉取的变更集不是
|
||
分支中最后一个变更集的子级,则会出现
|
||
一种多头场景。该分支将具有多个“头部”,即分支中的
|
||
最后一个变更集。此时需要先合并两个“头部”,
|
||
然后才能再次推送。
|
||
|
||
可以按两种模式进行拉取:
|
||
|
||
1) 服务器之间的直接通信:目标服务器将
|
||
从源服务器提取数据,自动为指定
|
||
分支同步数据。
|
||
|
||
2) 使用推送和 '--^package' 选项来导入先前生成的包。
|
||
|
||
模式 1) 要求远程服务器对运行命令的用户进行身份验证,
|
||
方法是使用 client.conf 文件中的默认身份验证,
|
||
或者指定 '--^authmode' 和 '--^authdata' 修饰符
|
||
或 '--^authmode'、'--^user' 和 '--^password'(如果身份验证模式为
|
||
^UPWorkingMode)。
|
||
|
||
模式 2) 要求使用先前通过推送命令生成的
|
||
包文件。
|
||
|
||
请记住,拉取复制是以间接方式进行的。执行时,
|
||
该命令要求目标存储库连接到源
|
||
并获取所选分支。
|
||
|
||
然而,可以使用推送命令来直接实现这一点。
|
||
因此,该命令会将所选分支从源复制到
|
||
目标。
|
||
|
||
示例:
|
||
|
||
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084
|
||
(将 'main' 分支从 'remoteserver' 拉取到 'myserver'。这种情况下,
|
||
两个服务器会配置为相同的身份验证模式。)
|
||
|
||
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 \
|
||
--^authmode=^LDAPWorkingMode --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(拉取与以前相同的分支,但现在将远程服务器配置为
|
||
使用 Active Directory 对用户进行身份验证。例如,我正在从 Linux
|
||
计算机连接到配置为使用 Active Directory 集成模式
|
||
的 Windows 服务器。我会指定自己的 Active Directory 用户名和密码,
|
||
并以 LDAP 形式将此信息传递给服务器。)
|
||
|
||
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 \
|
||
--^authmode=^UPWorkingMode --^user=dave --^password=mysecret
|
||
(拉取同一个分支,但现在利用 Unity VCS 中
|
||
包含的用户名/密码数据库在远程服务器上对用户
|
||
进行身份验证。)
|
||
|
||
cm ^pull ^br:/main@project1@remoteserver:8084 projectx@myserver:8084 --^nodata
|
||
(将 'main' 分支从 'remoteserver' 复制到 'myserver' 而不复制数据。)
|
||
|
||
cm ^pull ^hydrate ^br:/main@projectx@myserver:8084 projectx@remoteserver:8084
|
||
(从远程服务器获取数据,对 'main' 分支中的所有变更集
|
||
进行 hydrate 操作。)
|
||
|
||
cm ^pull ^hydrate ^cs:122169@projectx@myserver:8084 projectx@remoteserver:8084
|
||
(从远程服务器获取数据,对 'myserver' 中的变更集 122169 进行
|
||
hydrate 操作。)
|
||
|
||
== CMD_DESCRIPTION_PUSH ==
|
||
将分支推送到另一个存储库。
|
||
|
||
== CMD_USAGE_PUSH ==
|
||
用法:
|
||
|
||
cm ^push <源分支规格> <目标存储库规格>
|
||
[--^preview] [转换选项]
|
||
[--^user=<用户名> [--^password=<密码>] | 身份验证选项]
|
||
(服务器之间的直接复制。从存储库推送分支。)
|
||
|
||
cm ^push <源分支规格> --^package=<包文件> [身份验证选项]
|
||
(基于包的复制。使用所选分支在源服务器中
|
||
创建复制包。)
|
||
|
||
源分支规格 要推送到远程存储库的分支。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支规格。)
|
||
目标存储库规格 目标存储库。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
规格。)
|
||
--^package 指定复制包的导出路径,从而进行
|
||
基于包的复制。
|
||
适合在没有直接网络连接时用于在服务器
|
||
之间移动数据。
|
||
|
||
选项:
|
||
|
||
--^preview 提供关于将推送哪些更改的信息,
|
||
但实际上不进行任何更改。此选项
|
||
可用于检查在复制更改之前要传输
|
||
的数据。
|
||
转换选项 请参阅“转换选项”部分以了解更多信息。
|
||
--^user, --^password 源和目标的身份验证模式不同并且
|
||
没有可用于目标身份验证的配置文件
|
||
的情况下使用的凭据。
|
||
身份验证选项 请参阅“身份验证选项”部分以了解更多
|
||
信息。
|
||
|
||
转换选项:
|
||
|
||
--^trmode=(^copy|^name|^table --^trtable=<转换表文件>)
|
||
源和目标存储库可能使用不同的身份验证
|
||
模式。'--^trmode' 选项指定如何将用户名从源
|
||
转换到目标。'--^trmode' 必须为以下值
|
||
之一:
|
||
^copy (默认值)。表示只会复制用户标识符。
|
||
^name 按名称来匹配用户标识符。
|
||
^table 使用选项 '--^trtable' 中指定的转换表
|
||
(见下文)。
|
||
|
||
--^trtable=<转换表文件>
|
||
如果转换模式为 'table',则转换表文件中包含
|
||
格式为 <旧名称;新名称> 的行(每行一个)。将分支
|
||
写入目标存储库时,源存储库中由“旧名称”
|
||
标识的用户所创建的对象将设置到目标上
|
||
具有“新名称”的用户。
|
||
|
||
身份验证选项:
|
||
|
||
可以使用以下两种模式之一来指定身份验证数据:
|
||
|
||
1) 使用身份验证参数:--^authmode=<模式> --^authdata=<数据>
|
||
|
||
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
|
||
示例:
|
||
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
'--^authdata' 行是 client.conf 文件和 profiles.conf 文件
|
||
中的 <^SecurityConfig> 条目的内容。可以从
|
||
Unity VCS GUI 中的“首选项”下的“复制配置文件”选项卡
|
||
轻松生成 profiles.conf 文件。
|
||
|
||
如果使用 ^UPWorkingMode,则只需指定:
|
||
|
||
--^authmode=^UPWorkingMode --^user=<用户> --^password=<密码>
|
||
|
||
2) 身份验证文件,对于连接到的每个服务器,文件可能会
|
||
有所不同,其中包含该服务器的凭据。
|
||
|
||
--^authfile=<身份验证文件>
|
||
该文件包含 2 行:
|
||
第 1 行是模式,如 '--^authmode' 中所述
|
||
第 2 行是身份验证数据,如 '--^authdata' 中所述
|
||
|
||
== CMD_HELP_PUSH ==
|
||
备注:
|
||
|
||
'^push' 命令可以在源存储库与目标存储库之间
|
||
复制分支(以及这些分支的变更集)。
|
||
这些存储库可以位于不同服务器中。
|
||
|
||
有两种复制操作:'^push' 和 '^pull'。
|
||
|
||
'^push' 操作表示复制操作会将数据从源存储库
|
||
发送到目标存储库。在这种情况下,
|
||
客户端将连接到源存储库,获取要复制的数据,
|
||
然后将数据发送到目标存储库。虽然
|
||
前者(源)必须与目标连接,但是后者(目标)
|
||
本身不会连接到源。
|
||
|
||
在典型的分布式场景中,开发者会将数据从本地服务器
|
||
推送到主服务器。此外,开发者可能也希望从主服务器
|
||
拉取最新的存储库更新。
|
||
|
||
复制可以解决在两个复制存储库的同一分支上
|
||
已进行并发更改的情况。
|
||
|
||
- 推送:如果尝试将数据推送到一个存储库,但这个存储库中的
|
||
更改比发送的更改更新,则系统会要求提取最新的更改,
|
||
解决合并操作问题,最后尝试再次推送。
|
||
|
||
- 拉取:每次从远程分支拉取变更集时,都会将这些变更集
|
||
正确链接到相应的父变更集。如果拉取的变更集不是
|
||
分支中最后一个变更集的子级,则会出现
|
||
一种多头场景。该分支将具有多个“头部”,即分支中的
|
||
最后一个变更集。此时需要先合并两个“头部”,
|
||
然后才能再次推送。
|
||
|
||
可以按两种模式进行推送:
|
||
|
||
1) 服务器之间的直接通信:源服务器将
|
||
把数据发送到目标服务器,自动为指定
|
||
分支同步数据。
|
||
|
||
2) 导出包模式:客户端将仅连接到源
|
||
并获取指定分支的数据和元数据来生成一个
|
||
复制包。此模式下将使用 '--^package' 修饰符。
|
||
|
||
这两种模式都要求服务器对运行命令的用户进行身份验证,
|
||
方法是使用 client.conf 文件中的默认身份验证,
|
||
或者指定 '--^authmode' 和 '--^authdata' 修饰符。
|
||
|
||
^push 推送复制是以直接方式进行的。执行时,
|
||
该命令将所选分支从源复制到目标
|
||
(而不是要求目标存储库连接到源)并获取
|
||
所选分支(与拉取操作一样)。
|
||
|
||
示例:
|
||
|
||
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084
|
||
(将 'main' 分支从 'myserver' 复制到 'remoteserver'。这种情况下,
|
||
两个服务器会配置为相同的身份验证模式。)
|
||
|
||
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084 \
|
||
--^authmode=^LDAPWorkingMode --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(复制与以前相同的分支,但现在将远程服务器配置为
|
||
使用 Active Directory 对用户进行身份验证。例如,我正在从 Linux
|
||
计算机连接到配置为使用 Active Directory 集成模式
|
||
的 Windows 服务器。我会指定自己的 Active Directory 用户名和密码,
|
||
并以 LDAP 形式将此信息传递给服务器。)
|
||
|
||
cm ^push ^br:/main@project1@myserver:8084 projectx@remoteserver:8084 \
|
||
--^authmode=^UPWorkingMode --^user=dave --^password=mysecret
|
||
(复制同一个分支,但现在利用 Unity VCS 中
|
||
包含的用户名/密码数据库在远程服务器上对用户
|
||
进行身份验证。)
|
||
|
||
== CMD_DESCRIPTION_CLONE ==
|
||
克隆远程存储库。
|
||
|
||
== CMD_USAGE_CLONE ==
|
||
用法:
|
||
|
||
cm ^clone <源存储库规格> [<目标存储库规格> | <目标存储库服务器规格>]
|
||
[--^user=<用户名> [--^password=<密码>] | 身份验证选项]
|
||
[转换选项]
|
||
(存储库之间的直接克隆。)
|
||
|
||
cm ^clone <源存储库规格> --^package=<包文件>
|
||
[--^user=<用户名> [--^password=<密码>] | 身份验证选项]
|
||
(克隆到中间包,随后可以使用拉取操作将中间包
|
||
导入到目标存储库。)
|
||
|
||
源存储库规格 克隆操作的源存储库。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
规格。)
|
||
目标存储库规格 克隆操作的目标存储库。如果
|
||
已存在,必须为空。如果不存在,
|
||
则会进行创建。
|
||
如果未指定,该命令将使用用户的
|
||
默认存储库服务器。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
规格。)
|
||
目标存储库服务器规格 克隆操作的目标存储库服务器。
|
||
如果存在与目标存储库服务器中的
|
||
<源存储库规格> 同名的存储库,此存储库
|
||
必须为空。如果没有,则会进行创建。
|
||
如果未指定,该命令将使用用户的
|
||
默认存储库服务器。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解存储库
|
||
服务器规格。)
|
||
|
||
选项:
|
||
|
||
--^user, --^password 源和目标的身份验证模式不同并且
|
||
没有可用于目标身份验证的配置文件
|
||
的情况下使用的凭据。
|
||
--^package 将指定的存储库导出到包文件,
|
||
而不是存储库。
|
||
适合在没有直接网络连接时用于在服务器
|
||
之间移动数据。
|
||
必须使用拉取命令来导入
|
||
生成的包。
|
||
转换选项 请参阅“转换选项”部分以了解更多信息。
|
||
身份验证选项 请参阅“身份验证选项”部分以了解更多
|
||
信息。
|
||
|
||
转换选项:
|
||
--^trmode=(^copy|^name|^table --^trtable=<转换表文件>)
|
||
源和目标存储库可能使用不同的身份验证
|
||
模式。'--^trmode' 选项指定如何将用户名从源
|
||
转换到目标。'--^trmode' 必须为以下值
|
||
之一:
|
||
^copy (默认值)。表示只会复制用户标识符。
|
||
^name 按名称来匹配用户标识符。
|
||
^table 使用选项 '--^trtable' 中指定的转换表
|
||
(见下文)。
|
||
|
||
--^trtable=<转换表文件>
|
||
如果转换模式为 'table',则转换表文件中包含
|
||
格式为 <旧名称;新名称> 的行(每行一个)。将分支
|
||
写入目标存储库时,源存储库中由“旧名称”
|
||
标识的用户所创建的对象将设置到目标上
|
||
具有“新名称”的用户。
|
||
|
||
身份验证选项:
|
||
|
||
可以使用以下两种模式之一来指定身份验证数据:
|
||
|
||
1) 使用身份验证参数:--^authmode=<模式> --^authdata=<数据>
|
||
|
||
--^authmode=(^NameWorkingMode|^LDAPWorkingMode|^ADWorkingMode|^UPWorkingMode)
|
||
示例:
|
||
(^LDAPWorkingMode) --^authdata=::0:dave:fPBea2rPsQaagEW3pKNveA
|
||
(^UPWorkingMode) --^authdata=dave:fPBea2rPsQaagEW3pKNveA==
|
||
|
||
'--^authdata' 行是 client.conf 文件和 profiles.conf 文件
|
||
中的 <^SecurityConfig> 条目的内容。可以从
|
||
Unity VCS GUI 中的“首选项”下的“复制配置文件”选项卡
|
||
轻松生成 profiles.conf 文件。
|
||
|
||
如果使用 ^UPWorkingMode,则只需指定:
|
||
|
||
--^authmode=^UPWorkingMode --^user=<用户> --^password=<密码>
|
||
|
||
2) 身份验证文件,对于连接到的每个服务器,文件可能会
|
||
有所不同,其中包含该服务器的凭据。
|
||
|
||
--^authfile=<身份验证文件>
|
||
该文件包含 2 行:
|
||
第 1 行是模式,如 '--^authmode' 中所述
|
||
第 2 行是身份验证数据,如 '--^authdata' 中所述
|
||
|
||
== CMD_HELP_CLONE ==
|
||
备注:
|
||
|
||
克隆命令可以将分支(以及这些分支的变更集、
|
||
标签、属性、审查等)从源存储库复制到
|
||
目标存储库。这些存储库可以位于不同服务器中。
|
||
|
||
可以预先创建目标存储库,但是如果此存储库包含
|
||
以前的数据,克隆操作会失败。
|
||
|
||
克隆操作不会克隆存储库子模块,也不会克隆 Xlink 下的
|
||
存储库。
|
||
|
||
示例:
|
||
|
||
cm ^clone awesomeProject@tardis@cloud
|
||
(将 'awesomeProject' 存储库从 'tardis@cloud' 组织
|
||
克隆到同名的本地存储库。)
|
||
|
||
cm ^clone repo@server.home:9095 repo-local
|
||
(将 'repo' 从 'server.home:9095' 克隆到用户的默认存储库服务器
|
||
中的 'repo-local'。)
|
||
|
||
cm ^clone project@192.168.111.130:8084 ^repserver:192.168.111.200:9095
|
||
(将 'project' 存储库从 '192.168.111.130:8084' 克隆到
|
||
'project@192.168.111.200:9095'。)
|
||
|
||
cm ^clone project@ldapserver:8084 --authfile=credentials.txt \
|
||
--^trmode=table --^trtable=table.txt
|
||
(从 'ldapserver:8084' 克隆 'project' 存储库,使用针对
|
||
远程存储库的身份验证文件,并按照指定的
|
||
转换表来转换用户。)
|
||
|
||
cm ^clone project@server.home:9095 --^package=project.plasticpkg
|
||
cm ^repository ^create project@mordor.home:8084
|
||
cm ^pull --^package=project.plasticpkg project@mordor.home:8084
|
||
(将 'project' 存储库从 'server.home:9095' 克隆到包
|
||
'project.plasticpkg',随后通过拉取操作将这个包导入到
|
||
'mordor.home:8084' 的'project' 存储库。)
|
||
|
||
== CMD_DESCRIPTION_REVERT ==
|
||
将项还原到先前的修订。
|
||
|
||
== CMD_USAGE_REVERT ==
|
||
用法:
|
||
|
||
cm ^revert <修订规格>
|
||
|
||
修订规格 包含修订(修订的内容将加载到工作区中)
|
||
的变更集的规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解修订
|
||
规格。)
|
||
|
||
== CMD_HELP_REVERT ==
|
||
备注:
|
||
|
||
必须签入项。
|
||
|
||
示例:
|
||
|
||
cm ^revert dir#^cs:0
|
||
cm ^revert C:\mywks\dir\file1.txt#23456
|
||
|
||
== CMD_DESCRIPTION_HISTORY ==
|
||
显示文件或目录的历史记录。
|
||
|
||
== CMD_USAGE_HISTORY ==
|
||
用法:
|
||
|
||
cm ^history | ^hist <项路径>[ ...][--^long | --^format=<格式字符串>]
|
||
[--^symlink] [--^xml[=<输出文件>]] [--^encoding=<名称>]
|
||
|
||
项路径 项的路径。使用空格对各个路径进行分隔。使用
|
||
双引号 (" ") 指定包含空格的路径。
|
||
路径也可以是服务器路径修订。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
选项:
|
||
|
||
--^long 显示其他信息。
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
--^symlink 将历史记录操作应用于符号链接而不是
|
||
目标。
|
||
--^xml 以 XML 格式将输出打印到标准输出。
|
||
可以指定输出文件。
|
||
--^encoding 与 '--^xml' 选项结合使用,指定要在 XML 输出
|
||
中使用的编码(例如:utf-8)。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
|
||
== CMD_HELP_HISTORY ==
|
||
备注:
|
||
|
||
此命令将显示给定项的修订列表,以及每个修订的标签、
|
||
分支和注释信息。
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
{0} | {^date} 日期。
|
||
{1} | {^changesetid} 变更集编号。
|
||
{2} | {^branch} 分支。
|
||
{4} | {^comment} 注释。
|
||
{5} | {^owner} 所有者。
|
||
{6} | {^id} 修订 ID。
|
||
{7} | {^repository} 存储库。
|
||
{8} | {^server} 服务器。
|
||
{9} | {^repspec} 存储库规格。
|
||
{^tab} 插入一个制表符空格位。
|
||
{^newline} 插入一个新行。
|
||
|
||
示例:
|
||
|
||
cm ^history file1.txt "file 2.txt"
|
||
|
||
cm ^hist c:\workspace --^long
|
||
(显示所有信息。)
|
||
|
||
cm ^history 链接 --^symlink
|
||
(将历史记录操作应用于 '链接' 文件而不是目标,
|
||
适用于 UNIX 环境。)
|
||
|
||
cm ^history ^serverpath:/src/foo/bar.c#^br:/main/task001@myserver
|
||
(从给定分支中的服务器路径检索修订历史记录。)
|
||
|
||
== CMD_DESCRIPTION_REVISION_TREE ==
|
||
显示项的修订树。
|
||
|
||
== CMD_USAGE_REVISION_TREE ==
|
||
用法:
|
||
|
||
cm ^tree <路径> [--^symlink]
|
||
|
||
路径 项路径。
|
||
|
||
选项:
|
||
|
||
--^symlink 将操作应用于链接文件而不是目标。
|
||
|
||
== CMD_HELP_REVISION_TREE ==
|
||
示例:
|
||
|
||
cm ^tree fichero1.txt
|
||
cm ^tree c:\workspace
|
||
cm ^tree 链接 --^symlink
|
||
(将操作应用于链接文件而不是目标;适用于
|
||
UNIX 环境。)
|
||
|
||
== CMD_DESCRIPTION_REMOVE ==
|
||
允许用户删除文件和目录。
|
||
|
||
== CMD_USAGE_REMOVE ==
|
||
用法:
|
||
|
||
cm ^remove | ^rm <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^controlled(可选)
|
||
^private
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^remove <命令> --^usage
|
||
cm ^remove <命令> --^help
|
||
|
||
== CMD_HELP_REMOVE ==
|
||
示例:
|
||
|
||
cm ^remove \path\controlled_file.txt
|
||
cm ^remove ^private \path\private_file.txt
|
||
|
||
== CMD_DESCRIPTION_REMOVE_CONTROLLED ==
|
||
从版本控制中删除一个文件或目录。
|
||
|
||
== CMD_USAGE_REMOVE_CONTROLLED ==
|
||
用法:
|
||
|
||
cm ^remove | ^rm <项路径>[ ...][--^format=<格式字符串>]
|
||
[--^errorformat=<格式字符串>] [--^nodisk]
|
||
|
||
项路径 要删除的项路径。使用双引号 (" ") 指定
|
||
包含空格的路径。使用空格对各个路径进行
|
||
分隔。
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出进度
|
||
消息。请参阅“示例”以了解更多信息。
|
||
--^errorformat 检索特定格式的错误消息
|
||
(如果有)。请参阅“示例”以了解更多信息。
|
||
--^nodisk 从版本控制中删除相应的项,但是将该项保留在
|
||
磁盘上。
|
||
|
||
== CMD_HELP_REMOVE_CONTROLLED ==
|
||
备注:
|
||
|
||
磁盘中会删除项。删除的项会从源代码管理
|
||
中的父目录中被删除。
|
||
|
||
要求:
|
||
- 项必须受源代码管理。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^remove' 命令可从 stdin 读取路径。为此,请传递一个
|
||
破折号 "-"。
|
||
示例:cm ^remove -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要删除的文件。
|
||
示例:
|
||
dir /S /B *.c | cm ^remove -
|
||
(在 Windows 中,删除工作区中的所有 .c 文件。)
|
||
|
||
示例:
|
||
|
||
cm ^remove src
|
||
(删除 'src'。如果 src 是目录,则等同于
|
||
'cm ^remove -^R src'。)
|
||
|
||
cm ^remove c:\workspace\file.txt --^format="{0} - 已删除" \
|
||
--^errorformat="{0} - 删除时出错"
|
||
(从版本控制中和磁盘上删除 'file.txt',
|
||
如果操作成功,则写入 "c:\workspace\file.txt - ^REMOVED",
|
||
否则写入 "c:\workspace\file.txt - ^ERROR ^REMOVING"。)
|
||
|
||
cm ^remove c:\workspace\file.txt --^nodisk
|
||
(从版本控制中删除 'file.txt',但将其保留在磁盘上。)
|
||
|
||
== CMD_DESCRIPTION_REMOVE_PRIVATE ==
|
||
删除一个私有文件或目录。
|
||
|
||
警告:使用该命令删除的文件将被永久擦除而无法
|
||
恢复。建议使用 '--^dry-run' 选项来检查
|
||
哪些文件将受到该命令的影响。
|
||
|
||
== CMD_USAGE_REMOVE_PRIVATE ==
|
||
用法:
|
||
|
||
cm ^remove | ^rm ^private <路径>[ ...][-^R | -^r | --^recursive] [--^ignored]
|
||
[--^verbose] [--^dry-run]
|
||
|
||
路径 要删除的文件或目录的路径。使用双
|
||
引号 (" ") 指定包含空格的路径。使用
|
||
空格对各个路径进行分隔。
|
||
|
||
选项:
|
||
|
||
--^r 以递归方式从受控目录内删除私有
|
||
文件。
|
||
--^ignored 还删除已忽略和掩蔽的文件和目录。
|
||
--^verbose 打印所有受影响的路径。
|
||
--^dry-run 运行此命令而不在磁盘上进行任何更改。
|
||
|
||
== CMD_HELP_REMOVE_PRIVATE ==
|
||
备注:
|
||
|
||
如果路径是私有文件或目录,则会从磁盘上将其删除。
|
||
如果路径是受控文件,该命令会失败。
|
||
如果路径是受控目录,则除非指定 '-^r' 选项
|
||
,否则该命令将失败,在这种情况下,它将删除指定目录下的
|
||
所有私有文件和目录。
|
||
|
||
示例:
|
||
|
||
cm ^remove ^private private_directory
|
||
(删除 'private_directory'。)
|
||
|
||
cm ^remove ^private c:\workspace\controlled_directory
|
||
(失败,因为 'controlled_directory' 并非私有目录。)
|
||
|
||
cm ^remove ^private -^r c:\workspace\controlled_directory
|
||
(删除 'controlled_directory' 下的所有私有文件和目录。)
|
||
|
||
cm ^rm ^private --^dry-run --^verbose c:\workspace\controlled_directory -^r
|
||
(显示 'controlled_directory' 下的私有文件被删除所影响的
|
||
所有路径,实际上不删除任何内容。)
|
||
|
||
cm ^rm ^private --^verbose c:\workspace\controlled_directory -^r
|
||
(显示 'controlled_directory' 下的私有文件被删除所影响的
|
||
所有路径,并执行删除。)
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_DELETE ==
|
||
删除触发器。
|
||
|
||
== CMD_USAGE_TRIGGER_DELETE ==
|
||
用法:
|
||
|
||
cm ^trigger | ^tr ^delete | ^rm <子类型-类型> <位置编号>
|
||
[--^server=<存储库服务器规格>]
|
||
|
||
子类型-类型 触发器执行和触发器操作。
|
||
键入 'cm ^showtriggertypes' 可查看触发器类型
|
||
列表。
|
||
位置编号 创建触发器时分配给触发器的位置。
|
||
|
||
选项:
|
||
|
||
--^server 删除指定服务器上的触发器。
|
||
如果未指定服务器,则在客户端上配置的
|
||
服务器上执行命令。
|
||
|
||
== CMD_HELP_TRIGGER_DELETE ==
|
||
示例:
|
||
|
||
cm ^trigger ^delete ^after-setselector 4
|
||
cm ^tr ^rm ^after-setselector 4
|
||
|
||
== CMD_DESCRIPTION_ATTRIBUTE_SET ==
|
||
在给定对象上设置属性。
|
||
|
||
== CMD_USAGE_ATTRIBUTE_SET ==
|
||
用法:
|
||
|
||
cm ^attribute | ^att ^set <属性规格> <对象规格> <属性值>
|
||
|
||
属性规格 属性的规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解属性规格。)
|
||
对象规格 要设置相应属性的对象的规格。
|
||
可以在以下对象上设置属性:分支、变更集、
|
||
搁置集、标签、项和修订。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
属性值 要为对象设置的属性值。
|
||
|
||
== CMD_HELP_ATTRIBUTE_SET ==
|
||
备注:
|
||
|
||
可以在一个对象上设置属性来保存此对象的
|
||
其他信息。
|
||
可以在以下对象上设置属性:分支、变更集、
|
||
搁置集、标签、项和修订。
|
||
|
||
示例:
|
||
|
||
cm ^attribute ^set ^att:status ^br:/main/SCM105 未完成
|
||
(将属性 '状态' 设置为分支 'SCM105',值为 '未完成'。)
|
||
|
||
cm ^att ^set ^att:integrated@reptest@server2:8084 ^lb:LB008@reptest@server2:8084 是
|
||
(在存储库 'reptest' 中将属性 '集成' 设置为标签 'LB008',
|
||
值为 '是'。)
|
||
|
||
== CMD_DESCRIPTION_SETOWNER ==
|
||
设置对象的所有者。
|
||
|
||
== CMD_USAGE_SETOWNER ==
|
||
用法:
|
||
|
||
cm ^setowner | ^sto --^user=<用户名> | --^group=<组> <对象规格>
|
||
|
||
--^user 用户名。对象的新所有者。
|
||
--^group 组名称。对象的新所有者。
|
||
对象规格 要设置新所有者的对象的规格。
|
||
可以在以下对象上设置所有者:
|
||
存储库服务器、存储库、分支、变更集、
|
||
标签、项、修订和属性。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
== CMD_HELP_SETOWNER ==
|
||
备注:
|
||
|
||
对象的所有者可以是用户或组。
|
||
|
||
可以在以下对象上设置所有者:存储库服务器、
|
||
存储库、分支、变更集、标签、项、修订和属性。
|
||
|
||
示例:
|
||
|
||
cm ^setowner --^user=john ^repserver:localhost:8084
|
||
(将 'john' 设置为存储库服务器所有者。)
|
||
|
||
cm ^sto --^group=development ^rep:mainRep@PlasticServer:8084
|
||
(将 'development' 组设置为 'mainRep' 存储库的所有者。)
|
||
|
||
== CMD_DESCRIPTION_SETSELECTOR ==
|
||
将选择器设置为工作区。
|
||
|
||
== CMD_USAGE_SETSELECTOR ==
|
||
已弃用此命令。为了向后兼容,此命令仍然存在,
|
||
但是在 Plastic SCM 4.0 中,已在很大程度上弃用选择器。仍然存在的选择器
|
||
是为了指定工作分支或变更集,但不再支持
|
||
用于筛选路径的旧规则。
|
||
|
||
用法:
|
||
cm ^setselector | ^sts [--^file=<选择器文件>] [--^ignorechanges]
|
||
[--^forcedetailedprogress] [<工作区路径> | <工作区规格>]
|
||
|
||
选项:
|
||
|
||
--^file 要从中加载选择器的文件。
|
||
--^ignorechanges 忽略在更新工作区时
|
||
检测到待定更改的情况下显示
|
||
的待定更改警告消息。
|
||
--^forcedetailedprogress 即使在标准输出被重定向的情况下也要强制显示
|
||
详细进度。
|
||
工作区路径 用于设置选择器的工作区的路径。
|
||
工作区规格 工作区的规格。(使用 'cm ^help ^objectspec'
|
||
可进一步了解工作区规格。)
|
||
|
||
== CMD_HELP_SETSELECTOR ==
|
||
备注:
|
||
|
||
此命令将设置工作区的选择器。
|
||
|
||
工作区需要某些信息才能从存储库加载修订。
|
||
为了获得这些信息,Unity VCS 需要使用选择器。
|
||
|
||
通过使用选择器,可以从给定的分支、标签或
|
||
变更集加载修订。
|
||
|
||
如果未指定用于加载选择器的文件,则将执行默认的
|
||
操作系统编辑器。
|
||
|
||
示例选择器:
|
||
|
||
^repository "^default" // 工作存储库
|
||
^path "/" // 规则将应用于根目录
|
||
^branch "/^main" // 从 ^br:/^main 获取最新修订
|
||
^checkout "/^main" // 将签出内容放在 ^br:/^main 分支中
|
||
|
||
示例:
|
||
|
||
cm ^sts
|
||
(打开要应用的当前选择器文件。)
|
||
|
||
cm ^sts ^wk:workspace_projA@reptest
|
||
(打开要应用的指定选择器文件。)
|
||
|
||
cm ^setselector --^file=c:\selectors\sel.xml
|
||
(在当前工作区中设置指定的选择器文件。)
|
||
|
||
cm ^setselector --^file=c:\selectors\sel.xml ^wk:MyWorkspace
|
||
(在选定工作区中设置指定的选择器文件。)
|
||
|
||
== CMD_DESCRIPTION_SHELVE ==
|
||
搁置已签出项的内容。
|
||
|
||
== CMD_USAGE_SHELVE ==
|
||
已弃用此命令。请改用 'cm ^shelveset'。
|
||
|
||
用法:
|
||
|
||
cm ^shelve [<项路径>+] [--^all] [--^dependencies]
|
||
[-^c=注释字符串 | -^commentsfile=<注释文件>]
|
||
[--^encoding=名称] [--^comparisonmethod=比较方法]
|
||
(搁置内容。)
|
||
|
||
cm ^shelve --^apply=<搁置规格> [--^mount]
|
||
(应用存储的搁置集。)
|
||
|
||
--^apply 还原指定搁置集的已搁置内容。
|
||
搁置规格:查看 'cm ^help ^objectspec'。
|
||
|
||
cm ^shelve --^delete=<搁置规格>
|
||
(删除存储的搁置集。)
|
||
|
||
--^delete 删除指定的搁置集。
|
||
搁置集规格:查看 'cm ^help ^objectspec'。
|
||
|
||
选项:
|
||
|
||
项路径 要搁置的项(以空格分隔)。可以使用引号 (")
|
||
来指定包含空格的路径。
|
||
--^all 还包括在给定路径上进行了本地更改、
|
||
移动和删除的项。
|
||
--^dependencies 在要搁置的项中包含本地更改
|
||
依赖项。
|
||
-^c 将指定的注释应用于创建的搁置集。
|
||
-^commentsfile 将指定文件中的注释应用于创建的
|
||
搁置集。
|
||
--^encoding 指定输出编码,如:utf-8。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^comparisonmethod 设置比较方法。请参阅“备注”以了解更多信息。
|
||
--^mount 给定存储库的装入点。
|
||
|
||
== CMD_HELP_SHELVE ==
|
||
|
||
备注:
|
||
|
||
如果既没有指定 <项路径>,也没有指定任何其他选项,则搁置将涉及
|
||
工作区中的所有待定更改。
|
||
|
||
搁置操作始终以递归方式从给定路径应用。
|
||
|
||
搁置项的要求:
|
||
- 项必须受源代码管理。
|
||
- 必须签出或更改项(必须使用 --^all 选项)。
|
||
|
||
比较方法:
|
||
^ignoreeol 忽略行尾差异。
|
||
^ignorewhitespaces 忽略空格差异。
|
||
^ignoreeolwhitespaces 忽略行尾和空格差异。
|
||
^notignore 检测行尾和空格差异。
|
||
|
||
设置 PLASTICEDITOR 环境变量可指定用于键入注释的
|
||
编辑器。
|
||
|
||
示例:
|
||
|
||
cm ^shelve -^c="我的注释"
|
||
(搁置当前工作区中的所有待定更改,包括
|
||
注释。)
|
||
|
||
cm ^shelve file1.txt "file 2.txt" -^commentsfile=commentshelve.txt
|
||
(搁置选定的待定更改并应用 commentshelve.txt
|
||
文件中的注释。)
|
||
|
||
cm ^shelve --^apply=^sh:3
|
||
(应用存储的搁置集。)
|
||
|
||
cm ^shelve --^delete=^sh:3
|
||
(删除存储的搁置集。)
|
||
|
||
cm ^status --^short --^changelist=pending_to_review | cm ^shelve -
|
||
(搁置客户端更改列表。
|
||
以上命令将列出名为 'pending_to_review'
|
||
的更改列表中的路径,并且路径列表将重定向到
|
||
shelve 命令的输入。)
|
||
|
||
== CMD_DESCRIPTION_SHELVESET ==
|
||
允许用户管理搁置集。
|
||
|
||
== CMD_USAGE_SHELVESET ==
|
||
用法:
|
||
|
||
cm ^shelveset <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^apply
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^shelveset <命令> --^usage
|
||
cm ^shelveset <命令> --^help
|
||
|
||
== CMD_HELP_SHELVESET ==
|
||
示例:
|
||
|
||
cm ^shelveset ^create -^c="我的注释"
|
||
cm ^shelveset ^delete ^sh:3
|
||
cm ^shelve ^apply ^sh:3
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_CREATE ==
|
||
搁置待定更改。
|
||
|
||
== CMD_USAGE_SHELVESET_CREATE ==
|
||
用法:
|
||
|
||
cm ^shelveset ^create | ^mk [<项路径>[ ...]] [--^all] [--^dependencies]
|
||
[-^c=<注释字符串> | -^commentsfile=<注释文件>]
|
||
|
||
选项:
|
||
|
||
项路径 要搁置的项。使用空格对各个用户名进行分隔。
|
||
使用双引号 (" ") 指定包含空格的
|
||
路径。
|
||
--^all 还包括在给定路径上进行了本地更改、
|
||
移动和删除的项。
|
||
--^dependencies 在要搁置的项中包含本地更改
|
||
依赖项。
|
||
-^c 将指定的注释应用于创建的搁置。
|
||
-^commentsfile 将指定文件中的注释应用于创建的
|
||
搁置。
|
||
|
||
== CMD_HELP_SHELVESET_CREATE ==
|
||
'^shelveset ^create' 命令可将已签出项的内容存储在
|
||
存储库中。这样,无需签入文件便可以
|
||
保护内容。
|
||
|
||
备注:
|
||
|
||
如果既没有指定 <项路径>,也没有指定任何其他选项,则搁置集将
|
||
包含工作区中的所有待定更改。
|
||
|
||
'^shelveset ^create' 操作始终从给定路径以递归方式
|
||
应用。
|
||
|
||
搁置项的要求:
|
||
- 项必须受源代码管理。
|
||
- 必须签出或更改项(必须使用 '--^all' 选项)。
|
||
|
||
设置 PLASTICEDITOR 环境变量可指定用于键入注释的
|
||
编辑器。
|
||
|
||
示例:
|
||
|
||
cm ^shelveset ^create -^c="我的注释"
|
||
(搁置当前工作区中的所有待定更改,包括
|
||
注释。)
|
||
|
||
cm ^shelveset file1.txt "file 2.txt" -^commentsfile=commentshelve.txt
|
||
(搁置选定的待定更改并应用 'commentshelve.txt'
|
||
文件中的注释。注意,'^create' 是默认的子命令。)
|
||
|
||
cm ^status --^short --^changelist=pending_to_review | cm ^shelveset -
|
||
(搁置客户端更改列表。
|
||
以上命令将列出名为 'pending_to_review'
|
||
的更改列表中的路径,并且路径列表将重定向到
|
||
'^shelveset' 命令的输入。)
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_DELETE ==
|
||
删除搁置集。
|
||
|
||
== CMD_USAGE_SHELVESET_DELETE ==
|
||
用法:
|
||
|
||
cm ^shelveset ^delete | ^rm <搁置规格>
|
||
|
||
搁置规格 搁置集规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解搁置集规格。)
|
||
|
||
== CMD_HELP_SHELVESET_DELETE ==
|
||
'^shelveset ^delete' 命令可删除搁置集。
|
||
|
||
示例:
|
||
|
||
cm ^shelveset ^delete ^sh:3
|
||
(删除存储的搁置集。)
|
||
|
||
== CMD_DESCRIPTION_SHELVESET_APPLY ==
|
||
应用存储的搁置集。
|
||
|
||
== CMD_USAGE_SHELVESET_APPLY ==
|
||
用法:
|
||
|
||
cm ^shelveset ^apply <搁置规格> [--^mount] [--^encoding=<名称>]
|
||
[--^comparisonmethod=(^ignoreeol | ^ignorewhitespaces| \
|
||
^ignoreeolwhitespaces | ^notignore)]
|
||
|
||
搁置规格 搁置集规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解搁置集规格。)
|
||
|
||
选项:
|
||
|
||
--^mount 给定存储库的装入点。
|
||
--^encoding 指定输出编码,如:utf-8。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^comparisonmethod 设置比较方法。请参阅“备注”以了解更多信息。
|
||
|
||
== CMD_HELP_SHELVESET_APPLY ==
|
||
'^shelveset ^apply' 命令可还原存储的搁置集的内容。
|
||
|
||
备注:
|
||
|
||
比较方法:
|
||
^ignoreeol 忽略行尾差异。
|
||
^ignorewhitespaces 忽略空格差异。
|
||
^ignoreeolwhitespaces 忽略行尾和空格差异。
|
||
^notignore 检测行尾和空格差异。
|
||
|
||
示例:
|
||
|
||
cm ^shelveset ^apply ^sh:3
|
||
(应用存储的搁置。)
|
||
|
||
== CMD_DESCRIPTION_SHOW_FIND_OBJECTS ==
|
||
列出对象和属性。
|
||
|
||
== CMD_USAGE_SHOW_FIND_OBJECTS ==
|
||
用法:
|
||
|
||
cm ^showfindobjects
|
||
|
||
== CMD_HELP_SHOW_FIND_OBJECTS ==
|
||
可用对象和属性:
|
||
|
||
^attribute:
|
||
可以通过使用以下字段进行筛选来查找属性:
|
||
|
||
^type :字符串。
|
||
|
||
示例:
|
||
cm ^find ^attribute "^where ^type = '状态'"
|
||
(查找 '状态' 类型的所有属性。)
|
||
|
||
^value :字符串。
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
|
||
示例:
|
||
cm ^find ^attribute "^where ^date > '^this ^week'"
|
||
(查找本周内应用的所有属性。)
|
||
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
|
||
示例:
|
||
cm ^find ^attribute "^where ^value = '已解决' ^and ^owner = '^me'"
|
||
(查找具有 '已解决' 值并由我应用的所有属性。)
|
||
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
^comment :字符串。
|
||
^srcobj :对象规格:项路径、分支、变更集、修订或标签。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定这些对象。
|
||
|
||
示例:
|
||
cm ^find ^attribute "^where ^srcobj = '^item:readme.txt'"
|
||
(查找应用于项 'readme.txt' 的属性。)
|
||
|
||
cm ^find ^attribute "^where ^srcobj = '^br:/main/scm23343'"
|
||
(查找应用于分支 scm23343 的属性。)
|
||
|
||
cm ^find ^attribute "^where ^srcobj = '^rev:readme.txt#^br:/main/task002'"
|
||
(查找应用于指定修订的属性。)
|
||
|
||
cm ^find ^attribute "^where ^srcobj = '^rev:^revid:1126'"
|
||
(查找应用于指定修订 ID 的属性。)
|
||
|
||
^ID :整数。
|
||
|
||
^attributetype:
|
||
可以通过使用以下字段进行筛选来查找属性类型:
|
||
|
||
^name :字符串。
|
||
|
||
示例:
|
||
cm ^find ^attributetype "^where ^name ^like 'st%'"
|
||
(查找名称以 'st' 开头的所有属性。)
|
||
|
||
^value :字符串。
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
|
||
示例:
|
||
cm ^find ^attribute "^where ^date > '^today'"
|
||
(查找今天应用的所有属性。)
|
||
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
^comment :字符串。
|
||
|
||
示例:
|
||
cm ^find ^attributetype "^where ^comment != ''" --^xml
|
||
(查找具有某个注释的所有属性类型,并且以 XML 格式
|
||
将输出打印到标准输出。)
|
||
|
||
^source :对象规格:项路径、分支、变更集或标签。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定这些对象。
|
||
|
||
示例:
|
||
|
||
cm ^find ^attributetype "^where ^source = '^item:readme.txt'"
|
||
(查找项 'readme.txt' 中的所有属性类型。)
|
||
|
||
cm ^find ^attributetype "^where ^source = '^cs:30'"
|
||
(查找变更集 '30' 中的所有属性类型。)
|
||
|
||
cm ^find ^attributetype "^where ^source = '^lb:v0.14.1'"
|
||
(查找标签 'v0.14.1' 中的所有属性类型。)
|
||
|
||
^ID :整数。
|
||
|
||
复制字段。查看下文的“与复制相关的字段”。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^branch:
|
||
可以通过使用以下字段进行筛选来查找分支:
|
||
|
||
^name :字符串。
|
||
|
||
示例:
|
||
cm ^find ^branch "^where ^name ^like 'scm23%'"
|
||
(查找名称以 'scm23' 开头的分支。)
|
||
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
|
||
示例:
|
||
cm ^find ^branch "^where ^date > '^one ^week ^ago'"
|
||
(查找上周创建的分支。)
|
||
|
||
^changesets :日期(分支中变更集的日期)。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
|
||
示例:
|
||
cm ^find ^branch "^where ^changesets >= '^today'"
|
||
(查找包含今天创建的变更集的分支。)
|
||
|
||
^attribute :字符串。
|
||
^attrvalue :字符串。
|
||
|
||
示例:
|
||
cm ^find ^branch "^where ^attribute = '状态' ^and ^attrvalue = '已失败'"
|
||
(查找具有属性 '状态' 且属性值为 '已失败'
|
||
的分支。)
|
||
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
^parent :分支规格。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定此对象。
|
||
|
||
示例:
|
||
cm ^find ^branch "^where ^owner != '^me' ^and ^parent != '^br:/main'"
|
||
(查找由我以外的人创建且父分支
|
||
不是 '/main' 的分支。)
|
||
|
||
^comment :字符串。
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
|
||
^ID :整数。
|
||
|
||
示例:
|
||
cm ^find ^branch "^where ^id = 2029607"
|
||
(查找 ID 为 2029607 的分支。)
|
||
|
||
复制字段。查看下文的“与复制相关的字段”。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^changeset:
|
||
可以通过使用以下字段进行筛选来查找变更集:
|
||
|
||
^branch :分支规格。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定此
|
||
对象。
|
||
|
||
示例:
|
||
cm ^find ^changeset "^where ^branch = '/main/scm23119'"
|
||
(查找分支 'scm23119' 中的所有变更集。)
|
||
|
||
^changesetid :整数。
|
||
^attribute :字符串。
|
||
|
||
示例:
|
||
cm ^find ^changeset "^where ^attribute = '状态'"
|
||
(查找包含属性 '状态' 的变更集。)
|
||
|
||
^attrvalue :字符串。
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
|
||
示例:
|
||
cm ^find ^changeset "^where ^date >= '2018/8/6' ^and ^owner != '^me'"
|
||
(查找创建日期等于或晚于 2018/8/6
|
||
并且由我以外的人创建的所有变更集。)
|
||
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
|
||
示例:
|
||
cm ^find ^changeset "^where ^guid = '1b30674f-14cc-4fd7-962b-676c8a6f5cb6'"
|
||
(查找具有指定 GUID 的变更集。)
|
||
|
||
^comment :字符串。
|
||
|
||
示例:
|
||
cm ^find ^changeset "^where ^comment = ''"
|
||
(查找不含注释的变更集。)
|
||
|
||
^onlywithrevisions :布尔值。
|
||
筛选变更集是否具有修订。
|
||
|
||
示例:
|
||
cm ^find ^changeset "^where ^onlywithrevisions = 'false'"
|
||
(查找不含修订的变更集。)
|
||
|
||
^returnparent :布尔值。
|
||
一种返回变更集父级的方法。非常适合用于编写脚本。
|
||
|
||
示例:
|
||
cm ^find ^changeset "^where ^changesetid = 29 ^and ^returnparent = 'true'"
|
||
(查找变更集 29 的父级。)
|
||
|
||
^parent :变更集 ID(整数)。
|
||
|
||
示例:
|
||
cm ^find ^changeset "^where ^parent = 548"
|
||
(查找父级为变更集 548 的所有变更集。)
|
||
|
||
^ID :整数。
|
||
|
||
复制字段。查看下文的“与复制相关的字段”。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^label:
|
||
可以通过使用以下字段进行筛选来查找标签:
|
||
|
||
^name :字符串。
|
||
|
||
示例:
|
||
cm ^find ^label "^where ^name ^like '7.0.16.%'"
|
||
(查找名称以 '7.0.16.' 开头的标签。)
|
||
|
||
^attribute :字符串。
|
||
^attrvalue :字符串。
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
|
||
示例:
|
||
cm ^find ^label "^where ^date >= '^this ^month' ^and \
|
||
^attribute = '发布状态' ^and ^attrvalue != '已发布'"
|
||
(查找本月创建并且属性 '发布状态' 设置为
|
||
'已发布' 以外的值的标签。)
|
||
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
^branch :分支规格。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定此对象。
|
||
|
||
示例:
|
||
cm ^find ^label "^where ^branch = '/main'"
|
||
(查找应用于主分支的所有标签。)
|
||
|
||
^branchid :整数。
|
||
^changeset :变更集 ID(整数)。
|
||
|
||
示例:
|
||
cm ^find ^label "^where ^changeset = 111733"
|
||
(查找应用于变更集 111733 的标签。)
|
||
|
||
^comment :字符串。
|
||
^ID :整数。
|
||
|
||
复制字段。查看下文的“与复制相关的字段”。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^merge:
|
||
可以通过使用以下字段进行筛选来查找合并:
|
||
|
||
^srcbranch :分支规格。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定此对象。
|
||
|
||
示例:
|
||
cm ^find ^merge "^where ^srcbranch = '^br:/main'"
|
||
(从主分支中查找合并。)
|
||
|
||
^srcchangeset :变更集 ID(整数)。
|
||
^dstbranch :分支规格。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定此对象。
|
||
^dstchangeset :变更集 ID(整数)。
|
||
|
||
示例:
|
||
cm ^find ^merge "^where ^dstchangeset = 108261" \
|
||
--^format="{^srcbranch} {^srcchangeset} {^dstbranch} {^dstchangeset} {^owner}"
|
||
(查找与变更集 108261 的合并,并打印
|
||
格式化的输出,从而显示源(分支和变更集 ID)、
|
||
目标(分支和变更集 ID)和合并所有者。)
|
||
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
^type :字符串。
|
||
可能的值有 '^merge'、'^cherrypick'、
|
||
'^cherrypicksubstractive'、'^interval'、'^intervalcherrypick'
|
||
和 '^intervalcherrypicksubstractive'
|
||
|
||
示例:
|
||
cm ^find ^merge "^where ^type = '^cherrypick' ^and ^owner = '^me'"
|
||
(查找我所有的挑拣。)
|
||
|
||
^ID :整数。
|
||
|
||
^replicationlog:
|
||
可以通过使用以下字段进行筛选来查找复制日志:
|
||
|
||
^branch :分支规格。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定此对象。
|
||
|
||
示例:
|
||
cm ^find ^replicationlog "^where ^branch = '/main/gm22358'"
|
||
(查找分支 'gm22358' 的复制日志。)
|
||
|
||
^repositoryname :字符串。
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
^server :字符串。
|
||
^package :布尔值。
|
||
|
||
示例:
|
||
cm ^find ^replicationlog "^where ^package = 'T' ^and ^server ^like '%cloud%'"
|
||
(查找从服务器名称中包含 'cloud' 的包
|
||
创建的复制日志。)
|
||
|
||
^ID :整数。
|
||
|
||
^review:
|
||
可以通过使用以下字段进行筛选来查找代码审查:
|
||
|
||
^status :字符串。
|
||
^assignee :字符串。
|
||
|
||
示例:
|
||
cm ^find ^review "^where ^status = '待定' ^and ^assignee = '^me'"
|
||
(查找我所有的待定审查。)
|
||
|
||
^title :字符串。
|
||
^target :对象规格:分支或变更集。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定此对象。
|
||
|
||
示例:
|
||
cm ^find ^review "^where ^target = '^br:/main/scm17932'"
|
||
(查找与分支 'scm17932' 相关的审查。)
|
||
|
||
^targetid :整数。
|
||
^targettype :字符串。
|
||
可能的值有 '^branch' 和 '^changeset'。
|
||
|
||
示例:
|
||
cm ^find ^review "^where ^targettype = '^changeset'"
|
||
(查找目标类型为变更集的审查。)
|
||
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
^ID :整数。
|
||
|
||
^revision:
|
||
可以通过使用以下字段进行筛选来查找修订:
|
||
|
||
^branch :分支规格。
|
||
使用 'cm ^help ^objectspec' 可了解如何指定此对象。
|
||
^changeset :变更集 ID(整数)。
|
||
|
||
示例:
|
||
cm ^find ^revision "^where ^changeset >= 111756"
|
||
(查找在变更集 111756 以及更高版本中
|
||
创建的修订。)
|
||
|
||
^item :字符串或整数。
|
||
^itemid :整数。
|
||
|
||
示例:
|
||
cm ^find ^revision "^where ^item = 'readme.txt' ^or ^itemid = 2250"
|
||
(查找项 'readme.txt' 和项 ID 2250
|
||
的修订。)
|
||
|
||
cm ^find ^revision "^where ^item = 'readme.txt' ^or ^item = 2250"
|
||
(获取与先前示例相同的修订。)
|
||
|
||
^attribute :字符串。
|
||
^attrvalue :字符串。
|
||
|
||
示例:
|
||
cm ^find ^revision "^where ^attribute = '状态' ^and ^attrvalue != '未完成'"
|
||
(查找包含属性 '状态' 且属性值
|
||
不是 '未完成' 的修订。)
|
||
|
||
^archived :布尔值。
|
||
|
||
示例:
|
||
cm ^find ^revision "^where ^archived = 'true'"
|
||
(查找在外部存储中存档
|
||
的修订。)
|
||
|
||
^comment :字符串。
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
^parent :修订 ID(整数)。
|
||
^returnparent :布尔值。
|
||
^shelve :搁置 ID(整数)。
|
||
^size :整数(以字节为单位)。
|
||
^type :字符串。
|
||
可能的值有 '^dir'、'^bin' 和 '^txt'。
|
||
|
||
示例:
|
||
cm ^find ^revision "^where ^type = '^txt' and \
|
||
^size > 300000 ^and ^owner = '^me' and ^date >= '2 ^months ^ago'"
|
||
(查找我两个月前创建且大小
|
||
大于 3MB 的文本修订。)
|
||
|
||
^workspacecheckoutid :整数。
|
||
^ID :整数。
|
||
|
||
复制字段。查看下文的“与复制相关的字段”。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
^shelve:
|
||
可以通过使用以下字段进行筛选来查找搁置:
|
||
|
||
^owner :用户。
|
||
容许特殊用户 '^me'。
|
||
^date :日期。
|
||
请在本指南中查看“日期常量”以了解更多信息。
|
||
|
||
示例:
|
||
cm ^find ^shelve "^where ^owner != '^me' ^and ^date >= '^1 ^years ^ago'"
|
||
(查找去年我以外的人创建的
|
||
搁置。)
|
||
|
||
^attribute :字符串。
|
||
^attrvalue :字符串。
|
||
^comment :字符串。
|
||
^GUID :全局唯一标识符。
|
||
十六进制 ID,格式为 xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx。
|
||
^parent :整数。
|
||
^shelveid :整数。
|
||
|
||
示例:
|
||
cm ^find ^shelve "^where ^shelveid = 2"
|
||
(查找名称为 2 的搁置。)
|
||
|
||
^ID :整数。
|
||
|
||
示例:
|
||
cm ^find ^shelve "^where ^id >= 3848"
|
||
(查找对象 ID 大于 3848 的搁置。)
|
||
|
||
复制字段。查看下文的“与复制相关的字段”。
|
||
^ReplLogId
|
||
^ReplSrcDate
|
||
^ReplSrcId
|
||
^ReplSrcRepository
|
||
^ReplSrcServer
|
||
|
||
|
||
与复制相关的字段:
|
||
许多对象会跟踪复制数据,这意味着 Unity VCS 会跟踪最初创建复制
|
||
的位置。
|
||
|
||
可以使用的字段包括:
|
||
|
||
^ReplSrcServer :存储库规格。表示“复制源服务器”。
|
||
从中复制对象的服务器。
|
||
|
||
示例:
|
||
cm ^find ^branch "^where ^replsrcserver='skull.codicefactory.com:9095'"
|
||
(查找从服务器 'skull' 复制的分支。)
|
||
|
||
^ReplSrcRepository :字符串。表示“复制源存储库”。这是
|
||
从中复制对象的存储库。
|
||
|
||
示例:
|
||
cm ^find ^branch "^where ^replsrcserver = 'skull.codicefactory.com:9095' \
|
||
^and ^replsrcrepository = 'codice'"
|
||
(查找从服务器 'skull' 和存储库 'codice'
|
||
复制的分支。)
|
||
|
||
^ReplLogId :整数。复制操作的 ID。在 Unity VCS 中,
|
||
每次从复本创建新对象时,
|
||
都会创建一个新的 'replicationlog'。
|
||
|
||
示例:
|
||
cm ^find ^revision "^where ^repllogid = 2019974"
|
||
(查找从复本 2019974 复制
|
||
的修订。)
|
||
|
||
^ReplSrcDate :日期。这是实际发生复制的
|
||
日期。
|
||
复制的对象将保留其原始创建
|
||
日期,如果要查找在特定时间
|
||
范围内复制的对象,则此字段
|
||
很有用。
|
||
|
||
示例:
|
||
cm ^find ^label "^where ^replsrcdate >= '^one ^month ^ago' \
|
||
^and ^date >= '15 ^days ^ago'"
|
||
(查找 15 天前创建并在一个月前
|
||
复制的标签。)
|
||
|
||
cm ^find ^replicationlog "^where ^date > '^one ^week ^ago'"
|
||
8780433 27/09/2018 8:49:38 codice@BACKYARD:8087 F mbarriosc
|
||
(查找一周前创建的复制日志。)
|
||
|
||
现在可以检查复制的分支是否是
|
||
在复制之前创建的:
|
||
|
||
cm ^find ^branch "^where ^repllogid = 8780433"
|
||
8780443 26/09/2018 12:20:55 /main/scm23078 maria codice T
|
||
|
||
^ReplSrcId :整数。这是复制源服务器的 ID。
|
||
可以使用 'cm ^find' 命令搜索
|
||
'^replicationsource' 对象来发现此 ID。
|
||
|
||
示例:
|
||
cm ^find ^replicationsource
|
||
7860739 codice@AFRODITA:8087 d9c4372a-dc55-4fdc-ad3d-baeb2e975f27
|
||
8175854 codice@BACKYARD:8087 66700d3a-036b-4b9a-a26f-adfc336b14f9
|
||
|
||
现在可以查找从 codice@AFRODITA:8087
|
||
复制的变更集:
|
||
|
||
cm ^find ^changesets "^where ^replsrcid = 7860739"
|
||
|
||
|
||
日期常量:
|
||
可以使用遵循计算机本地化设置的日期格式。
|
||
例如,如果计算机以 'MM-dd-yyyy' 格式显示日期,
|
||
则可以在查询中使用 '12-31-2019' 之类的日期。
|
||
|
||
还可以使用以下常量来简化查询:
|
||
'^today' :今天的日期。
|
||
'^yesterday' :昨天的日期。
|
||
'^this ^week' :本周星期一的日期。
|
||
'^this ^month' :本月第一天的日期。
|
||
'^this ^year' :本年 1 月 1 日。
|
||
'^one ^day ^ago' :当前日期前一天。
|
||
'^one ^week ^ago' :当前日期前七天。
|
||
'^one ^month ^ago' :当前日期前一个月。
|
||
'n ^days ^ago' :当前日期前 'n' 天。
|
||
'n ^months ^ago' :当前日期前 'n' 个月。
|
||
'n ^years ^ago' :当前日期前 'n' 年。
|
||
|
||
以下 '^where' 子句对于类型为 '^date' 的字段有效:
|
||
'(...)^where ^date > '^today' (...)'
|
||
'(...)^where ^date < '^yesterday' (...)'
|
||
'(...)^where ^date > '^this ^week' (...)'
|
||
'(...)^where ^date > '^this ^month' (...)'
|
||
'(...)^where ^date < '^one ^day ^ago' ^and ^date > '3 ^days ^ago' (...)'
|
||
'(...)^where ^date < '^one ^week ^ago' ^and ^date > '3 ^weeks ^ago' (...)'
|
||
'(...)^where ^date < '^one ^month ^ago' ^and ^date > '3 ^months ^ago' (...)'
|
||
'(...)^where ^date > '1 ^year ^ago' (...)'
|
||
|
||
还可以在 'cm ^find' 命令中强制使用特定日期格式,方法是使用
|
||
--^dateformat 标志。请查看 'cm ^find --^help' 以了解更多详细信息。
|
||
|
||
== CMD_DESCRIPTION_TRIGGER_SHOWTYPES ==
|
||
显示可用的触发器类型。
|
||
|
||
== CMD_USAGE_TRIGGER_SHOWTYPES ==
|
||
用法:
|
||
|
||
cm ^trigger ^showtypes
|
||
|
||
== CMD_DESCRIPTION_SHOWACL ==
|
||
显示对象的 ACL。
|
||
|
||
== CMD_USAGE_SHOWACL ==
|
||
用法:
|
||
|
||
cm ^showacl | ^sa <对象规格> [--^extended] [--^xml[=<输出文件>]]
|
||
[--^encoding=<名称>]
|
||
|
||
对象规格 要显示相应 ACL 的对象的规格。
|
||
此命令的有效对象为:
|
||
存储库服务器、存储库、分支、变更集、标签、项
|
||
和属性。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
选项:
|
||
|
||
--^extended 显示 ACL 层次结构树。
|
||
--^xml 以 XML 格式将输出打印到标准输出。
|
||
可以指定输出文件。
|
||
--^encoding 与 '--^xml' 选项结合使用,指定要在 XML 输出
|
||
中使用的编码(例如:utf-8)。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
|
||
== CMD_HELP_SHOWACL ==
|
||
示例:
|
||
|
||
cm ^showacl ^repserver:PlasticServer:8084
|
||
(显示所选服务器的 ACL。)
|
||
|
||
cm ^sa ^br:/main --^extended
|
||
(显示所选分支规格的 ACL 层次结构树。)
|
||
|
||
== CMD_DESCRIPTION_SHOWCOMMANDS ==
|
||
显示所有可用命令。
|
||
|
||
== CMD_USAGE_SHOWCOMMANDS ==
|
||
用法:
|
||
|
||
cm ^showcommands
|
||
|
||
== CMD_HELP_SHOWCOMMANDS ==
|
||
|
||
== CMD_DESCRIPTION_SHOWOWNER ==
|
||
显示对象的所有者。
|
||
|
||
== CMD_USAGE_SHOWOWNER ==
|
||
用法:
|
||
|
||
cm ^showowner | ^so <对象规格>
|
||
|
||
对象规格 要显示相应所有者的对象的规格。
|
||
对象必须为下列其中之一:
|
||
存储库服务器、存储库、分支、变更集、
|
||
标签、属性、修订和项。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
== CMD_HELP_SHOWOWNER ==
|
||
备注:
|
||
|
||
此命令将显示对象的所有者。所有者可以是用户或
|
||
组。可以使用 'cm ^setowner' 命令修改所有者。
|
||
|
||
示例:
|
||
|
||
cm ^showowner ^repserver:PlasticServer:8084
|
||
(显示所选服务器的所有者。)
|
||
|
||
cm ^so ^item:samples\
|
||
(显示所选项规格的所有者。)
|
||
|
||
== CMD_DESCRIPTION_SHOWPERMISSIONS ==
|
||
列出可用的权限。
|
||
|
||
== CMD_USAGE_SHOWPERMISSIONS ==
|
||
用法:
|
||
|
||
cm ^showpermissions | ^sp
|
||
|
||
== CMD_HELP_SHOWPERMISSIONS ==
|
||
示例:
|
||
|
||
cm ^showpermissions
|
||
|
||
== CMD_DESCRIPTION_SHOWSELECTOR ==
|
||
显示工作区选择器。
|
||
|
||
== CMD_USAGE_SHOWSELECTOR ==
|
||
已弃用此命令。为了向后兼容,此命令仍然存在,
|
||
但是在 Plastic SCM 4.0 中,已在很大程度上弃用选择器。仍然存在的选择器
|
||
是为了指定工作分支或变更集,但不再支持
|
||
用于筛选路径的旧规则。
|
||
|
||
用法:
|
||
|
||
cm ^showselector | ^ss [<工作区路径> | <工作区规格>]
|
||
|
||
工作区路径 用于显示选择器的工作区的路径。
|
||
工作区规格 工作区的规格。(使用 'cm ^help ^objectspec' 可
|
||
可进一步了解工作区规格。)
|
||
|
||
== CMD_HELP_SHOWSELECTOR ==
|
||
备注:
|
||
|
||
如果路径和工作区规格均未指定,则该命令将采用
|
||
当前目录作为工作区路径。
|
||
|
||
示例:
|
||
|
||
cm ^showselector c:\workspace
|
||
(显示所选工作区路径的选择器。)
|
||
|
||
cm ^ss
|
||
(显示当前工作区的选择器。)
|
||
|
||
cm ^showselector > mySelector.txt
|
||
(将当前工作区的选择器写入文件。)
|
||
|
||
cm ^showselector ^wk:mywk@reptest
|
||
(显示存储库 'reptest' 中的工作区 'mywk' 的选择器。)
|
||
|
||
== CMD_DESCRIPTION_SUPPORT ==
|
||
允许用户执行与支持相关的操作。
|
||
|
||
== CMD_USAGE_SUPPORT ==
|
||
用法:
|
||
|
||
cm ^support <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^bundle
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^support <命令> --^usage
|
||
cm ^support <命令> --^help
|
||
|
||
== CMD_HELP_SUPPORT ==
|
||
示例:
|
||
|
||
cm ^support
|
||
cm ^support ^bundle
|
||
cm ^support ^bundle c:\outputfile.zip
|
||
|
||
== CMD_DESCRIPTION_SUPPORT_BUNDLE ==
|
||
创建带有相关日志的“支持捆绑包”包。
|
||
可以在请求帮助、询问其他信息或者提交 bug 时
|
||
附加该文件。
|
||
|
||
== CMD_USAGE_SUPPORT_BUNDLE ==
|
||
用法:
|
||
|
||
cm ^support ^bundle [<输出文件>]
|
||
|
||
选项:
|
||
|
||
输出文件 在指定的位置创建“支持捆绑包”
|
||
包。
|
||
|
||
== CMD_HELP_SUPPORT_BUNDLE ==
|
||
备注:
|
||
|
||
此命令允许用户创建一个“支持捆绑包”包,然后便可在请求帮助、
|
||
询问其他信息或提交 bug 时附加这个包。
|
||
用户可以选择指定输出文件的位置;否则,
|
||
输出文件将写入到临时目录。
|
||
|
||
示例:
|
||
|
||
cm ^support ^bundle
|
||
(在临时目录中创建“支持捆绑包”。)
|
||
|
||
cm ^support ^bundle c:\outputfile.zip
|
||
(在指定位置创建“支持捆绑包”。)
|
||
|
||
== CMD_DESCRIPTION_SWITCH ==
|
||
将工作区切换到分支、变更集、标签或搁置集。
|
||
|
||
== CMD_USAGE_SWITCH ==
|
||
用法:
|
||
|
||
cm ^switch (<分支规格> | <变更集规格> | <标签规格> | <搁置规格>)
|
||
[--^workspace=<路径>] [--^repository=<名称>]
|
||
[--^forcedetailedprogress]
|
||
|
||
(使用 'cm ^help ^objectspec' 可进一步了解分支、变更集、标签、
|
||
和搁置集规格。)
|
||
|
||
选项:
|
||
|
||
--^workspace 工作区所在的路径。
|
||
--^repository 切换到指定的存储库。
|
||
--^forcedetailedprogress 即使在标准输出被重定向的情况下也要强制
|
||
显示详细进度。
|
||
|
||
== CMD_HELP_SWITCH ==
|
||
备注:
|
||
|
||
此命令允许用户将工作区树更新为指定对象
|
||
(分支、标签、搁置集或变更集)的内容。
|
||
|
||
示例:
|
||
|
||
cm ^switch ^br:/main
|
||
cm ^switch ^lb:Rel1.1
|
||
cm ^switch ^br:/main/scm002 --^repository=rep2
|
||
cm ^switch ^cs:4375
|
||
cm ^switch ^sh:2
|
||
|
||
== CMD_DESCRIPTION_SWITCH_TO_BRANCH ==
|
||
将分支设置为工作分支。
|
||
|
||
== CMD_USAGE_SWITCH_TO_BRANCH ==
|
||
已弃用此命令。请改用 cm switch。
|
||
|
||
用法:
|
||
|
||
cm ^switchtobranch [选项] [分支规格]
|
||
|
||
分支规格:分支的规格。
|
||
|
||
选项:
|
||
|
||
--^label=名称 | --^changeset=数字:从指定标签或变更集
|
||
加载修订。如果未提供任何分支规格,则需要这些选项
|
||
之一。
|
||
--^changeset=变更集:切换到指定的变更集。
|
||
--^repository=存储库:切换到指定的存储库。
|
||
--^workspace | -wk=路径:工作区所在的路径。
|
||
|
||
== CMD_HELP_SWITCH_TO_BRANCH ==
|
||
备注:
|
||
|
||
此命令允许用户在分支中工作。
|
||
如果未指定分支规格,则必须指定标签或变更集。
|
||
如果未指定存储库,则分支将设置为当前存储库。
|
||
|
||
示例:
|
||
|
||
cm ^switchtobranch ^br:/main
|
||
cm ^switchtobranch ^br:/main/task001
|
||
|
||
cm ^switchtobranch --^label=BL050
|
||
(只读配置。该命令将加载已标记的变更集
|
||
的内容。)
|
||
|
||
== CMD_DESCRIPTION_SYNC ==
|
||
与 Git 同步。
|
||
|
||
== CMD_USAGE_SYNC ==
|
||
用法:
|
||
|
||
cm ^synchronize | ^sync <存储库规格> ^git [<url> [--^user=<用户名> --^pwd=<密码>]]
|
||
[(--^txtsimilaritypercent | --^binsimilaritypercent | \
|
||
--^dirsimilaritypercent)=<值>]
|
||
[--^author] [--^skipgitlfs]
|
||
|
||
|
||
存储库规格 存储库的规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解存储库规格。)
|
||
git (默认值)。
|
||
|
||
选项:
|
||
|
||
url 远程存储库 URL(http(s):// 或 git:// 或
|
||
SSH URL)。
|
||
--^user 指定的 URL 的用户名。
|
||
--^pwd 指定的 URL 的密码。
|
||
--^txtsimilaritypercent \
|
||
--^binsimilaritypercent \
|
||
--^dirsimilaritypercent
|
||
要检测已移动的项,与 Unity VCS GUI 的
|
||
方法相同。
|
||
--^author 使用 Git 作者提供的名称和时间戳值。
|
||
(默认为 Git 提交者)
|
||
--^skipgitlfs 忽略 .gitattributes 文件中的
|
||
Git LFS 配置。行为类似于不支持
|
||
Git LFS。
|
||
|
||
== CMD_HELP_SYNC ==
|
||
备注:
|
||
|
||
如果 Git 存储库需要用户名和密码,则应使用 '^url'、'--^user'、
|
||
和 '--^pwd' 选项。
|
||
如果 Git 存储库不需要用户名和密码,则应在第一次同步
|
||
操作中使用 '^url' 选项。在后续的同步操作中,'^url'
|
||
选项是可选的。
|
||
|
||
要使用 SSH 协议执行同步,必须将 'ssh' 客户端
|
||
添加到 PATH 环境变量,并正确配置为连接到
|
||
远程主机(即配置私钥/公钥)。
|
||
|
||
示例:
|
||
|
||
cm ^sync default@localhost:8087 ^git git://localhost/repository
|
||
|
||
== CMD_DESCRIPTION_TRIGGER ==
|
||
允许用户管理触发器。
|
||
|
||
== CMD_USAGE_TRIGGER ==
|
||
用法:
|
||
|
||
cm ^trigger | ^tr <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^edit
|
||
^list | ^ls
|
||
^showtypes
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^trigger <命令> --^usage
|
||
cm ^trigger <命令> --^help
|
||
|
||
== CMD_HELP_TRIGGER ==
|
||
示例:
|
||
|
||
cm ^tr ^mk ^before-mklabel new "/path/to/script" --^server=myserver:8084
|
||
cm ^tr ^edit ^before-mklabel 7 --^position=4 --^server=myserver:8084
|
||
cm ^tr ^ls ^before-mkbranch --^server=myserver:8084
|
||
cm ^tr ^rm ^after-setselector 4
|
||
cm ^tr ^showtypes
|
||
|
||
== CMD_DESCRIPTION_TUBE ==
|
||
运行与 Plastic Tube 有关的命令。
|
||
|
||
== CMD_USAGE_TUBE ==
|
||
用法:
|
||
|
||
cm ^tube ^config -^u=<用户> -^p=<密码>
|
||
(配置 Unity VCS 以将 Plastic Tube 与指定的用户和密码
|
||
配合使用。)
|
||
|
||
|
||
cm ^tube ^create <远程用户>
|
||
(创建 Tube“远程用户 -> 我的用户”。
|
||
用户“我的用户”允许“远程用户”连接到“我的用户”服务器。
|
||
可以建立从“远程用户”到“我的用户”的连接。
|
||
只能创建其他用户到当前 Tube 用户的 Tube。)
|
||
|
||
cm ^tube ^remove <远程用户>
|
||
(删除 Tube“远程用户 -> 我的用户”。)
|
||
|
||
|
||
cm ^tube ^local
|
||
(列出在本地服务器上共享的本地存储库以及共享到
|
||
的用户。)
|
||
|
||
cm ^tube ^remote
|
||
(列出与当前 Tube 用户共享的共享远程
|
||
存储库。)
|
||
|
||
|
||
cm ^tube ^share <存储库规格>[ ...]-^u=<远程用户> -^a=(^pull | ^push | ^pull,^push)
|
||
(与远程用户共享本地存储库并设置指定的
|
||
访问模式。使用空格对各个存储库规格进行分隔。)
|
||
|
||
cm ^tube ^unshare <存储库规格>[ ...]-^u=<远程用户>
|
||
(取消与远程用户共享本地存储库。使用空格
|
||
对各个存储库规格进行分隔。)
|
||
|
||
|
||
cm ^tube ^connect
|
||
(将 Unity VCS 服务器连接到 Plastic Tube。)
|
||
cm ^tube ^disconnect
|
||
(断开 Unity VCS 服务器与 Plastic Tube 的连接。)
|
||
cm ^tube ^status
|
||
(显示 Unity VCS 服务器是否已连接到 Plastic Tube。)
|
||
|
||
选项
|
||
|
||
-^u Tube 用户(plasticscm.com 用户)。
|
||
-^p 用户密码。
|
||
-^a 设置访问模式。
|
||
存储库规格 存储库的规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解存储库规格。)
|
||
|
||
== CMD_HELP_TUBE ==
|
||
备注:
|
||
|
||
使用 'cm ^tube' 命令来管理 Plastic Tube。
|
||
|
||
示例:
|
||
|
||
cm ^tube ^config -^u=ruben@codicesoftware.com -^p=rubenpassword
|
||
|
||
cm ^tube ^create pablo@codicesoftware.com
|
||
('pablo@codicesoftware.com' 可以连接到当前的 Plastic Tube 用户)
|
||
cm ^tube ^remove pablo@codicesoftware.com
|
||
|
||
cm ^tube ^local
|
||
cm ^tube ^remote
|
||
|
||
cm ^tube ^share repo@server:8087 -^u=pablo@codicesoftware.com -^a=^pull,^push
|
||
cm ^tube ^share repo@server:8087 doc@server:8087 -^u=pablo@codicesoftware.com -^a=^push
|
||
cm ^tube ^unshare repo@server:8087 -^u=pablo@codicesoftware.com
|
||
|
||
cm ^tube ^connect
|
||
cm ^tube ^disconnect
|
||
cm ^tube ^status
|
||
|
||
== CMD_DESCRIPTION_UNDOCHECKOUT ==
|
||
撤销项的签出。
|
||
|
||
== CMD_USAGE_UNDOCHECKOUT ==
|
||
用法:
|
||
|
||
cm ^undocheckout | ^unco <项路径>[ ...][-^a | --^all] [--^symlink] [--^silent]
|
||
[--^machinereadable [--^startlineseparator=<分隔符>]
|
||
[--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
|
||
|
||
项路径 要应用操作的项。使用空格对各个路径进行
|
||
分隔。使用双引号 (" ") 指定包含空格
|
||
的路径。
|
||
使用 . 将操作应用到当前目录。
|
||
|
||
选项:
|
||
|
||
-^a | --^all 撤销指定项中的所有更改。如果
|
||
已签出项,则签出将被
|
||
还原。如果项是在本地修改的,则
|
||
修改将被还原。
|
||
--^symlink 将 undocheckout 操作应用于链接而不是
|
||
目标。
|
||
--^silent 不显示任何输出。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定行应如何开头。
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定行应如何结尾。
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定应如何分隔字段。
|
||
|
||
== CMD_HELP_UNDOCHECKOUT ==
|
||
备注:
|
||
|
||
如果已签出某个项并且不想将这个项签入,则可以
|
||
使用此命令撤销签出。文件和文件夹都可以取消
|
||
签出。项将更新为签出之前的状态。
|
||
|
||
要求:
|
||
- 项必须受源代码管理。
|
||
- 必须签出项。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^undocheckout' 命令可从 stdin 读取路径。为此,请传递
|
||
一个破折号 "-"。
|
||
示例:cm ^undocheckout ^checkin -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要撤销签出的文件。
|
||
示例:
|
||
dir /S /B *.c | cm ^undocheckout --^all -
|
||
(在 Windows 中,撤销对工作区中所有 .c 文件的签出。)
|
||
|
||
示例:
|
||
|
||
cm ^undocheckout .
|
||
(撤销当前目录中的签出。)
|
||
|
||
cm ^undocheckout file1.txt file2.txt
|
||
cm unco c:\workspace\file.txt
|
||
(撤销签出所选文件。)
|
||
|
||
cm ^unco -^a file1.txt
|
||
(撤销对 'file1.txt' 的签出或本地修改)
|
||
|
||
cm ^unco 链接 --^symlink
|
||
(将 undocheckout 操作应用于链接文件而不是目标,
|
||
适用于 UNIX 环境。)
|
||
|
||
cm ^status --^short --^changelist=pending_to_review | cm ^undocheckout -
|
||
(撤销客户端更改列表。
|
||
以上命令将列出名为 'pending_to_review'
|
||
的更改列表中的路径,并且路径列表将重定向到
|
||
undocheckout 命令的输入。)
|
||
|
||
cm ^unco .--^machinereadable
|
||
(撤销当前目录中的签出,并以易于解析的
|
||
简化格式打印结果。)
|
||
|
||
cm ^unco .--^machinereadable --^startlineseparator=">" --^endlineseparator="<" \
|
||
--^fieldseparator=","
|
||
(撤销当前目录中的签出,并以易于解析的简化
|
||
格式打印结果,以指定的字符串作为行的开头和结尾以及
|
||
对各字段进行分隔。)
|
||
|
||
== CMD_DESCRIPTION_UNDOCHECKOUTUNCHANGED ==
|
||
撤销未更改的已签出项。
|
||
|
||
== CMD_USAGE_UNDOCHECKOUTUNCHANGED ==
|
||
用法:
|
||
|
||
cm ^uncounchanged | ^unuc <项路径>[ ...][-^R | -^r | --^recursive]
|
||
[--^symlink] [--^silent]
|
||
|
||
项路径 要应用操作的项。使用空格对各个路径进行
|
||
分隔。使用双引号 (" ") 指定包含空格
|
||
的路径。
|
||
使用 . 将操作应用到当前目录。
|
||
|
||
选项:
|
||
|
||
-^R 在指定路径中以递归方式撤销未更改的项。
|
||
--^symlink 将 uncounchanged 操作应用于链接而不是
|
||
目标。
|
||
--^silent 不显示任何输出。
|
||
|
||
== CMD_HELP_UNDOCHECKOUTUNCHANGED ==
|
||
备注:
|
||
|
||
此命令是从工作区根目录以递归方式应用的。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^uncounchanged' 命令可从 stdin 读取路径。为此,请传递
|
||
一个破折号 "-"。
|
||
示例:cm ^uncounchanged -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要撤销签出的
|
||
未更改文件。
|
||
示例:
|
||
dir /S /B *.c | cm ^uncounchanged -
|
||
(在 Windows 中,撤销对工作区中所有未更改的 .c 文件
|
||
的签出。)
|
||
|
||
示例:
|
||
|
||
cm ^uncounchanged .-^R
|
||
(在当前目录中以递归方式撤销未更改文件的签出。)
|
||
|
||
cm ^unuc /home/myuser/mywk/project/templates -^R
|
||
(在所选目录中以递归方式撤销未更改文件的签出。)
|
||
|
||
== CMD_DESCRIPTION_UNDELETE ==
|
||
使用特定修订来取消删除某个项。
|
||
|
||
== CMD_USAGE_UNDELETE ==
|
||
用法:
|
||
|
||
cm ^undelete <修订规格> <路径>
|
||
|
||
修订规格 所含内容将加载到工作区中的
|
||
修订的规格。(使用 'cm ^help ^objectspec' 可
|
||
进一步了解修订规格。)
|
||
路径 还原路径。
|
||
|
||
== CMD_HELP_UNDELETE ==
|
||
备注:
|
||
|
||
要取消删除的项不应加载到工作区中。
|
||
|
||
Xlink 不支持 '^undelete' 操作。
|
||
|
||
示例:
|
||
|
||
cm ^undelete ^revid:756 C:\mywks\src\foo.c
|
||
cm ^undelete ^itemid:68#^cs:2 C:\mywks\dir\myfile.pdf
|
||
cm ^undelete ^serverpath:/src#^br:/main C:\mywks\Dir
|
||
|
||
== CMD_DESCRIPTION_UNDOCHANGE ==
|
||
撤销路径中的更改。
|
||
|
||
== CMD_USAGE_UNDOCHANGE ==
|
||
用法:
|
||
|
||
cm ^undochange | ^unc <项路径>[ ...][-^R | -^r | --^recursive]
|
||
|
||
项路径 要应用操作的项。使用空格对各个路径进行
|
||
分隔。使用双引号 (" ") 指定包含空格
|
||
的路径。
|
||
使用 . 将操作应用到当前目录。
|
||
|
||
选项:
|
||
|
||
-^R 以递归方式应用操作。
|
||
|
||
== CMD_HELP_UNDOCHANGE ==
|
||
备注:
|
||
|
||
如果已签出某个项或已修改但未签入这个项,并且不想
|
||
签入这个项,则可以使用此命令撤销更改。项将
|
||
更新为之前的内容。
|
||
|
||
从 stdin 读取输入:
|
||
|
||
'^undochange' 命令可从 stdin 读取路径。为此,请传递
|
||
一个破折号 "-"。
|
||
示例:cm ^undochange -
|
||
|
||
路径将一直读取到有空行输入为止。
|
||
这种情况下允许使用竖线指定要撤销更改的文件。
|
||
示例:
|
||
dir /S /B *.c | cm ^undochange -
|
||
(在 Windows 中,撤销对工作区中所有 .c 文件的更改。)
|
||
|
||
示例:
|
||
|
||
cm ^unc .
|
||
(撤销当前目录中的文件更改。)
|
||
|
||
cm ^undochange .-^R
|
||
(以递归方式撤销当前目录中的文件更改。)
|
||
|
||
cm ^unc file1.txt "file 2.txt"
|
||
(撤销所选文件的更改。)
|
||
|
||
cm ^unc c:\workspace\file.txt
|
||
(撤销所选文件的更改。)
|
||
|
||
== CMD_DESCRIPTION_UNDO ==
|
||
撤销工作区中的更改。
|
||
|
||
== CMD_USAGE_UNDO ==
|
||
用法:
|
||
|
||
cm ^undo [<路径>[ ...]] [--^symlink] [-^r | --^recursive] [<筛选器>[ ...]]
|
||
[--^silent | --^machinereadable [--^startlineseparator=<分隔符>]
|
||
[--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
|
||
|
||
路径 要应用操作的文件或目录
|
||
的路径。使用双引号 (" ") 指定包含空格的
|
||
路径。使用空格对各个路径进行分隔。
|
||
如果未指定路径,则默认情况下,
|
||
撤销操作将应用于当前目录中的所有
|
||
文件。
|
||
筛选器 将一个或多个指定筛选器应用于给定
|
||
路径。使用空格对各个筛选器进行分隔。请参阅
|
||
“筛选器”部分以了解更多信息。
|
||
|
||
选项:
|
||
|
||
--^symlink 将撤销操作应用于符号链接而不是
|
||
目标。
|
||
-^r 以递归方式执行撤销。
|
||
--^silent 不显示任何输出。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何开头。
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
行应如何结尾。
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,指定
|
||
应如何分隔字段。
|
||
筛选器:
|
||
|
||
如果未指定标志,则默认情况下将撤销所有更改,但是
|
||
可以使用以下一个或多个标志来筛选路径。
|
||
如果文件或目录匹配一个或多个指定种类的更改,
|
||
则将撤销该文件或目录上的所有更改。
|
||
例如,如果同时指定了 '--^checkedout' 和 '--^moved',则在
|
||
已签出并移动文件的情况下,两项更改都将被撤销。
|
||
|
||
--^checkedout 选择已签出的文件和目录。
|
||
--^unchanged 选择内容不变的文件。
|
||
--^changed 选择本地更改的或签出的文件和
|
||
目录。
|
||
--^deleted 选择已删除的文件和目录。
|
||
--^moved 选择已移动的文件和目录。
|
||
--^added 选择已添加的文件和目录。
|
||
|
||
== CMD_HELP_UNDO ==
|
||
备注:
|
||
|
||
'^undo' 命令有风险,因为该命令在撤销工作后将不可逆。
|
||
^undo 完成后,无法将受其影响的文件和目录
|
||
恢复到先前状态。如果参数中
|
||
未指定路径,则默认情况下,该命令将撤销
|
||
当前目录中的所有更改,但不采用递归方式。
|
||
从 /src 目录执行时,以下命令是等效的:
|
||
|
||
/src
|
||
|- file.txt
|
||
|- code.cs
|
||
\- /test
|
||
|- test_a.py
|
||
\- test_b.py
|
||
|
||
cm ^undo
|
||
cm ^undo *
|
||
cm ^undo file.txt code.cs /test
|
||
|
||
cm ^undo .
|
||
cm ^undo /src file.txt code.cs
|
||
|
||
如果希望操作以递归方式执行,必须指定 '-^r' 标志。
|
||
|
||
撤销某一目录下的所有更改(包括影响目录
|
||
本身的更改):
|
||
|
||
cm ^undo 目录路径 -^r
|
||
|
||
如果目录路径是工作区路径,则工作区中的每个更改都将
|
||
被撤销。
|
||
|
||
已删除项:
|
||
|
||
要撤销对文件和目录的删除,必须指定项的
|
||
完整路径,或者指定所属目录并使用递归 ('-^r')
|
||
标志。
|
||
|
||
例如:
|
||
|
||
cm ^undo .
|
||
(不撤销当前目录中的删除。)
|
||
|
||
cm ^undo .-^r
|
||
(以递归方式撤销当前目录中的所有删除(和其他更改)。)
|
||
|
||
cm ^undo src/file.txt
|
||
(撤销对 src/file.txt 的删除(或其他更改)。)
|
||
|
||
示例:
|
||
|
||
cm ^undo .-^r
|
||
(以递归方式撤销当前目录中的所有更改。如果从工作区的
|
||
根目录执行,则撤销整个工作区中的所有更改。)
|
||
|
||
cm ^co file.txt
|
||
cm ^undo file.txt
|
||
(撤销对 'file.txt' 的签出。)
|
||
|
||
^echo ^content >> file.txt
|
||
cm ^undo file.txt
|
||
(撤销对 'file.txt' 的本地更改。)
|
||
|
||
cm ^undo src
|
||
(撤销对 src 目录及其文件的更改。)
|
||
|
||
cm ^undo src/*
|
||
(撤销对 src 中包含的每个文件和目录的更改,而不会
|
||
影响 src。)
|
||
|
||
cm ^undo *.cs
|
||
(撤销对当前目录中与 *.cs 匹配的每个文件或目录的
|
||
更改。)
|
||
|
||
cm ^undo *.cs -^r
|
||
(撤销对当前目录中以及下级所有目录中与 *.cs 匹配的
|
||
每个文件或目录的更改。)
|
||
|
||
cm ^co file1.txt file2.txt
|
||
^echo ^content >> file1.txt
|
||
cm ^undo --^unchanged
|
||
(撤销对未更改的 'file2.txt' 的签出,并忽略本地更改的
|
||
'file1.txt'。)
|
||
|
||
^echo ^content >> file1.txt
|
||
^echo ^content >> file2.txt
|
||
cm ^co file1.txt
|
||
cm ^undo --^checkedout
|
||
(撤销已签出文件 'file1.txt' 中的更改,并忽略 'file2.txt',
|
||
因为后者未签出。)
|
||
|
||
cm ^add file.txt
|
||
cm ^undo file.txt
|
||
(撤销添加 'file.txt',使该文件再次成为私有文件。)
|
||
|
||
^rm file1.txt
|
||
^echo ^content >> file2.txt
|
||
cm ^add file3.txt
|
||
cm ^undo --^deleted --^added *
|
||
(撤销 'file1.txt' 的删除和 'file3.txt' 的添加,并忽略 'file2.txt'
|
||
的更改。)
|
||
|
||
== CMD_DESCRIPTION_LOCK_UNLOCK ==
|
||
撤销锁定服务器上的项锁定。
|
||
|
||
== CMD_USAGE_LOCK_UNLOCK ==
|
||
用法:
|
||
|
||
cm ^lock ^unlock [<存储库服务器规格>] <GUID>[ ...]
|
||
|
||
存储库服务器规格 存储库服务器规格。(使用 'cm ^help ^objectspec'
|
||
可进一步了解存储库服务器规格。)
|
||
GUID 要解锁的项 GUID 的列表。使用空格对各个 GUID
|
||
进行分隔。
|
||
|
||
== CMD_HELP_LOCK_UNLOCK ==
|
||
备注:
|
||
|
||
- 该命令使用指定的服务器来解锁项。
|
||
- 如果未指定服务器,则该命令会尝试从当前工作区
|
||
获取服务器。
|
||
- 如果在先前的步骤中未计算服务器,则会从当前的
|
||
Unity VCS 客户端配置中获取服务器。
|
||
- 只有服务器的管理员才能运行 'cm ^unlock' 命令。
|
||
- 要指定 GUID,格式应为 32 位数字,并用
|
||
短横线分隔(也可以选择用花括号括起来):
|
||
|
||
{00000000-0000-0000-0000-000000000000}
|
||
或 00000000-0000-0000-0000-000000000000
|
||
|
||
示例:
|
||
|
||
cm ^lock ^unlock 91961b14-3dfe-4062-8c4c-f33a81d201f5
|
||
(撤销所选项锁定。)
|
||
|
||
cm ^lock ^unlock DIGITALIS:8084 2340b4fa-47aa-4d0e-bb00-0311af847865 \
|
||
bcb98a61-2f62-4309-9a26-e21a2685e075
|
||
(撤销名为 'DIGITALIS' 的锁定服务器上的所选项锁定。)
|
||
|
||
cm ^lock ^unlock tardis@cloud 4740c4fa-56af-3dfe-de10-8711fa248635 \
|
||
71263c17-5eaf-5271-4d2c-a25f72e101d4
|
||
(撤销名为 'tardis' 的 Cloud 锁定服务器上的所选项锁定。)
|
||
|
||
== CMD_DESCRIPTION_UPDATE ==
|
||
更新工作区并下载最新的更改。
|
||
|
||
== CMD_USAGE_UPDATE ==
|
||
用法:
|
||
|
||
cm ^update [<项路径> | --^last]
|
||
[--^changeset=<变更集规格>] [--^cloaked] [--^dontmerge] [--^forced]
|
||
[--^ignorechanges] [--^override] [--^recursewk] [--^skipchangedcheck]
|
||
[--^silent] [--^verbose] [--^xml[=<输出文件>]] [--^encoding=<名称>]
|
||
[--^machinereadable [--^startlineseparator=<分隔符>]
|
||
[--^endlineseparator=<分隔符>] [--^fieldseparator=<分隔符>]]
|
||
[--^forcedetailedprogress]
|
||
|
||
项路径 要更新的路径。
|
||
使用 . 将更新应用到当前目录。
|
||
如果未指定路径,则当前工作区
|
||
将完全更新。
|
||
--^last 在更新之前,将工作区选择器
|
||
从变更集配置或标签配置更改为
|
||
分支配置。
|
||
选择器将更改为变更集或标签
|
||
所属的分支。
|
||
|
||
选项:
|
||
|
||
--^changeset 将工作区更新为特定变更集。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解
|
||
变更集规格。)
|
||
--^cloaked 在更新操作中包含掩蔽的项。
|
||
如果未指定此选项,则在操作中
|
||
将忽略掩蔽的项。
|
||
--^dontmerge 如果在更新操作期间需要
|
||
合并更新,请不要执行合并。
|
||
--^forced 强制将项更新为选择器中指定的
|
||
修订。
|
||
--^ignorechanges 忽略在更新工作区时
|
||
检测到待定更改的情况下显示
|
||
的待定更改警告消息。
|
||
--^override 覆盖不受 Unity VCS 控制的已更改文件。
|
||
这些文件的内容将被服务器内容
|
||
覆盖。
|
||
--^recursewk 更新在当前路径中找到的所有
|
||
工作区。适合用于更新特定路径中包含的
|
||
所有工作区。
|
||
--^skipchangedcheck 该更新在开始之前会检查工作区中是否
|
||
存在本地更改。如果始终在修改
|
||
文件之前签出,则可以进行此检查并
|
||
加快操作速度。
|
||
--^silent 不显示任何输出。
|
||
--^verbose 显示其他信息。
|
||
--^xml 以 XML 格式将输出打印到标准输出。
|
||
可以指定输出文件。
|
||
--^encoding 与 --^xml 选项结合使用,指定要在 XML 输出
|
||
中使用的编码(例如:utf-8)。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定行应如何开头。
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定行应如何结尾。
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定应如何分隔字段。
|
||
--^forcedetailedprogress 即使在标准输出被重定向的情况下也要强制显示
|
||
详细进度。
|
||
== CMD_HELP_UPDATE ==
|
||
备注:
|
||
|
||
'^update' 命令仅下载所需的文件。
|
||
|
||
该命令采用递归操作。
|
||
|
||
使用 --^last' 选项时,无需指定路径。
|
||
在这种情况下,当前工作目录所属的工作区
|
||
将更新。
|
||
(切记,如果工作区选择器先前指向某个
|
||
变更集或标签,则指定该标志可能导致
|
||
工作区选择器更改为分支配置。)
|
||
|
||
|
||
示例:
|
||
|
||
cm ^update
|
||
(更新当前工作区中的所有项。)
|
||
|
||
cm ^update .
|
||
(更新当前目录以及所有子项。)
|
||
|
||
cm ^update .--^forced --^verbose
|
||
(强制检索所有修订。)
|
||
|
||
cm ^update --^last
|
||
|
||
cm ^update .--^machinereadable --^startlineseparator=">"
|
||
(更新当前目录,并以易于解析的简化格式
|
||
打印结果,以指定的字符串作为行的
|
||
开头。)
|
||
|
||
== CMD_DESCRIPTION_VERSION ==
|
||
显示当前的客户端版本号。
|
||
|
||
== CMD_USAGE_VERSION ==
|
||
用法:
|
||
|
||
cm ^version
|
||
|
||
== CMD_HELP_VERSION ==
|
||
|
||
== CMD_DESCRIPTION_WHOAMI ==
|
||
显示当前的 Unity VCS 用户。
|
||
|
||
== CMD_USAGE_WHOAMI ==
|
||
用法:
|
||
|
||
cm ^whoami
|
||
|
||
== CMD_HELP_WHOAMI ==
|
||
|
||
== CMD_USAGE_WKTREENODESTATUS ==
|
||
用法:
|
||
|
||
cm ^wktreenodestatus 路径1, 路径2, ...
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE ==
|
||
允许用户管理工作区。
|
||
|
||
== CMD_USAGE_WORKSPACE ==
|
||
用法:
|
||
|
||
cm ^workspace | ^wk <命令> [选项]
|
||
|
||
命令:
|
||
|
||
^list | ^ls
|
||
^create | ^mk
|
||
^delete | ^rm
|
||
^move | ^mv
|
||
^rename
|
||
|
||
要获取有关每条命令的更多信息,请运行:
|
||
cm ^workspace <命令> --^usage
|
||
cm ^workspace <命令> --^help
|
||
|
||
== CMD_HELP_WORKSPACE ==
|
||
示例:
|
||
|
||
cm ^workspace ^create myWorkspace 工作区路径
|
||
cm ^workspace ^list
|
||
cm ^workspace ^delete myWorkspace
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_CREATE ==
|
||
创建新的工作区。
|
||
|
||
== CMD_USAGE_WORKSPACE_CREATE ==
|
||
用法:
|
||
|
||
cm ^workspace | ^wk [^create | ^mk] <工作区名称> <工作区路径> [<存储库规格>]
|
||
[--^selector[=<选择器文件>]
|
||
(创建新的工作区。)
|
||
|
||
cm ^workspace | ^wk [^create | ^mk] <工作区名称> <工作区路径> --^dynamic --^tree=[<树>]
|
||
(创建动态工作区。此功能仍处于实验阶段,
|
||
仅适用于 Windows。)
|
||
|
||
工作区名称 新工作区的名称。
|
||
工作区路径 新工作区的路径。
|
||
存储库规格 使用指定的存储库创建新的工作区。
|
||
存储库规格:查看 'cm ^help ^objectspec'。
|
||
|
||
选项:
|
||
|
||
--^selector 编辑新工作区的选择器。
|
||
如果指定了选择器文件,则会从指定文件
|
||
为新工作区设置选择器。
|
||
--^dynamic 创建动态工作区。此功能仍处于
|
||
实验阶段,仅适用于 Windows。
|
||
指定此标志需要使用 --^tree 参数。
|
||
--^tree 与 '--^dynamic' 标志结合使用,指定要
|
||
加载动态工作区的初始点。此选项
|
||
可以是分支、变更集或标签规格。
|
||
工作区稍后将使用规格中的
|
||
存储库。(使用 'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
== CMD_HELP_WORKSPACE_CREATE ==
|
||
备注:
|
||
|
||
- 工作区是映射到本地文件系统的存储库的视图。
|
||
工作区选择器可以定义用于指定工作区内容的规则。
|
||
使用 'cm ^showselector' 显示工作区选择器,或使用 'cm ^setselector' 修改
|
||
工作区选择器。
|
||
- 如果存储库规格和 '--^selector' 均未指定,则工作区
|
||
将自动配置为使用 client.conf 文件中配置的
|
||
服务器的第一个存储库(按字母顺序)。
|
||
- 动态工作区是一项实验性功能(仅适用于 Windows),
|
||
并需要运行 plasticfs.exe 程序。
|
||
|
||
示例:
|
||
|
||
cm ^workspace ^create myworkspace c:\workspace
|
||
cm ^wk ^mk myworkspace /home/john/plastic_view
|
||
(分别在 Windows 和 Linux 中创建 'myworkspace' 工作区。)
|
||
|
||
cm ^wk mywktest c:\wks\wktest --^selector=myselector.txt
|
||
(使用 'myselector.txt' 文件中的选择器创建 'mywktest' 工作区。)
|
||
|
||
cm ^wk mywkprj c:\wks\wkprj myrep@^repserver:localhost:8084
|
||
(使用所选存储库创建 'mywkprj' 工作区。)
|
||
|
||
cm ^wk mywkprj c:\dynwks\mywkprj --^dynamic --^tree=^br:/main@myrep@localhost:8084
|
||
(使用 'myrep@localhost:8084' 存储库创建动态的 'mywkprj'
|
||
工作区,并在首次装入该工作区时指向 '^br:/main'。)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_DELETE ==
|
||
删除工作区。
|
||
|
||
== CMD_USAGE_WORKSPACE_DELETE ==
|
||
用法:
|
||
|
||
cm ^workspace | ^wk ^delete | ^rm [<工作区路径> | <工作区规格>] [--^keepmetadata]
|
||
|
||
工作区路径 要删除的工作区的路径。
|
||
工作区规格 要删除的工作区的规格。(使用
|
||
'cm ^help ^objectspec' 可进一步了解规格。)
|
||
|
||
选项:
|
||
|
||
--^keepmetadata 不删除 .plastic 文件夹中的元数据
|
||
文件。
|
||
|
||
== CMD_HELP_WORKSPACE_DELETE ==
|
||
备注:
|
||
|
||
此命令将删除由路径或规格指定的工作区。
|
||
如果未指定任何参数,则将采用当前工作区。
|
||
|
||
示例:
|
||
|
||
cm ^workspace ^delete
|
||
(删除当前工作区。)
|
||
|
||
cm ^wk ^delete c:\workspace
|
||
cm ^workspace rm /home/danipen/wks
|
||
cm ^wk ^rm ^wk:MiWorkspace
|
||
cm ^wk ^rm ^wk:MiWorkspace@DIGITALIS
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_LIST ==
|
||
列出工作区。
|
||
|
||
== CMD_USAGE_WORKSPACE_LIST ==
|
||
用法:
|
||
|
||
cm ^workspace | ^wk [^list | ^ls] [--^format=<格式字符串>]
|
||
|
||
选项:
|
||
|
||
--^format 检索特定格式的输出消息。请参阅
|
||
“备注”以了解更多信息。
|
||
|
||
== CMD_HELP_WORKSPACE_LIST ==
|
||
备注:
|
||
|
||
此命令接受格式字符串以显示输出。
|
||
此命令的输出参数如下:
|
||
|
||
{0} | {^wkname} 工作区名称。
|
||
{1} | {^machine} 客户端机器名称。
|
||
{2} | {^path} 工作区路径。
|
||
{3} | {^wkid} 工作区唯一标识符。
|
||
{4} | {^wkspec} 使用以下格式的工作区规格:
|
||
'wkname@machine'。
|
||
{^tab} 插入一个制表符空格位。
|
||
{^newline} 插入一个新行。
|
||
|
||
示例:
|
||
|
||
cm ^wk
|
||
(列出所有工作区。)
|
||
|
||
cm ^workspace ^list --^format={0}#{3,40}
|
||
cm ^workspace ^list --^format={^wkname}#{^wkid,40}
|
||
(列出所有工作区,并在 40 个空格位中显示工作区名称、# 符号
|
||
和工作区 GUID 字段(左对齐)。)
|
||
|
||
cm ^wk --^format="路径 {2} 中的工作区 {0}"
|
||
cm ^wk --^format="路径 {^path} 中的工作区 {^wkname}"
|
||
(列出所有工作区并将结果显示为格式化的字符串。)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_MOVE ==
|
||
移动工作区。
|
||
|
||
== CMD_USAGE_WORKSPACE_MOVE ==
|
||
用法:
|
||
|
||
cm ^workspace | ^wk ^move | ^mv [<工作区规格>] <新路径>
|
||
|
||
选项:
|
||
|
||
工作区规格 要移动的工作区的规格。(使用
|
||
'cm ^help ^objectspec' 可进一步了解规格。)
|
||
新路径 工作区将移动到此处。
|
||
|
||
== CMD_HELP_WORKSPACE_MOVE ==
|
||
备注:
|
||
|
||
此命令允许用户将工作区移动到磁盘上的另一个位置。
|
||
|
||
示例:
|
||
|
||
cm ^workspace ^move myWorkspace \new\workspaceDirectory
|
||
(将 'myWorkspace' 移动到指定位置。)
|
||
|
||
cm ^wk ^mv c:\users\maria\wkspaces\newlocation
|
||
(将当前工作区移动到新位置。)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACE_RENAME ==
|
||
重命名工作区。
|
||
|
||
== CMD_USAGE_WORKSPACE_RENAME ==
|
||
用法:
|
||
|
||
cm ^workspace | ^wk ^rename [<工作区名称>] <新名称>
|
||
|
||
工作区名称 要重命名的工作区。
|
||
新名称 工作区的新名称。
|
||
|
||
== CMD_HELP_WORKSPACE_RENAME ==
|
||
备注:
|
||
|
||
此命令将重命名工作区。
|
||
如果未提供工作区名称,则将使用当前工作区。
|
||
|
||
示例:
|
||
|
||
cm ^workspace ^rename mywk1 wk2
|
||
(将工作区 'mywk1' 重命名为 'wk2'。)
|
||
|
||
cm ^wk ^rename newname
|
||
(将当前工作区重命名为 'newname'。)
|
||
|
||
== CMD_DESCRIPTION_WORKSPACESTATUS ==
|
||
显示工作区中的更改。
|
||
|
||
== CMD_USAGE_WORKSPACESTATUS ==
|
||
用法:
|
||
|
||
cm ^status [<工作区路径>] [--^changelist[=<名称>] | --^changelists] [--^cutignored]
|
||
[ --^header] [ --^noheader] [ --^nomergesinfo] [ --^head]
|
||
[--^short] [--^symlink] [ --^dirwithchanges] [--^xml[=<输出文件>]]
|
||
[--^encoding=<名称>] [ --^wrp | --^wkrootrelativepaths]
|
||
[--^fullpaths | --^fp] [<旧选项>] [<搜索类型>[ ...]]
|
||
[--^machinereadable [--^startlineseparator=分隔符]
|
||
[--^endlineseparator=分隔符] [--^fieldseparator=分隔符]]
|
||
|
||
选项:
|
||
|
||
工作区路径 要作为搜索范围的工作区的
|
||
路径。
|
||
--^changelist 显示所选更改列表中的更改。
|
||
--^changelists 显示按客户端更改列表进行分组的更改。
|
||
--^cutignored 跳过已忽略目录的内容。
|
||
需要 '--^ignored' 搜索类型。请参阅
|
||
“搜索类型”部分以了解更多信息。
|
||
--^header 仅打印工作区状态。
|
||
--^noheader 仅打印修改后的项搜索结果。
|
||
--^nomergesinfo 不打印更改的合并信息。
|
||
--^head 打印分支上最后一个变更集的状态。
|
||
--^short 仅列出包含更改的路径。
|
||
--^symlink 将操作应用于符号链接而不是
|
||
目标。
|
||
--^dirwithchanges 显示含有更改的目录
|
||
(含有已添加、移动、删除的项)。
|
||
--^xml 以 XML 格式将输出打印到标准输出。
|
||
可以指定输出文件。
|
||
--^pretty Prints workspace changes in a nice table format.
|
||
--^encoding 与 --^xml 选项结合使用,指定要在 XML 输出
|
||
中使用的编码(例如:utf-8)。
|
||
请参阅位于以下网址的 MSDN 文档:
|
||
http://msdn.microsoft.com/en-us/library/system.text.encoding.aspx
|
||
以查看包含受支持编码及其格式的表格
|
||
(位于页面末尾的“名称”列中)。
|
||
--^wrp 打印工作区根目录的相对路径,而不是
|
||
当前目录的相对路径。
|
||
--^fullpaths, --^fp 强制打印绝对路径,覆盖所有其他
|
||
路径打印设置。
|
||
--^machinereadable 以易于解析的格式输出结果。
|
||
--^startlineseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定行应如何开头。
|
||
--^endlineseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定行应如何结尾。
|
||
--^fieldseparator 与 '--^machinereadable' 标志结合使用,
|
||
指定应如何分隔字段。
|
||
|
||
旧选项:
|
||
|
||
--^cset 以旧格式打印工作区状态。
|
||
--^compact 以旧格式打印工作区状态和
|
||
更改列表。
|
||
--^noheaders 与 '--^compact' 标志结合使用时,不会
|
||
打印更改列表标题。(不适用于
|
||
新更改列表格式。)
|
||
|
||
搜索类型:
|
||
|
||
--^added 打印已添加的项。
|
||
--^checkout 打印已签出的项。
|
||
--^changed 打印已更改的项。
|
||
--^copied 打印已复制的项。
|
||
--^replaced 打印已替换的项。
|
||
--^deleted 打印已删除的项。
|
||
--^localdeleted 打印已在本地删除的项。
|
||
--^moved 打印已移动的项。
|
||
--^localmoved 打印已在本地移动的项。
|
||
--^percentofsimilarity=<值> 为了将两个文件视为同一个项而需要
|
||
两者之间达到的相似程度百分比。用于
|
||
搜索已在本地移动的项。默认值
|
||
为 20%。
|
||
--^txtsameext 在搜索已移动的项期间,
|
||
相似性内容匹配过程将
|
||
仅考虑具有相同扩展名的
|
||
文本文件。默认情况下,
|
||
将处理任何文本文件。
|
||
--^binanyext 在搜索已移动的项期间,
|
||
相似性内容匹配过程将
|
||
考虑任何二进制文件。默认情况下,
|
||
只会处理具有相同扩展名的
|
||
二进制文件。
|
||
--^private 打印非受控项。
|
||
--^ignored 打印已忽略的项。
|
||
--^hiddenchanged 打印隐藏的已更改项。(包括
|
||
'--^changed')
|
||
--^cloaked 打印掩蔽的项。
|
||
--^controlledchanged 此标志替代以下选项:
|
||
'--^added'、'--^checkout'、'--^copied'、
|
||
'--^replaced'、'--^deleted'、'--^moved'。
|
||
--^all 此标志替换以下参数:
|
||
'--^controlledchanged'、'--^changed'、
|
||
'--^localdeleted'、'--^localmoved'、'--^private'。
|
||
|
||
== CMD_HELP_WORKSPACESTATUS ==
|
||
备注:
|
||
|
||
'^status' 命令将打印工作区中已加载的变更集,并在工作区
|
||
内获取已更改的元素。
|
||
|
||
此命令可用于显示工作区中的待定更改;
|
||
可以使用命令参数来修改可以搜索的
|
||
更改类型。默认情况下将显示所有更改,无论是
|
||
受控更改还是本地更改。
|
||
|
||
搜索已在本地移动的项时会使用相似性参数百分比
|
||
'--^percentofsimilarity' (-^p) 来确定两个元素是否为同一个项。
|
||
默认值为 20%,但可以调整。
|
||
|
||
可以显示按客户端更改列表分组的工作区更改。
|
||
'^default' 更改列表包括其他更改列表中
|
||
未包含的更改。因此,默认更改列表将显示的更改
|
||
取决于指定的搜索类型标志。
|
||
|
||
要显示按更改列表分组的更改,还需要显示受控
|
||
的更改(状态为 '^added'、'^checkout'、'^copied'、
|
||
、'^replaced'、'^deleted' 或 '^moved' 的项)。因此,当显示更改列表时,
|
||
'--^controlledchanged' 选项将自动启用。
|
||
|
||
XML 输出的默认编码为 utf-8。
|
||
|
||
默认情况下,此命令将打印当前目录的相对路径,
|
||
除非指定了 '--^machinereadable' 或 '--^short' 标志。如果
|
||
指定了其中任何一个标志,该命令将打印绝对路径。
|
||
|
||
如果指定了 '--^xml' 标志,则将打印工作区根目录的
|
||
相对路径(除非也指定了 '--^fp' 标志,那么将
|
||
打印绝对路径)。
|
||
|
||
示例:
|
||
|
||
cm ^status
|
||
(打印工作变更集以及工作区中所有已更改的
|
||
项类型,但已忽略的项除外。)
|
||
|
||
cm ^status --^controlledchanged
|
||
(打印工作变更集以及已签出、添加、复制、替换、
|
||
删除和移动的项。)
|
||
|
||
cm ^status --^added
|
||
(仅打印工作变更集和工作区中添加的项。)
|
||
|
||
cm ^status c:\workspaceLocation\code\client --^added
|
||
(以递归方式打印指定路径下的工作变更集和
|
||
添加的项。)
|
||
|
||
cm ^status --^changelists
|
||
cm ^status --^changelist
|
||
(显示按客户端更改列表分组的所有工作区更改。)
|
||
|
||
cm ^status --^changelist=pending_to_review
|
||
(显示名为 'pending_to_review' 的更改列表中的更改。)
|
||
|
||
cm ^status --^changelist=default --^private
|
||
(显示 'default' 更改列表中的更改,包括私有项以及
|
||
具有受控更改的项(如果有)。)
|
||
|
||
cm ^status --^short --^changelist=pending_to_review | cm ^checkin -
|
||
(签入更改列表 'pending_to_review' 中的更改。)
|
||
|
||
cm ^status C:\workspaceLocation --^xml=output.xml
|
||
(获取 XML 格式的状态信息,并在文件 output.xml 中
|
||
使用 utf-8。)
|
||
|
||
cm ^status --^ignored
|
||
(显示所有已忽略的项。)
|
||
输出:
|
||
/main@myrepo@local (^cs:2 - ^head)
|
||
^Added
|
||
状态 大小 上次修改时间 路径
|
||
|
||
^Ignored 0 字节 19 秒前 out\app.exe
|
||
^Ignored 48 秒前 src
|
||
^Ignored 0 字节 48 秒前 src\version.c
|
||
|
||
cm ^status --^ignored --^cutignored
|
||
(显示父目录未被忽略的已忽略文件,并显示
|
||
内容未被忽略的已忽略目录。)
|
||
输出:
|
||
/main@myrepo@local (^cs:2 - ^head)
|
||
^Added
|
||
状态 大小 上次修改时间 路径
|
||
|
||
^Ignored 0 字节 19 秒前 out\app.exe
|
||
^Ignored 48 秒前 src
|
||
|
||
== CMD_DESCRIPTION_XLINK ==
|
||
创建、编辑或显示 Xlink 的详细信息。
|
||
|
||
== CMD_USAGE_XLINK ==
|
||
用法:
|
||
|
||
cm ^xlink [-^w] [-^rs] <Xlink_路径> / (<变更集规格> | <标签规格> | <分支规格)>
|
||
[<扩展规则>[ ...]]
|
||
(创建一个 Xlink。)
|
||
|
||
cm ^xlink [-^rs] <Xlink_路径> /<相对路径> (<变更集规格> | <标签规格> | <分支规格>)
|
||
[<扩展规则>[ ...]]
|
||
(创建指向 /<相对路径>(而不是指向默认根目录 /)的只读
|
||
部分 Xlink。)
|
||
|
||
cm ^xlink -^e <Xlink_路径> (<变更集规格> | <标签规格> | <分支规格>)
|
||
(编辑 Xlink 以更改目标规格。)
|
||
|
||
cm ^xlink -^s|--^show <Xlink_路径>
|
||
(显示 Xlink 信息,包括扩展规则。)
|
||
|
||
cm ^xlink -^ar|--^addrules <Xlink_路径> <扩展规则>[ ...]
|
||
(将给定的扩展规则添加到 Xlink。)
|
||
|
||
cm ^xlink -^dr|--^deleterules <Xlink_路径> <扩展规则>[ ...]
|
||
(从 Xlink 中删除给定的扩展规则。)
|
||
|
||
Xlink_路径 这是当前工作区中将装入(创建 Xlink 时)
|
||
或已经装入(编辑 Xlink 时)
|
||
已链接的存储库的目录。
|
||
变更集规格 远程存储库中的完整目标变更集
|
||
规格。
|
||
此规格确定了已链接的存储库的工作区中
|
||
加载了哪个版本和分支。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解变更集
|
||
规格。)
|
||
标签规格 远程存储库中的完整标签规格。
|
||
(使用 'cm ^help ^objectspec' 可进一步了解标签
|
||
规格。)
|
||
分支规格 远程存储库中的完整分支规格。
|
||
此规格使用指定的分支所指向的
|
||
当前变更集。(使用 'cm ^help ^objectspec' 可
|
||
可进一步了解分支规格。)
|
||
-^e 编辑现有的 Xlink 以更改目标变更集
|
||
规格。
|
||
-^s | --^show 显示有关所选 Xlink 的信息。
|
||
-^ar | --^addrules 将一个或多个扩展规则添加到所选 Xlink。
|
||
-^dr | --^deleterules 从所选 Xlink 中删除一个或多个扩展
|
||
规则。
|
||
扩展规则 指定一个或多个扩展规则。每个扩展
|
||
规则都是一对分支/目标分支:
|
||
^br:/main/fix-^br:/main/develop/fix
|
||
|
||
选项:
|
||
|
||
-^w 表示 Xlink 是可写的。这意味着
|
||
可以通过分支自动扩展功能来修改
|
||
目标存储库的内容。
|
||
-^rs 相对服务器。此选项允许创建独立于
|
||
存储库服务器的相对 Xlink。这样,
|
||
在不同服务器的复制存储库中
|
||
创建的 Xlink 将被自动识别。
|
||
|
||
== CMD_HELP_XLINK ==
|
||
备注:
|
||
|
||
此命令将创建指向给定变更集的 Xlink。默认情况下将创建一个
|
||
只读 Xlink。这意味着无法修改 Xlink 内部工作区中
|
||
加载的内容。为了能够更改通过 Xlink 链接的内容,
|
||
请创建可写的 Xlink(使用 '-^w' 选项)。
|
||
|
||
在编辑 Xlink 的目标变更集时,可以使用
|
||
该命令的简化语法。这样,唯一需要的参数是
|
||
新的目标变更集。Xlink 的其余参数将不会
|
||
被修改。
|
||
|
||
分支自动扩展:
|
||
|
||
在任何可写 Xlink 链接的存储库('-^w' 选项)中进行更改时,
|
||
需要在目标存储库中创建一个新分支。新分支的
|
||
名称基于顶级存储库中定义的签出
|
||
分支。为了确定要使用的分支的名称,遵循以下规则:
|
||
|
||
1) 系统会检查目标存储库中是否存在具有
|
||
相同全名的分支:
|
||
- 如果存在,则将此分支用作签出分支。
|
||
- 如果不存在,则通过以下方式构建分支名称:
|
||
- 通过 Xlink 链接的目标变更集的分支名称 + 签出分支
|
||
的简短名称(最后一部分)。
|
||
- 如果存在此分支,则将此分支用作签出分支。
|
||
- 否则,将创建分支并将分支基项设置为
|
||
通过 Xlink 链接的变更集。
|
||
|
||
2) 在父存储库的分支中创建 Xlink 的新版本,
|
||
指向通过 Xlink 链接的存储库中的新变更集。
|
||
|
||
最后,完整的 Xlink 结构会与正确版本中的
|
||
最新更改保持同步。
|
||
|
||
示例:
|
||
|
||
cm ^xlink code\firstrepo / 1@first@localhost:8084
|
||
(在当前工作区的文件夹 'firstrepo' 中创建一个 Xlink,
|
||
在其中将装入存储库 'first' 中的变更集 '1'。)
|
||
|
||
cm ^xlink opengl\include /includes/opengl 1627@includes@localhost:8087
|
||
(在当前工作区的目录 'opengl\include' 中创建只读
|
||
部分 Xlink,在其中,存储库 'includes' 的变更集 '1627' 中的路径
|
||
'/includes/opengl' 将作为根目录装入。这意味着 '/includes/opengl'
|
||
中的任何内容都将装入到 'opengl\include' 中,
|
||
而存储库的其余部分将被忽略。)
|
||
|
||
cm ^xlink -^w -^rs code\secondrepo / ^lb:LB001@second@localhost:8084
|
||
(在当前工作区的文件夹 'secondrepo' 中创建一个
|
||
可写的相对 Xlink,在其中将装入存储库 'second' 中的
|
||
标签 'LB001'。)
|
||
|
||
cm ^xlink code\thirdrepo / 3@third@localhost:8087 ^br:/main-^br:/main/scm003
|
||
(在当前工作区的文件夹 'thirdrepo' 中创建一个 Xlink,
|
||
在其中将装入存储库 'third' 中的变更集 '3'。)
|
||
|
||
cm ^xlink -^e code\secondrepo ^br:/main/task1234@second@localhost:8084
|
||
(通过链接存储库 'second' 中的分支 'main/task1234',
|
||
编辑 Xlink 'code\secondrepo' 以更改目标存储库。)
|
||
|
||
cm ^xlink --^show code\thirdrepo
|
||
(显示 Xlink 'code\thirdrepo' 的信息,包括其扩展规则
|
||
(如果存在))。
|
||
|
||
cm ^xlink -^ar code\secondrepo ^br:/main-^br:/main/develop ^br:/main/fix-^br:/main/develop/fix
|
||
(将两个扩展规则添加到 Xlink 'code\secondrepo'。)
|
||
|
||
cm ^xlink -^dr code\secondrepo ^br:/main/fix-^br:/main/develop/fix
|
||
(从 Xlink 'code\secondrepo' 中删除扩展规则)。
|
||
|
||
== CMD_USAGE_AUTOCOMPLETE ==
|
||
用法:
|
||
|
||
cm ^autocomplete ^install
|
||
(在 shell 中安装 'cm' 命令补齐功能。)
|
||
|
||
cm ^autocomplete ^uninstall
|
||
(从 shell 中卸载 'cm' 命令补齐功能。)
|
||
|
||
cm ^autocomplete --^line <shell_行> --^position <光标位置>
|
||
(返回自动补齐建议,以便将“shell_行”插入
|
||
“光标位置”。此命令并非供最终用户使用,但这里记载
|
||
此命令是考虑到您可能需要扩展对所选 shell 的
|
||
自动补齐支持。)
|
||
|
||
shell_行 当请求自动补齐时由用户
|
||
写入 shell 的行。
|
||
在 Bash 中,此值位于 COMP_LINE 环境变量中。
|
||
在 PowerShell 中,则位于 $wordToComplete 变量中。
|
||
光标位置 请求自动补齐时的
|
||
光标位置。
|
||
在 Bash 中,此值位于 COMP_POINT 环境变量中。
|
||
在 PowerShell 中,则位于 $cursorPosition 变量中。
|
||
|
||
== CMD_DESCRIPTION_CONFIGURECLIENT ==
|
||
Configures the Unity VCS client for the current machine user to work with a default server.
|
||
|
||
== CMD_USAGE_CONFIGURECLIENT ==
|
||
用法:
|
||
cm ^configure [--^language=<language> --^workingmode=<mode> [AuthParameters]
|
||
--^server=<server> [--^port=<port>]] [--^clientconf=<clientconfpath>]
|
||
|
||
--^language 可用语言:
|
||
en (English)
|
||
es (Spanish)
|
||
|
||
--^workingmode 可用的用户/安全工作模式:
|
||
NameWorkingMode (Name)
|
||
NameIDWorkingMode (Name + ID)
|
||
LDAPWorkingMode (LDAP)
|
||
ADWorkingMode (Active Directory)
|
||
UPWorkingMode (User and password)
|
||
SSOWorkingMode (Single Sign On)
|
||
|
||
AuthParameters 身份验证参数(仅适用于 ^LDAPWorkingMode 和 ^UPWorkingMode):
|
||
--^user=<user>
|
||
--^password=<password>
|
||
|
||
Single Sign On parameters (only for ^SSOWorkingMode):
|
||
--^user=<user>
|
||
--^token=<token>
|
||
|
||
--^server Unity VCS server IP / address
|
||
|
||
--^port Unity VCS server port
|
||
(port optional for Cloud servers)
|
||
|
||
--^clientconf 用于创建配置文件的文件路径(可选)
|
||
参数可以是完整路径、文件名或目录。
|
||
|
||
示例:
|
||
|
||
--^clientconf=c:/path/to/myclient.conf
|
||
(指定的路径将用于创建客户端配置文件)
|
||
|
||
--^clientconf=myclient.conf
|
||
(将使用默认配置目录中的文件 myclient.conf)
|
||
|
||
--^clientconf=c:/exisitingDirectory
|
||
(将使用指定目录中的默认文件名 client.conf)
|
||
|
||
== CMD_HELP_CONFIGURECLIENT ==
|
||
备注:
|
||
|
||
The cm ^configure command cannot be used on Cloud Edition or DVCS Edition of Unity VCS.
|
||
Use 'plastic --configure' instead.
|
||
|
||
示例:
|
||
|
||
cm ^configure
|
||
(runs the interactive Unity VCS client configuration command)
|
||
|
||
cm ^configure --^language=^en --^workingmode=^LDAPWorkingMode --^user=^jack --^password=^01234 \
|
||
--^server=^plastic.mymachine.com --^port=^8084
|
||
(configures the Unity VCS client with the specified parameters and creates the 'client.conf'
|
||
configuration file in the default directory).
|
||
(Cloud 服务器的可选端口)
|
||
|
||
cm ^configure --^language=^en --^workingmode=^NameWorkingMode --^server=^plastic.mymachine.com \
|
||
--^port=^8084 --^clientconf=^clientconf_exp.conf
|
||
(configures the Unity VCS client with the specified parameters and creates the 'client.conf'
|
||
configuration file in the specified path).
|
||
(Cloud 服务器的可选端口)
|