p4 populate

概要

あるファイル集合のブランチ処理を1回の操作で行います。

構文


p4 [g-opts] populate [-d description] [-f -n -o] [-m max] fromFile[rev] toFile
p4 [g-opts] populate [-d description] [-f -n -o] [-m max] -b branch [-r] [toFile[rev]]
p4 [g-opts] populate [-d description] [-f -n -o] [-m max] -b branch -s fromFile[rev]
                     [toFile]
p4 [g-opts] populate [-d description] [-f -n -o] [-m max] -S stream [-P parent] [-r]
                     [toFile[rev]]

解説

p4 populateコマンドは、あるファイル集合(反映元)をディポ内の別の場所(反映先)へと1回の操作でブランチします。新しいファイルがただちに作成され、p4 submitコマンドやクライアントワークスペースを必要としません。

p4 populateコマンドの実行により、change-submitトリガが有効になり、関係者はサブミット前に検証を行うことが可能になります。内容変更トリガでは、説明を検証できるように一時保留変更レコードが作成されますが、p4 populateでブランチされたファイルは作業状態になっていないため、p4 openedからchange-submitトリガに結果が返されることはありません。説明が与えられていない場合、説明としてコマンドライン引数を使用します。

change-contentステージ完了後にp4 populateコマンドが失敗した場合、change-failトリガが有効になります。

オプション

-b branch

ユーザ定義のbranch仕様のビューを使用します。反映元がブランチビューの左側、反映先がブランチビューの右側になります。

-d description

自動的にサブミットされるチェンジリストに対して説明を指定します。説明が与えられていない場合、説明としてコマンドライン引数を使用します。

-f

削除されたファイルを強制的に反映先にブランチします。(デフォルトでは、削除されたファイルは存在しないものとして扱われ、スキップされます。)

-m max

操作対象のファイルをmax個に制限します。

-n

実際には何も行わずに、操作の結果をプレビューします。

-o

p4 populateコマンドによって作成されたファイルのリストを表示します。

-P parent

-S streamとともに使用すると、ストリームの実際の親ではない親ストリームを指定します。

-r

反映処理の方向を逆にします(反映元から反映先へではなく、反映先から反映元へ)

-s

-b branchとともに使用すると、fromFileを反映元として扱い、ユーザ定義のブランチビューの両側を反映先として扱います。(任意指定のtoFile引数を使用すると、反映先ファイル集合の範囲がさらに限定されます。)-sの使用時は、-rオプションは無視されます。

-S stream

ストリームのビューを使用します。反映元はストリーム自体であり、反映先はストリームの親です。

g-opts

「“グローバルオプション”」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？

ファイル引数にリビジョン範囲を使えるか？

最低限必要なアクセスレベル

使用可

使用不可

open