Files
TP_Multimedia/Library/Artifacts/24/24ddc7ae5510e84311ff92f4484a169f
T

8191 lines
309 KiB
Plaintext
Raw Normal View History

2025-01-17 13:10:20 +01:00

aÕ�
 0.0.0þÿÿÿÿÿ0v²,¾|pØäA Ê@Ã3Ë7€ÿÿÿÿ€¦€²€E€ Þ€)€.€2€;a€ Þ€)€.€2€†€r€ Þ€) €.€2
€H€«€ÿÿÿÿ €1€1€ÿÿÿÿ @Þ€€
Q€j€ñ€PÿÿÿÿÀ1€1€ÿÿÿÿ€Þ€€€j€ÿÿÿÿ€b›€ÿÿÿÿ€H€xÿÿÿÿ€1€1€ÿÿÿÿ@Þ€€Q€j€H€}ÿÿÿÿ€1€1€ÿÿÿÿ@Þ€€Q€j€H€†ÿÿÿÿ€1€1€ÿÿÿÿ@Þ€€Q€j€y€
€ Þ€)!€.€2"€€‹ÿÿÿÿ#@1€1€ÿÿÿÿ$Þ€€%.€j€&H€™ÿÿÿÿ'€1€1€ÿÿÿÿ(@Þ€€)Q€j€*H€¤ÿÿÿÿ+€1€1€ÿÿÿÿ,@Þ€€-Q€j€.H€¶ÿÿÿÿ/€1€1€ÿÿÿÿ0@Þ€€1Q€j€2TextScriptImporterPPtr<EditorExtension>m_FileIDm_PathIDPPtr<PrefabInstance>m_ExternalObjectsSourceAssetIdentifiertypeassemblynamem_UsedFileIDsm_UserDatam_AssetBundleNamem_AssetBundleVariant1ÿÿeF¼_1Ch_Þ‰Ž$=O€7€ÿÿÿÿ€¦€²€E€ Þ€€.€€(a€ Þ€€.€€†€r€ Þ€ €.€
€H€«€ÿÿÿÿ €1€1€ÿÿÿÿ @Þ€€
Q€j€H€ê€ÿÿÿÿ€1€1€ÿÿÿÿ@Þ€€Q€j€PPtr<EditorExtension>m_FileIDm_PathIDPPtr<PrefabInstance>H ÄJH¨Ê ÄJcm-help.zh-HansgÊ== 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).