Previous Table of Contents Index Next
Perforce 2012.1: Command Reference



p4 describe
Synopsis
Provides information about changelists and the changelists' files.
Syntax
p4 [g-opts] describe [ -dflags -s -S -f -O ] changelist#...
Description
p4 describe displays the details of one or more changelists. For each changelist, the output includes the changelist's number, the changelist's creator, the client workspace name, the date the changelist was created, and the changelist's 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.
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 server.)
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. Perforce administrators can override this behavior and view restricted changelists by using the -f flag.
You cannot run p4 describe on the default changelist.
While running p4 describe, the server uses Perforce's built-in client-side diff subroutine. The P4DIFF variable has no effect on this command.
Options
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 files shelved for the specified changelist, including diffs of those files against their previous depot revision.
-dflags
Runs the diff routine with one of a subset of the standard UNIX diff flags. See the Usage Notes below for a flag listing.
Usage Notes
Can File Arguments Use
Revision Specifier?
read;
list for p4 describe -s
The diff flags supported by p4 describe are:
RCS output format, showing additions and deletions made to the file and associated line ranges.
-dc[num]
context output format, showing line number ranges and num lines of context around the changes.
-du[num]
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
Related Commands
 


Previous Table of Contents Index Next

Perforce 2012.1: Command Reference
Copyright 1999-2012 Perforce Software.