p4 changes
サブミットされたチェンジリストと作業中のチェンジリストのリストを出力します。
p4
changelists
コマンドはp4
changes
と同等に機能します。
構文
p4 [g-opts] changes [-i -t -l -L -f] [-c client] [ -e changelist#][-m max][-r][-s status] [-u user | --me] [[FileSpec][revSpec]]
説明
p4 changes
により、サブミットされたチェンジリストと作業中のチェンジリストのリストを表示することができます。 引数を指定せずにp4 changes
を実行すると、すべての番号付きチェンジリストが表示されます。 (デフォルトのチェンジリストは表示されません。)
デフォルトでは、各行の形式は次のとおりです。
Change num on date by user@client [status] description
-t
オプションを使用してそれぞれのチェンジリストの時刻を表示する場合、各行の形式は次のようになります。
Change num on datehh:mm:ss by user@client [status] description
status
の値は、そのチェンジリストがpending
またはshelved
の場合にのみ表示されます。 descriptionは、最初の31字に制限されますが、-L
オプションを指定すると最初の250文字、-l
オプションを指定すると全テキストが表示されます。
ファイルパターンを引数として指定すると、そのパターンに一致するファイルに影響を及ぼすsubmitted
またはpending
のチェンジリストのリストが表示されます。
ファイルパターンには、リビジョン指定子およびリビジョン範囲を含めることができます。
- リビジョン範囲内のすべてのファイルのリストを取得するには、リビジョン範囲を含めます。 例: p4 jobs //...#20,52
- リビジョン
1
から指定したリビジョンに含まれるすべての変更のリストを取得するには、単一のリビジョン指定子を含めます。 例: p4 jobs //...#20 - 指定したクライアントワークスペースまたはユーザによって作成されたチェンジリストのみに出力を制限するには、
-c client
または-u user
オプションを使用します。 - 指定した
status
値(pending
、shelved
、またはsubmitted
)のチェンジリストのみに出力を制限するには、-s status
オプションを使用します。 - 指定したチェンジリスト番号以上の変更のみに出力を制限するには、
-e changelist#
オプションを使用します。
分散環境において、エッジサーバで作業中または保留状態の変更は、その他のサーバではp4 changes
コマンドにより表示されます。
管理者は、-f
オプションを使用して制限付きのチェンジリストを表示することができます。
オプションとファイルパターンを組み合わせることにより、表示されるチェンジリストを制限することができます。
-m
max
オプションを使用して、max
オプションで指定された件数の変更のみを出力することもできます。
p4 changes -m 5と指定すると、最新の変更が5件表示されます。
表示順序を逆にして、古い変更から順に表示する場合は、-r
オプションを指定します。
p4 changes -r -m 5と指定すると、最も古い変更が5件表示されます。
グローバルオプションの「-u
」(グローバルオプションを参照)の動作は、「p4 changes -u
」コマンドで使用される「-u」オプションの動作とは異なります。
$ p4 -u bruno changes -u gale
上記の「p4 -u bruno
」の部分では、現在のユーザを「bruno」に変更するためのグローバルオプションが使用され、「-u gale
」の部分では、「gale」というユーザが行った変更のリストを表示するためのグローバルオプションが使用されています。
オプション
|
指定したクライアントワークスペースによって行われた変更のみを一覧表示します。 |
|
制限付きの変更を表示します( |
|
指定したファイルに反映されたファイルに影響を及ぼしたチェンジリストを含めます。 |
|
各チェンジリストの説明のテキストをすべて含めて、長い出力形式で一覧表示します。 |
|
各チェンジリストの説明を250文字で切り捨て、長い出力形式で一覧表示します。 |
|
一番大きい番号から |
-r
|
リストの順番を逆にして、最も新しいものが先頭ではなく、最も古いものを先頭にします。 |
|
チェンジリストに対するリストを、指定の状態( |
|
各変更の日付に加えて時刻も表示します。 |
|
指定したユーザによって行われた変更のみを一覧表示します。 |
|
-u $P4USERと同義 |
|
詳しくは、「グローバルオプション」を参照してください |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? | ファイル引数にリビジョン範囲を使えるか? | 最低限必要なアクセスレベル |
---|---|---|
使用可 |
使用可 |
|
p4 changes
が複数のファイル引数を伴って呼び出されると、各引数に影響するチェンジリストの集合が個別に評価されます。 最後の出力は結合もソートもされません。 その効果はファイル引数ごとに1回ずつ、p4 changes
を複数回呼び出したときと同じになります。- ファイルが指定されていない場合、
p4 changes
は変更がpublicであるかrestrictedであるかに従って出力内容を制限します。 restrictedタイプのsubmitted
またはshelved
の変更は、その変更を所有しているか、変更の内の1つ以上のファイルにlist
権限を持っていない限り、出力されません。 restrictedタイプのpending
(ただし保留解除された)変更は、その変更の所有者にのみ表示されます。 - p4 changes myfile#haveを実行すると、計算フェーズ中は、ロックされていないdb.haveテーブルへのアクセスが実行されます。
例
|
ディレクトリ |
|
クライアントワークスペース |
|
ユーザ |
|
クライアントビューを介してディポへマッピングされた、ファイル |
|
最新のサブミット済みチェンジリストのチェンジリスト番号を示す1行を出力します。 |
|
2011年4月1日から現在までにサブミットされたチェンジリストをすべて表示します。 |
|
2011年4月1日よりも前にサブミットされたチェンジリストをすべて表示します。 |
p4 changes -r -m 1 //depot/project/branch/...
|
指定されたブランチに最初の変更を表示します。 |
関連コマンド
作業中チェンジリストをサブミットする |
|
新しい作業中チェンジリストを生成する |
|
特定のチェンジリストに関する詳細なレポートを読み込む |