ファイルをチェックアウトして所有し、書き込み可能にすることができます。
ディレクトリーは、チェックアウトすることができますが、ディレクトリーにファイルを追加したり、ディレクトリーからファイルを移動したりすると、ディレクトリーが自動的にチェックアウトされます。
このタスクについて
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
- ベースライン・プロジェクトとそのメンバーが released の状態にチェックインされている場合に、それらにコメントを付加することを指定します。
-comment オプションは、複数行を含むことができ、円記号でコード化した値を使用することができます。
このオプションは、-commentedit および -commentfile と共に使用できます。-commentedit オプションを使用すると、コメントはデフォルトのテキスト・エディターに表示されます。
- -ce|-commentedit
- コメントの作成や編集でデフォルトのテキスト・エディターが開始されるよう指定します。このテキスト・エディターで保存された結果は最終コメントとして使用されます。このオプションは、-comment および -commentfile オプションと共に使用できます。
- -cf|-commentfile file_path
- 指定したファイルの内容をコメントとして使用するよう指定します。
-comment を指定している場合、指定したファイルの内容が該当のコメントに追加されます。このオプションは、-commentedit オプションと共に使用できます。
- file_spec
- チェックアウトするファイルまたはディレクトリーを指定します。ワークエリア参照形式またはプロジェクト参照形式を使用してオブジェクトを指定し、チェックアウト用のコンテキスト・プロジェクトを指定する必要があります。詳しくは、『フォルダー仕様』を参照してください。
- -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」バージョン) も自分のプロジェクトで使用されます。
注: 書き込み不可ディレクトリーの新規オブジェクト名にチェックアウトすると、新規ディレクトリー・バージョンが自動的にチェックアウトされます。
注: 共有プロジェクトに参加しており、カレント・ディレクトリーが書き込み不可の場合、ディレクトリーは自動的にチェックアウトされて、デフォルトの (または指定された) タスクに関連付けられます。このディレクトリーは次に
integrate 状態にチェックインされます。
この機能は、初期化ファイルで
shared_project_directory_checkin を
FALSE に設定することによって無効にすることができます。
- -task task_spec
- 新しくチェックアウトしたオブジェクトを関連付けるタスクを指定します。カレント・タスクが設定されており、別のタスクを指定しない場合、チェックアウトするオブジェクトは自動的にカレント・タスクに関連付けられます。詳しくは、『カレント・タスクの設定またはクリア』を参照してください。
task_spec は単一のタスクに設定できます。詳しくは、『タスク仕様』を参照してください。
例
- main.c のバージョン 1 からバージョン patch1 をチェックアウトします (main.c のバージョン 3 はカレント・ディレクトリーにあります)。
ccm co -c "patch1: fix symbol table bug" -to
patch1 main.c-1
- 現在バージョン 4 になっている utils¥tools (Windowsの場合) または utils/tools (UNIX の場合) ディレクトリーをチェックアウトします。
Windows:
>
ccm co -c "added new files" c:¥users¥john¥ccm_wa¥test_db¥projA-3¥utils¥tools
UNIX:
$ ccm
co -c "added new files" ~/ccm_wa/test_db/projA-3/utils/tools
- コメントを設定し、チェックアウトするオブジェクト・バージョンにタスクを関連付けます。
ccm co -c
"comment string" -task task_number object_name1 object_name2