p4 branch

ブランチマッピングとそのビューの生成または編集を行います。

構文

p4 [g-opts] branch [-f] branchspec
p4 [g-opts] branch -d [-f] branchspec
p4 [g-opts] branch -i [-f]
p4 [g-opts] branch [-S stream] -o placeholderForStreamBranchSpecName
p4 [g-opts] branch [-S stream -P parent] -o placeholderForStreamBranchSpecName

説明

p4 branch コマンドを実行すると、2つのファイルセット間のマッピングを作成し、そのマッピングをp4 integrateコマンドで使用することができます。 ブランチビューで、反映元のファイル(fromFiles)と反映先のファイル(toFiles)の間の関係を定義します。 ディポシンタックスでビューの両側を指定します。

ブランチマッピングを作成したら、以下のコマンドを使用してファイルの反映を行うことができます。

p4 integrate -b branchspec

ストリームのブランチ仕様のプレースホルダーに値を指定する

p4 branchコマンドで「placeholderForStreamBranchSpecName」を指定すると、ブランチ仕様に対してストリーム専用の名前が生成されるため、任意の値を使用できるようになります。

ストリームに対する最初のコマンド構文は、以下のように指定します。

p4 [g-opts] branch [-S stream] -o placeholderForStreamBranchSpecName

このコマンドを実行すると、指定したストリームとそのストリームの実際の親ストリームのブランチ仕様が表示されます。

次に、以下のコマンド構文を指定します。

p4 [g-opts] branch [-S stream -P parent] -o placeholderForStreamBranchSpecName

このコマンドを実行すると、streamオプションで指定したストリームが、parentオプションで指定したストリームの子ストリームとして機能します(実際にこのような関係になっているかどうかについては考慮されません)。

詳細については、「ストリームの例」を参照してください。

フォームフィールド

フィールド名	タイプ	説明
Branch:	読み取り専用	コマンドラインで指定されたブランチ名。
Owner:	入力必須	ブランチマッピングの所有者。 デフォルトではブランチを生成したユーザに設定されます。 このフィールドは、[Option:]フィールドがlockedになっていない限り重要ではありません。 指定する所有者は、Helixサーバユーザである必要はありません。 ユーザがまだ存在していないため任意の名前を使用する場合や、ユーザを削除してから仕様を新しいユーザに割り当てるまでのプレースホルダーが必要となる場合があります。
Access:	読み取り専用	ブランチマッピングが最後にアクセスされた日付。
Update:	読み取り専用	ブランチマッピングが最後に変更された日付。
Options:	入力必須	unlocked(デフォルト)またはlockedに設定します。 lockedの場合には、[Owner:]のみがブランチマッピングを修正することができ、そのマッピングはこのフィールドがunlockedに設定されるまで削除することはできません。
Description:	任意入力	ブランチの目的を示す簡単な説明。
View:	入力必須	ディポ内の1つのファイルセット(source files)からディポ内の別のファイルセット(target files)に対するマッピング。 このフィールドにより、ディポ内の特定の場所から別の場所へのマッピングが行われます。このフィールドでクライアントワークスペースを参照することはできません。 例えば、次のようなブランチビューがあるとします。 //depot/main/... //depot/r2.1/... このブランチビューは、//depot/mainのすべてのファイルを//depot/r2.1にマッピングします。

オプション

-d	名前を指定してブランチマッピングを削除します。 ファイルは、この操作による影響を受けません。1つのコードラインから別のコードラインへの、保存されたマッピングのみが削除されます。 通常、このオプションは該当するブランチ仕様を生成したユーザのみが使用できます。
-f	強制オプションです。 -dと組み合わせて使用すると、Helixサーバ管理者が自分が所有者でないブランチを削除することができます。 また、管理者がブランチマッピングの更新日を変更することも可能にします(-fオプションを使用すると、[Update:]フィールドが書き込み可能になります)。
-i	エディタを立ち上げずに標準入力からブランチマッピングを読み取ります。
-o	エディタを立ち上げずに標準出力にブランチマッピングを出力します。
-P parent	指定されたストリームが指定された親ストリームの子ストリームであると仮定して生成されたマッピングを表示します。 -Sオプションを指定する必要があります。 例えば、目的のストリームで新しい親子関係を作成する必要があるかどうかを判断する場合に、この-Pオプションを使用します。
-S stream	指定されたストリームに対して生成されたマッピングを表示します。 このオプションを指定すると、ストリームとその親との間で変更がどのように伝播されるかが分かります。
g-opts	詳細については、「グローバルオプション」を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？	ファイル引数にリビジョン範囲を使えるか？	最低限必要なアクセスレベル
適用外	適用外	open

• ブランチビューで、2つの関連するコードラインの関係を定義します。 例えば、あるプロジェクトの開発ファイルが//depot/project/dev/...に保存されていて、そのプロジェクトのリリース2.0用の関連コードラインを//depot/project/r2.0/...に生成したい場合、ブランチビューを次のように指定します。

  //depot/project/dev/... //depot/project/r2.0/...

  ブランチビューには、複数のマッピングを記述することができます。 ビューを指定する方法については。ビューを参照してください。

• パスまたはファイル名に空白が含まれる場合は、パスを引用符で囲みます。 以下に例を示します。

  //depot/project/dev/... "//depot/project/release 2.0/..."

• ブランチビューからパスを除外すると、ファイルのサブセットがマージされるのを防ぐことができます。 例えば、次のようなビューエントリを指定すると、AssemblyInfo.csというファイルがMAINとRELの間でマージされるのを防ぐことができます。

  -//depot/MAIN/.../AssemblyInfo.cs //depot/REL/.../AssemblyInfo.cs

  同様に、次のように指定すると、対象のディレクトリをまとめてブランチビューから除外することができます。

  -//depot/MAIN/bin/... //depot/REL/bin/...

  ビューを指定する方法については。ビューを参照してください。

• ブランチビューは、p4 diff2 -b branchnamefromFilesという構文により、p4 diff2でも使用することができます。 これは、ブランチビューで定義されたfromFiles対toFilesのパターンに合致するファイルの差分を表示します。

ストリームの例

5dev1ストリームとその実際の親ストリームに対して生成されたマッピングを表示するには、以下のように指定します。 p4 branch -S //depotstream1/5dev1 -o placeholder1

5dev1ストリームをmain5ストリームの子ストリームとして処理するという条件で(実際にこのような関係になっているかどうかについては考慮しない)、5dev1ストリームとmain5ストリームに対して生成されたマッピングを表示するには、以下のように指定します。 p4 branch -S //stream1/5dev1 -P //stream1/main5 -o placeholder2

関連コマンド

既存のブランチマッピングのリストを参照する	p4 branches
1つのファイルセットから別ファイルセットへ変更をコピーする	p4 integrate
2つのコードラインの間の違いを参照する	p4 diff2