创建对象

您可以创建一个对象,并将其添加到与指定对象关联的项目中。如果使用工作区引用表单,那么上下文项目与指定的工作区路径关联。如果使用项目引用规范表单,那么在该规范中指定上下文项目。

当您在非共享项目中创建对象时,其缺省状态为工作。当您在共享项目中创建文件或目录时,如果它不是产品,那么其缺省状态为可视,如果它是产品,那么其缺省状态为共享

在不可写目录中创建对象时,将自动检出一个新目录版本。可检入该目录和新对象,使新对象可供其他用户使用。

如果当前在共享项目中并且当前目录不可修改,那么将检出该目录。该目录将自动与指定的任务关联,并检入为集成状态。您可以通过在初始化文件中将 shared_project_directory_checkin 设置为 FALSE 来禁用自动检入。

关于此任务

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

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

-ce|-commentedit
指定调用缺省文本编辑器来组成和编辑注释。通过该文本编辑器保存的结果将用作最终注释。可以将此选项与 -comment-commentfile 选项结合使用。
-cf|-commentfile file_path
指定使用指定文件的内容作为注释。如果指定了 -comment,那么它将附加到该注释。可以将此选项与 -commentedit 选项结合使用。
new_file_spec
指定要创建的新文件或目录。new_file_spec 必须位于下列其中一个表单中:
  • 工作区引用格式,相对路径以新对象名称结尾,还可选择以版本定界符与版本或冒号与版本结尾。父目录必须引用维护工作区中的受控目录。
    • 项目引用格式,相对路径以新对象名称结尾。该相对路径还可选择以版本定界符与版本或冒号与版本结尾,并位于指定项目中的某个目录下。
    • 文件内容格式,包含工作区引用表单或项目引用表单。

这些表单提供上下文项目和上下文父目录。对象创建在指定上下文项目中的父目录下。new_file_spec 不是常规 file_spec。您无法使用对象引用表单或查询选择集引用表单之类的表单。

如果未指定版本,那么将使用 1 作为缺省版本。

allow_delimiter_in_name 设置为 TRUE 且 new_file_spec 包括单个版本定界符时,该字符串将用作对象的名称。例如,newfile-2 的名称为 newfile-2 且具有缺省版本。对于此设置,如果要创建名为 newfile 且版本为 2 的文件,请指定 new_file_specnewfile 并使用 -version 2。如果 allow_delimiter_in_name 设置为 FALSE,那么 new_file_spec 中的所有版本定界符都会处理为版本定界符,并且您可以指定版本。

-task task_spec
指定与新对象关联的任务。如果用于创建新对象的目录不可修改,那么将自动检出此目录并将其与该任务关联。您可以将 task_spec 设置为单一任务。缺省情况下,新对象和任何自动检出的目录都与当前任务关联。请参阅任务规范以获取详细信息。
-t|-type type
指定新对象的类型。如果不指定类型,将通过扩展名计算缺省值(例如,.c 对象缺省为 csrc 类型)。
-v|-version version
如果指定了此选项,将覆盖在 new_file_spec 中指定的任意版本。此选项主要在 allow_delimiter_in_name 设置为 TRUE 时使用。如果 new_file_spec 包括单个版本定界符,那么该字符串将用作对象的名称。例如,newfile-2 的名称为 newfile-2 且具有缺省版本。对于此设置,如果要创建名为 newfile 且版本为 2 的文件,请指定 new_file_specnewfile 并使用 -version 2。如果 allow_delimiter_in_name 设置为 FALSE,那么 new_file_spec 中的所有版本定界符都会处理为版本定界符,并且您可以指定版本。

示例


反馈