compare

对两个工作空间/流/基线/快照进行比较,从而显示有所不同的基线和变更集。

用途

检查一对流向元素并显示两者之间有所不同的基线和变更集。

在缺省情况下,此显示以项的层次结构呈现:

流向方向(传入/传出)
	组件
		基线
			变更集
				工作项
				文件系统实体

可以使用 -w/--reroot 开关来提高或降低工作项在层次结构中的位置。

基线和变更集具有作者和发布时间信息。您可以使用 -C/--format-contributor 开关来变更作者字段的格式,并可以使用 -D/--format-date 来变更发布时间的格式。

大纲

与其他命令相同。此命令可以采用登录方式运行,可以在以本地方式装入的工作空间中运行,并可以在已卸载的工作空间中运行。

选项和参数

-d |  --dir]  工作空间路径
scm loadscm share 创建的本地工作空间的路径名。在将 工作空间路径 设置为当前工作目录的情况下运行此子命令。如果当前工作目录位于本地工作空间中,那么可以省略此选项。
-P |  --password] 存储库中用户标识的密码
在指定的存储库中,所指定的用户标识的密码。如果命令行中未包含此选项,那么将提示您输入密码。如果您指定了一个存储库 URI 或昵称,而您已使用 scm login 命令存储了它的凭证,那么将忽略此选项。
[-r |  --repository-uri] 存储库 URI
指定要在其中执行此操作的存储库。如果您已经使用 scm login 命令存储了存储库凭证,那么可以使用您为所存储的这些凭证提供的昵称。
-u |  --username] 存储库中的用户标识
指定存在于所指定的存储库中的用户标识。如果您指定了一个存储库 URI 或昵称,而您已使用 scm login 命令存储了它的凭证,那么将忽略此选项。
-c |  --component]  自变量...
仅当按名称指定基线自变量时,才使用此参数。指示基线所在的组件。
-C |  --format-contributor] 自变量
指定应该如何列示添加者。单一自变量是一个字符串,此字符串中的下列字段将被替换:
  • {userid} - 替换为用户的唯一存储库用户标识。
  • {name} - 替换为存储库中列示的用户名。
  • {email} - 替换为存储库中列示的用户电子邮件地址。
  • {itemid} - 替换为用户在存储库中的唯一内部标识。此值不会被视为对人有意义或者可由人阅读。
-D |  --format-date]  自变量
指定应该如何显示日期。单一自变量是一个字符串,此字符串将通过 Java 的 SimpleDateFormatter 进行传递(http://java.sun.com/j2se/1.5.0/docs/api/java/text/SimpleDateFormat.html)。
-f |  --flow-directions] 自变量
只显示传入/传出变更。必须是下列其中一项:
  • “i”- 传入变更
  • “o”- 传出变更
  • “b”- 同时显示传入变更和传出变更
-I |  --include-types] 自变量
只包括所列示类型的项。自变量是一个字符串,该字符串可以包含下列任何字符:
  • “d”- 流向方向。这是最顶部的元素。
  • “c”- 组件。
  • “b”- 基线。
  • “w”- 工作项。
  • “s”- 变更集。
  • “f”- 文件系统变更。

在缺省情况下,将显示除文件系统变更以外的所有类型(即,“dcbws”)。

-p |  --prune] 自变量
从层次结构中除去空节点。值可以是包含下列字符的字符串:
  • “d”- 指示应该除去空的流向方向。
  • “c”- 指示应该除去未变更的组件。

在缺省情况下,不会清除任何内容。

-S |  --Show] 自变量
控制所要显示的选项值/字段。值可以包含下列字符:
  • “c”- 指示应该显示添加者。对于基线和变更集,将显示作者添加者。
  • “d”- 指示应该显示日期。对于变更集,日期将显示为修改时间;对于基线,日期将显示为创建时间。
  • “i”- 指示应该将工作项显示为变更集的子代。如果未包括工作项,那么它们将只显示为变更集描述的组成部分。

在缺省情况下,将显示所有字段。

-w |  --reroot] 自变量
指示应该将工作项节点在显示的层次结构中向上移。值必须是下列其中一项:
  • “r”- 对于根,指示应该将所有项类型显示在某个工作项之下。
  • “d”- 指示应该将工作项显示在流向方向之下,这意味着,所有组件都将显示在工作项之下。
  • “c”- 指示应该将工作项显示在组件之下,这意味着,所有变更集和基线都将显示在组件之下。
  • “b”- 指示应该将工作项显示在基线之下,这意味着,所有变更集都将显示在工作项之下。

在缺省情况下,工作项将显示在变更集之下。

示例

要生成包含最少量额外信息的变更日志,请使用以下命令:

$ scm compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I w -S "" -f i
工作项 60074:允许在 Web UI 中为项目区域和团队区域定义许可权
工作项 62945:设置某种类型的 Jazz Foundation 构建
工作项 63040:TCT031b:Jazz 翻译 - 更多变量
工作项 63053:Web UI 模板导入操作不允许对工作项定制进行变更
工作项 63091:创建变更事件和呈示订阅源时,考虑项目区域语言环境
工作项 63266:在 COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER 文件中发生 CHKPII 错误
工作项 63371:应该重新编写 ProcessFeedRenderer.getProcessAreaChangeDetails 以适应翻译

使用“-I w”将只显示工作项,“-S ''”将防止工作项行包含额外的干扰内容,“-f” i”确保传出变更不会与传入变更混合。
要生成将文件系统变更分组到工作项和变更集之下并提供特定日期格式的变更日志,请发出以下命令:

$ scm -u n -a n compare -r blues ws eSCM-2.0 stream "Source Control 2.0" -I wfs -w d -S d -D "EEE, d MMM yyyy HH:mm:ss Z" -f i
工作项 63266:在 COM.IBM.TEAM.PROCESS.DEFINITIONS.SERVER 文件中发生 CHKPII 错误
  无注释,2008 年 11 月 7 日星期五,16:52:24 -0500
    /com.ibm.team.process.definitions.server/data/agile/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/eclipseway/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/openup/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/scrum/attachments/template.properties
    /com.ibm.team.process.definitions.server/data/simple/attachments/template.properties
工作项 63371:应该重新编写 ProcessFeedRenderer.getProcessAreaChangeDetails 以适应翻译
  处理类别已知但没有不同消息的情况,2008 年 11 月 6 日星期四,16:49:09 -0500
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/ProcessFeedRenderer.java
  合并,2008 年 11 月 6 日星期四,19:50:52 -0500
    /com.ibm.team.process.service/src/com/ibm/team/process/internal/service/messages.properties
工作项 63416:不是已声明的域适配器的可翻译属性的外部化字符串
  无注释,2008 年 11 月 7 日星期五,16:46:56 -0500
    /com.ibm.team.process.ide.ui/plugin.properties
    /com.ibm.team.process.ide.ui/plugin.xml

注意,使用 -w 使工作项成为变更集的父代,使用 -D 来设置日期格式。初始的“-u”和“-a”选项将导致不显示别名和 UUID。

反馈

本资料对您是否有帮助?您可以在 Jazz.net 上提供反馈(需要注册):在论坛中发表意见或者提交错误