p4 annotate

Synopsis

Syntax

Description

To display the changelist number associated with each line of the file, use the -c option.

If you specify a revision number, only revisions up to that revision number are displayed. If you specify a revision range, only revisions within that range are displayed.

By default, the first line of output for each file is a header line of the form:

filename#rev - action change num (type)

To suppress the header line, use the -q (quiet) option.

To print all lines (including lines from deleted files and/or lines no longer present at the head revision), use the -a (all) option.

Options

-a	All lines, including deleted lines and lines no longer present at the head revision, are included. Each line includes a starting and ending revision.
-c	Display the changelist number, rather than the revision number, associated with each line. If you use the -a option and the -c option together, each line includes a starting and ending changelist number.
-dflags	Runs the diff routine with one of a subset of the standard UNIX diff flags. See the Usage Notes below for a listing of these flags.
-i	Follow file history across branches. If a file was created by branching, Perforce includes revisions up to the branch point. The use of -i option implies the -c option.
-q	Quiet mode; suppress the one-line header for each file.
g-opts	See the Global Options section.

Usage Notes

Can File Arguments Use Revision Specifier?	Can File Arguments Use Revision Range?	Minimal Access Level Required
Yes	Yes	read

• The output of p4 annotate is highly amenable to scripting or other forms of automated processing.

• The diff flags supported by p4 annotate are:

  Flag	Name
  -db	ignore changes made within whitespace
  -dw	ignore whitespace altogether

Examples

p4 annotate file.c	Print all lines of file.c, each line preceded by the revision that introduced that line into the file.
p4 annotate -c file.c	Print all lines of file.c, each line preceded by the changelist number that introduced that line into the file.
p4 annotate -a file.c	Print all lines of file.c, including deleted lines, each line preceded by a revision range. The starting and ending revision for each line are included.
p4 annotate -a -c file.c	Print all lines of file.c, including deleted lines, each line preceded by a range of changelists. The starting and ending changelists for which each line exists in the file are included.