p4 filelog
概要
ファイルのリビジョンに関する詳細情報を表示します。
構文
p4 [g-opts
] filelog
[-c change
] [-h -i -l -L -t -p -s]
[-m max
]
file
[revRange
]
解説
p4 filelogは、引数として指定されたファイルの各リビジョンの詳細を出力します。少なくとも1つのファイルまたはファイルパターンが引数として指定されなければなりません。ファイル指定にリビジョン範囲が含まれている場合、指定されたリビジョンのみが表示されます。
デフォルトでは、出力は日付の逆順で1リビジョンにつき1行で構成されます。各行のフォーマットは次のようになります。
... #rev
changechnum
action
ondate
byuser
@client
(type
) 'description
'
ここで、
-
rev
はリビジョン番号です。 -
chnum
はサブミットされたチェンジリストの番号です。 -
action
はファイルが作業状態にされた目的、すなわちadd
、edit
、delete
、branch
、import
、またはintegrate
です。アクションが
import
(リモートディポからの反映操作)またはintegrate
の場合、次のようなフォーマットで2行目の記述が表示されます。... #
integration-action
partner-file
反映操作の詳細については、p4 integratedを参照してください。
-
date
はサブミットの日付(デフォルト)か、日時(-t
オプション指定時)です。 -
user
はそのリビジョンをサブミットしたユーザの名前です。 -
client
はそのリビジョンをサブミットしたクライアントワークスペースの名前です。 -
type
は与えられたリビジョンにおけるファイルのタイプです。 -
description
は対応するチェンジリストのコメントの最初の30字です。-l
オプションを使用した場合、description
は、チェンジリストをサブミットしたときに入力した完全なチェンジリストのコメントです。-L
オプションを使用した場合、チェンジリストのコメントは250文字で切り捨てられます。
オプション
|
指定されたチェンジリスト番号でサブミットされたファイルのみを表示します。 |
|
ファイル名の履歴の代わりに、ファイル内容の履歴を表示します。リスト表示されるリビジョンには、特定のリビジョンへ(p4 integrateおよびp4 resolve -atを使用して)ブランチまたはコピーされた、他のファイルのリビジョンが含まれます。コピーまたはブランチにより置き換えられたリビジョンは、たとえそれらが指定されたリビジョンの履歴にある場合でも表示されません。 |
|
ブランチにまたがるファイルの履歴をたどります。反映によって(p4
integrate)生成されたファイルであれば、Perforceはそのファイルのリビジョンの説明を表示し、そのブランチ元ファイルのリビジョンを(元ファイルのブランチポイントまで)表示します。リネーム(p4 move)によって継承されたファイル履歴は、 |
|
各チェンジリストの完全な説明を、長い出力形式でリスト表示します。 |
|
各チェンジリストの完全な説明を250文字で切り捨て、長い出力形式でリスト表示します。 |
|
各ファイル出力の最初の |
|
|
|
重要性の低い反映を無視し、簡略化した形式で表示します(例えば、別の場所に「ブランチ」または「コピー」するなどの反映は表示されません)。 |
|
日付と同様に時刻も表示します。 |
|
「“グローバルオプション”」を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
使用可 |
使用不可 |
|
-
p4 filelogの出力は、指定範囲の広いファイル引数で呼び出されると、かなり大量になることがあるため(例えば、p4 filelog //depot/...ではディポのすべてのファイルのリビジョン履歴がリストされる)、p4 filelogコマンドの出力はp4 groupによって設定される
maxresults
の制限を受けることがあります。 -
-i
オプションと-m
オプションの両方が付いていて、ファイルの最新リビジョンからmaxrev
maxrev
の数のリビジョンの範囲内でブランチ生成が行われている場合は、そのブランチポイントからさらにmaxrev
の数だけリビジョンを逆上り、その間のリビジョンも表示されます。p4 filelog -iは、どのサイトでも十分となるように、最新のリビジョンから50階層の深さまでブランチを追跡します。 -
一時オブジェクトファイル(ファイルタイプ修飾子が
+S
n
)の古いリビジョンは、動作の部分にpurge
と表示されます。
例
p4 filelog //depot/proj1/... |
ディポの |
p4 filelog file1.c@100,@120 |
チェンジリスト100から120までの |
p4 filelog file1.c#have,#head |
|
p4 filelog file1.c file1.h |
ローカルの現在の作業ディレクトリにあるファイル |