检出对象

您可以检出文件以拥有这些文件并使其可写。 您可以检出目录,但是在向目录中添加文件或从中移动文件时会自动检出这些目录。

关于此任务

ccm co|checkout [-task task_spec] [-t|-to version|file_spec] 
                [-c|-comment comment_string] [-ce|-commentedit] 
                [-cf|-commentfile file_path] file_spec...
-c|-comment comment
指定将基线项目及其成员检入为已发布状态时,向它们附加注释。-comment 选项可包含多行,并接受反斜杠编码的值。

可以将此选项与 -commentedit-commentfile 结合使用。如果使用 -commentedit 选项,注释将在缺省文本编辑器中显示。

-ce|-commentedit
指定启动缺省文本编辑器来组成和编辑注释。通过该文本编辑器保存的结果将用作最终注释。可以将此选项与 -comment-commentfile 选项结合使用。
-cf|-commentfile file_path
指定使用指定文件的内容作为注释。如果指定了 -comment,那么它将附加到该注释。可以将此选项与 -commentedit 选项结合使用。
file_spec
指定要检出的文件或目录。必须使用Work area reference formProject reference form来指定对象,从而为检出提供上下文项目。请参阅Folder specification以获取详细信息。
-t|-to version|file_spec
指定版本并更改新的非项目对象的名称,或者指定新项目或项目层次结构的版本。

缺省情况下,-to 参数解释为新版本。例如,运行以下命令:

ccm co main.c -to bar

新对象版本为 main.c-bar

要更改名称,必须在目标参数中包含对象名和版本。例如,运行以下命令:

ccm co main.c -to bar.c-1

新对象版本为 bar.c-1

如果检出项目,那么仅指定版本。如果检出项目层次结构,那么新版本用于项目及其子项目。使用 -versions 选项可将新版本映射到层次结构中项目的旧版本。-to-versions 选项互斥。此外,如果不指定 -to-version 选项,那么会使用内置算法自动计算缺省的下一个版本。

如果检出当前项目中所使用的对象的某个版本,那么新版本(“to”版本)也会在项目中使用。

注: 当您检出不可写目录中的新对象名时,将会自动检出新目录版本。
注: 如果是共享项目并且当前目录不可写,那么该目录会检出并自动与缺省(或指定的)任务关联。然后,目录会检入到集成状态。可以通过在初始化文件中将 shared_project_directory_checkin 设置为 FALSE 来禁用此功能。
-task task_spec
指定要与新检出对象关联的任务。如果设置了当前任务,并且未指定其他任务,那么正在检出的对象自动与当前任务关联。请参阅设置或清除当前任务以获取详细信息。 可以将 task_spec 设置为单个任务。请参阅Task specification以获取详细信息。

示例


反馈