p4 changes

Synopsis

Syntax

Description

By default, the format of each line is:

Change num on date by user@client [status] description

Change num on date hh:mm:ss by user@client [status] description

If you provide file patterns as arguments, the changelists listed are those that affect files matching the patterns. Only submitted changelists are reported in this instance; pending changelists (by definition) have not yet affected any files in the depot. (If you try to view pending changelists while specifying a file pattern, you will get an error message.)

Revision specifications and revision ranges can be included in the file patterns. Including a revision range lists all changes that affect files within the range; providing a single revision specifier lists all changes from 1 to the specified revision.

Use the -c client and -u user flags to limit output to only those changelists made from the named client workspace or the named user.

Use the -s status flag to limit output to only those changelists with the provided status (pending or submitted) value.

You can combine flags and file patterns to substantially limit the changelists that are displayed. You can also use the -m max flag to further limit output to max changes.

The command p4 changelists is an alias for p4 changes.

Options

-i	Include changelists that affected files that were integrated with the specified files.
-t	Display the time as well as the date of each change.
-l	List long output, with the full text of each changelist description.
-L	List long output, with the full text of each changelist description truncated at 250 characters.
-c client	List only changes made from the named client workspace.
-m max	List only the highest numbered max changes.
-s status	Limit the list to the changelists with the given status (pending or submitted)
-u user	List only changes made from the named user.
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	list

Examples

p4 changes -m 5 //depot/project/...	Show the last five submitted changelists that include any file under the project directory
p4 changes -m 5 -c eds_elm	Show the last five submitted changelists from client workspace eds_elm.
p4 changes -m 5 -u edk	Show the last five submitted changelists from user edk.
p4 changes file.c@2000/05/01,2000/06/01	Show any changelists that include file file.c, as mapped to the depot through the client view, during the month of May 2000.
p4 changes -m 1 -s submitted	Output a single line showing the changelist number of the last submitted changelist.
p4 changes @2001/04/01,@now	Display all changelists submitted from April 1, 2001 to the present.
p4 changes @2001/04/01	Display all changelists submitted before April 1, 2000.

Related Commands

To submit a pending changelist	p4 submit
To create a new pending changelist	p4 change
To read a detailed report on a single changelist	p4 describe