Perforce 2008.1 Command Reference
<< Previous Chapter
p4 depots
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 diff

p4 describe

Synopsis

Provides information about changelists and the changelists' files.

Syntax

p4 [g-opts] describe [ -dflag -s ] 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.)

You cannot run p4 describe on the default changelist.

While running p4 describe, the server uses Perforce's internal diff subroutine. The P4DIFF variable has no effect on this command.

Options

-s

Display a shortened output that excludes the files' diffs.

-dflag

Runs the diff routine with one of a subset of the standard UNIX diff flags. See the Usage Notes below for a flag listing.

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

N/A

N/A

read;
list for p4 describe -s

The diff flags supported by p4 describe are:

Flag
Meaning

-dn

RCS

-dc

context

-ds

summary

-du

unified

-db

ignore changes made within whitespace

-dw

ignore whitespace altogether

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


Perforce 2008.1 Command Reference
<< Previous Chapter
p4 depots
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 diff
Please send comments and questions about this manual to [email protected].
Copyright 1999-2008 Perforce Software. All rights reserved.
Last updated: 07/08/08