Perforce 2003.1 Command Reference
<< Previous Chapter
p4 review
Table of Contents
Index
Perforce on the Web
Next Chapter >>
p4 set

p4 reviews

Synopsis

List all the users who have subscribed to review particular files.

Syntax

p4 [g-opts] reviews [-c changelist#] [file...]

Description

The p4 reviews command is intended for use in external programs that call Perforce.

Users subscribe to review files by providing file patterns in the Reviews: field in their p4 user form.

p4 reviews -c changelist# lists each user who has subscribed to review any files included in the submitted changelist changelist#. The alternate form, (p4 reviews file...), lists the users who have subscribed to review any files that match the file patterns provided as arguments. If you provide no arguments to p4 reviews, all users who have subscribed to review any files are listed.

Options

-c changelist#

List all users who have subscribed to reviews any files included in submitted changelist changelist#.

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

No

No

list

It is possible to enter values in the Reviews: field that mean something originally unintended by Perforce in order to create more generalized daemons. At Perforce, for example, we run a jobs daemon that sends email to any users who have subscribed to review jobs anytime a new job is submitted. Since there's nothing built into Perforce that allows users to subscribe to review jobs, we co-opt a single line of the Reviews: field: Perforce sends job email to any users who have subscribed to review the non-existent path //depot/jobs/... .

Thus, it is possible to use p4 reviews for purposes it wasn't meant to support, but you must be somewhat clever about it.

Related Commands

To subscribe to review files

p4 user

List all submitted changelists above a provided changelist number

p4 review

To set or read the value of a Perforce counter

p4 counter

To read full information about a particular changelist

p4 describe


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