p4 annotate

概要

ファイルの行を、リビジョン番号とともに表示します。

構文

p4 [g-opts] annotate [-a -c -i -I -q -t] [-doptions] file[revRange] …

解説

p4 annotateは、ファイルのリビジョン(またはリビジョン範囲)に対して、各行が生成されたリビジョン番号を表示します。表示されたリビジョン番号をp4 filelogで調べれば、どのチェンジで誰が、いつ、なぜ変更したのかがわかります。

ファイルのその行が生成されたときのチェンジリスト番号を表示するには、-cオプションを指定します。

リビジョン番号を指定した場合は、そのリビジョン番号までの行が表示されます。リビジョン範囲を指定した場合は、その範囲に該当する行が表示されます。

デフォルトでは、出力されるファイルの最初の行はヘッダ行となります。 

filename#rev - action change num (type)

ここで、filename#revはファイル名とリビジョン指定子です。actionはファイルが作業状態にされたときの操作で、add、edit、delete、branchまたはintegrateです。numはサブミットされたチェンジリスト番号であり、typeはそのリビジョンのファイルタイプです。

ヘッダ行を抑制するには、-q (quiet)オプションを指定します。

すべての行(削除された行およびすでに最新リビジョンにない行のいずれかまたはその両方を含む)を表示するには、-a (all)オプションを指定します。

オプション

-a

すべての行を表示します。削除された行や、最新リビジョンではもはや存在しない行を含みます。

それぞれの行では、開始および終了リビジョンを含みます。

-c

各行を、リビジョン番号ではなく、チェンジリスト番号とともに表示します。

-aオプションと-cオプションをともに指定すると、それぞれの行に開始および終了チェンジリスト番号が含まれます。

-doptions

標準的なUNIXの差分オプションの1つで差分ルーチンを実行します。使用上の留意点にあるフラグのリストを参照してください。

-i

ブランチをまたがってファイル履歴を追跡します。ファイルがブランチ機能により作成された場合、Perforceはブランチポイントに至るまでのリビジョンを含めます。

-iオプションは-cオプションを暗黙的に指定します。-iオプションと-Iオプションを組み合わせることはできません。

-I

ファイルへの反映を追跡します。行がマージによってファイルに挿入された場合、マージの反映元が行を挿入したチェンジリストとして示されます。その反映元自体が反映操作の結果である場合、その反映元が代わりに使用されます。このように反映元が順次追跡されます。

-Iオプションは-cオプションを暗黙的に指定します。-Iオプションと-iオプションを組み合わせることはできません。

-q

抑制モードです。それぞれのファイルに対して、ヘッダ行の表示を抑制します。

-t

p4 annotateが非テキスト(バイナリ)ファイルを表示することを強制します。

g-opts

“グローバルオプション”を参照してください。

使用上の留意点

ファイル引数にリビジョン指定子を使えるか？

ファイル引数にリビジョン範囲を使えるか？

最低限必要なアクセスレベル

使用可

使用可

read

  • p4 annotateの出力は、スクリプト作成などの自動化処理のフォームに適しています。

  • デフォルトでは、p4 annotateは長さが10MBを超えるテキストファイルへの変更を無視します。Perforceスーパーユーザは、構成可能変数dm.annotate.maxsizeを設定することにより、この制限を書き換えることができます。

  • p4 annotateでサポートされている差分オプションを以下に示します。

    オプション

    名前

    -db

    空白についての変更を無視

    -dl

    行末を無視

    -dw

    すべての空白を無視

例

p4 annotate file.c

file.cのすべての行を表示し、先頭にはその行が記述されたリビジョン番号が示されます。

p4 annotate -c file.c

file.cのすべての行を表示し、先頭にはその行が記述されたチェンジリスト番号が示されます。

p4 annotate -a file.c

file.cのすべての行(削除された行も含む)を表示し、各行はリビジョン範囲で始まります。

リビジョン範囲は開始と終了のリビジョン番号を示します。

p4 annotate -a -c file.c

file.cのすべての行(削除された行も含む)を表示し、各行はチェンジリストの範囲で始まります。

ファイル内に存在する各行の開始および終了チェンジリスト番号を含みます。