Perforce 2002.1 Command Reference
<< Previous Chapter
p4 change
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 client

p4 changes


Synopsis

List submitted and pending changelists.

Syntax

p4 [g-opts] changes [-i -l -c client -m maxnum -s status -u user] [file...]

Description

Use p4 changes to view a list of submitted and pending changelists. When you use p4 changes without any arguments, all numbered changelists are listed. (The default changelist is never listed.)

The format of each line is:

The status value appears only if the changelist is pending. The description is limited to the first 31 characters unless you provide the -l (long) flag.

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.

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. Additionally, you can use the -m maxnum flag to further limit output to maxnum changes.

Options

-i

Include changelists that affected files that were integrated with the specified files.

-l

Provide long output that includes the full descriptions of each changelist.

-c client

List only changes made from the named client workspace.

-m maxnum

List only the highest numbered maxnum 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


Perforce 2002.1 Command Reference
<< Previous Chapter
p4 change
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 client
Please send comments and questions about this manual to [email protected].
Copyright 1999-2002 Perforce Software. All rights reserved.
Last updated: 04/03/02