您可以创建一个对象,并将其添加到与指定对象关联的项目中。如果使用工作区引用表单,那么上下文项目与指定的工作区路径关联。如果使用项目引用规范表单,那么在该规范中指定上下文项目。
当您在非共享项目中创建对象时,其缺省状态为工作。当您在共享项目中创建文件或目录时,如果它不是产品,那么其缺省状态为可视,如果它是产品,那么其缺省状态为共享。
在不可写目录中创建对象时,将自动检出一个新目录版本。可检入该目录和新对象,使新对象可供其他用户使用。
如果当前在共享项目中并且当前目录不可修改,那么将检出该目录。该目录将自动与指定的任务关联,并检入为集成状态。您可以通过在初始化文件中将 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_spec 为 newfile 并使用 -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_spec 为 newfile 并使用 -version 2。如果 allow_delimiter_in_name 设置为 FALSE,那么 new_file_spec 中的所有版本定界符都会处理为版本定界符,并且您可以指定版本。
示例
- 在 Windows 上的 utils\sym_tool 目录中创建名为 sort.c 的 C 源对象。
ccm create -type csrc utils\sym_tool\sort.c
- 在 UNIX 上,在 utils/sym_tool 目录中创建名称为 sort.c 的 C 源对象。
ccm create -type csrc utils/sym_tool/sort.c
- 在当前目录下创建名为 testcase 的目录对象。
ccm create -t dir
testcase