p4 describe

Provides information about changelists and the changelists' files.


p4 [g-opts] describe [-doptions] [-f -I -m -O -s -S] changelist ...


p4 describe displays the details of one or more changelists. For each changelist, the output includes the changelist number, the changelist creator, the client workspace name, the date the changelist was created, and the changelist description.

If a changelist has been submitted, the default output also includes a list of affected files and the diffs of those files relative to the previous revision. By default, this command does not perform Keyword Expansion because keyword differences tend to obscure real differences.

If a changelist is pending, it is flagged as such in the output, and the list of open files is shown.

Diffs for pending changelists are not displayed because the files have yet to be submitted to the depot.

The p4 describe command limits its report depending on whether or not a changelist is public or restricted. Restricted submitted or shelved changes are not reported unless you either own the change or have list permission for at least one file in the change. Restricted pending (but unshelved) changes are visible only to the change owner. If you do not have permission to view a restricted changelist, the message "no permission" is displayed in place of a changelist description. Administrators can override this behavior and view restricted changelists by using the -f option.

You cannot run p4 describe on the default changelist.

The p4 describe command uses p4's built-in diff subroutine. The P4DIFF variable has no effect on this command.



Runs the diff routine with one of a subset of the standard UNIX diff options. See Usage Notes for an option listing.


Force the display of descriptions for restricted changelists. This option requires admin permission.


Specifies that the changelist number is the Identity field of a changelist.


Limits files to the first max number of files. The following example alphabetically lists (and diffs) two files affected by changelist 765 and two files affected by changelist 987: p4 describe -m 2 765 987


If a changelist was renumbered on submit, and you know only the original changelist number, use -O and the original changelist number to describe the changelist.


Display a shortened output that excludes the diffs of the files.


Display the names of files shelved for the specified changelist, including the diff of each file against its previous depot revision.


See Global Options.

Usage Notes

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



list for p4 describe -s

The diff options supported by p4 describe are:

Option Name


RCS output format, showing additions and deletions made to the file and associated line ranges.


context output format, showing line number ranges and num lines of context around the changes.


summary output format, showing only the number of chunks and lines added, deleted, or changed.


unified output format, showing added and deleted lines with num lines of context, in a form compatible with the patch(1) utility.


ignore line-ending (CR/LF) convention when finding diffs


ignore changes made within whitespace; this option implies -dl.


ignore whitespace altogether; this option implies -dl.

Related Commands

To view a list of changelists

p4 changes

To view a list of all opened files

p4 opened

To compare any two depot file revisions

p4 diff2

To compare a changed file in the client to a depot file revision

p4 diff