p4 annotate
概要
ファイルの行を、リビジョン番号とともに表示します。
構文
p4 [g-opts
] annotate
[-a -c -i -I -q -t] [-doptions
]
file
[revRange
]
…
解説
p4 annotateは、ファイルのリビジョン(またはリビジョン範囲)に対して、各行が生成されたリビジョン番号を表示します。表示されたリビジョン番号をp4 filelogで調べれば、どのチェンジで誰が、いつ、なぜ変更したのかがわかります。
ファイルのその行が生成されたときのチェンジリスト番号を表示するには、-c
オプションを指定します。
リビジョン番号を指定した場合は、そのリビジョン番号までの行が表示されます。リビジョン範囲を指定した場合は、その範囲に該当する行が表示されます。
デフォルトでは、出力されるファイルの最初の行はヘッダ行となります。
filename
#rev
-action
changenum
(type
)
ここで、
はファイル名とリビジョン指定子です。filename
#rev
action
はファイルが作業状態にされたときの操作で、add
、edit
、delete
、branch
またはintegrate
です。num
はサブミットされたチェンジリスト番号であり、typeはそのリビジョンのファイルタイプです。
ヘッダ行を抑制するには、-q
(quiet)オプションを指定します。
すべての行(削除された行およびすでに最新リビジョンにない行のいずれかまたはその両方を含む)を表示するには、-a
(all)オプションを指定します。
オプション
|
すべての行を表示します。削除された行や、最新リビジョンではもはや存在しない行を含みます。 それぞれの行では、開始および終了リビジョンを含みます。 |
|
各行を、リビジョン番号ではなく、チェンジリスト番号とともに表示します。
|
|
標準的なUNIXの差分オプションの1つで差分ルーチンを実行します。使用上の留意点にあるフラグのリストを参照してください。 |
|
ブランチをまたがってファイル履歴を追跡します。ファイルがブランチ機能により作成された場合、Perforceはブランチポイントに至るまでのリビジョンを含めます。
|
|
ファイルへの反映を追跡します。行がマージによってファイルに挿入された場合、マージの反映元が行を挿入したチェンジリストとして示されます。その反映元自体が反映操作の結果である場合、その反映元が代わりに使用されます。このように反映元が順次追跡されます。
|
|
抑制モードです。それぞれのファイルに対して、ヘッダ行の表示を抑制します。 |
|
p4 annotateが非テキスト(バイナリ)ファイルを表示することを強制します。 |
|
“グローバルオプション”を参照してください。 |
使用上の留意点
ファイル引数にリビジョン指定子を使えるか? |
ファイル引数にリビジョン範囲を使えるか? |
最低限必要なアクセスレベル |
---|---|---|
使用可 |
使用可 |
|
-
p4 annotateの出力は、スクリプト作成などの自動化処理のフォームに適しています。
-
デフォルトでは、p4 annotateは長さが10MBを超えるテキストファイルへの変更を無視します。Perforceスーパーユーザは、構成可能変数
dm.annotate.maxsize
を設定することにより、この制限を書き換えることができます。 -
p4 annotateでサポートされている差分オプションを以下に示します。
オプション
名前
-db
空白についての変更を無視
-dl
行末を無視
-dw
すべての空白を無視
例
p4 annotate file.c |
|
p4 annotate -c file.c |
|
p4 annotate -a file.c |
リビジョン範囲は開始と終了のリビジョン番号を示します。 |
p4 annotate -a -c file.c |
ファイル内に存在する各行の開始および終了チェンジリスト番号を含みます。 |