Perforce Command Reference:   [Index] [Prev] [Next]


p4 changes

Synopsis

List submitted and pending changelists

Syntax

p4 [g-opts] changes [-i -l -m maxnum -s status] [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 will be listed. Default changelists are never listed.

The format of each line is

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

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

If you provide file patterns as arguments, the changelists listed are those that affect files matching the patterns. Only submitted changelists will be reported in this instance; pending changes (by definition) have not yet affected any files in the depot.

When the -s status flag is used, only changelists with the provided status (pending or submitted) are listed. You can combine flags and file patterns to substantially limit the changelists that are displayed.

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.

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
-m maxnum List only the highest-numbered maxnum changes.
-s status Limit the list to the changelists with the given status (pending or submitted)
g_opts See global options section.

Usage Notes

Can File Arg Use
Revision Specifier?
Can File Arg
Use Revision Range?
Minimal
Access Level Required
Yes Yes list

Examples

p4 changes -m 5 //depot/fooproj/... Show the last five submitted changelists that included any file under the fooproj directory
p4 changes bar@1998/05/01,1998/06/01 Show any changelists that included file bar, as mapped to the depot through the client view, during the month of May, 1998.

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 Command Reference:   [Index] [Prev] [Next]


Copyright 1999 Perforce Software.
Contact us at [email protected]
Last updated: 09/15/99 (Manual version 99.1.cr.6)