p4 describe

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.

`-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`

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`

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

p4 describe

Synopsis

Syntax

Description

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

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

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`

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`