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.
-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.

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.