p4 describe
概要
チェンジリストおよびそのチェンジリストに含まれるファイルに関する情報を表示します。
構文
p4 [g-opts] describe
[-doptions] [-s -S -f -O]
changelist …
解説
p4 describeは、チェンジリストの詳細を表示します。各チェンジリストでは、出力に、チェンジリスト番号、チェンジリスト作成者、クライアントワークスペース名、チェンジリスト作成日、チェンジリストのコメントが含まれます。
チェンジリストがsubmittedであれば、デフォルトの出力には影響を受けたファイルのリストとそれらのファイルを前のリビジョンと比較した差分が含まれます。デフォルトでは、このコマンドはキーワードを拡張しません。なぜなら、キーワードの違いにより実際の違いが曖昧になる傾向があるからです。
チェンジリストがpendingの場合は、出力にその旨を示すフラグが付き、作業中ファイルのリストが表示されます(ファイルはまだディポにサブミットされていないため、作業中チェンジリストに対する差分は表示されません。)
p4 describeコマンドはチェンジリストがpublicであるかrestrictedであるかに従って出力内容を制限します。restrictedタイプのsubmittedまたはshelvedのチェンジリストは、そのチェンジリストを所有しているか、チェンジリスト内の1つ以上のファイルにlist権限を持っていない限り、出力されません。restrictedタイプのpending(ただし保留解除された)チェンジリストは、その所有者にのみ表示されます。制限付きチェンジリストの表示権限がない場合は、チェンジリストの説明の代わりに"no permission"というメッセージが表示されます。Perforce管理者は-fオプションを使用することにより、この動作をオーバーライドして制限付きチェンジリストを表示することができます。
デフォルトのチェンジリストに対してはp4 describeを実行できません。
p4 describeコマンドは、p4に組み込まれた比較サブルーチンを使用します。環境変数P4DIFFはこのコマンドに全く影響しません。
オプション
|
|
標準的なUNIXの差分オプションの1つで差分ルーチンを実行します。オプションのリストについては、使用上の留意点を参照してください。 |
|
|
制限付きチェンジリストの説明を強制的に表示します。このオプションの使用には |
|
|
チェンジリストの番号がサブミット時に変更されていて、元のチェンジリスト番号しか知らない場合には、 |
|
|
ファイルの差分を含まない短縮された出力を表示します。 |
|
|
指定されたチェンジリストに関する保留されたファイルを、前のディポリビジョンとの差分も含めて表示します。 |
|
|
“グローバルオプション”を参照してください。 |
使用上の留意点
|
ファイル引数にリビジョン指定子を使えるか？ |
ファイル引数にリビジョン範囲を使えるか？ |
最低限必要なアクセスレベル |
|---|---|---|
|
適用外 |
適用外 |
|
p4 describeがサポートしている差分オプションは、つぎのとおりです
|
オプション |
名前 |
|---|---|
|
|
RCS形式。ファイルに対して行われた追加および削除と、関連した行範囲を表示します。 |
|
|
context形式。変更された行番号の範囲と、その周辺 |
|
|
summary形式。追加、削除および変更されたまとまり(チャンク)と行の数を表示します。 |
|
|
unified形式。追加および削除された行を、 |
|
|
差分を発見したときに行末識別(CR/LF)を無視します。 |
|
|
空白文字の変更を無視します。このオプションは |
|
|
空白文字を完全に無視します。このオプションは |