Previous Table of Contents Index Next
Perforce 2009.1: Command Reference



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#
Usage Notes
Can File Arguments Use
Revision Specifier?
The syntax p4 reviews -c changelist# file... ignores the file arguments entirely.
p4 reviews is an unusual command. It was created to support external daemons, but it does nothing without the Reviews: field of the p4 users form, which has a very specific meaning.
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/ .
Related Commands
 


Previous Table of Contents Index Next

Perforce 2009.1: Command Reference
Copyright 1999-2009 Perforce Software.