p4 reviews
List the users who are subscribed to review files.
Syntax
p4 reviews [-C client] [-c changelist# | file ...]
Description
The p4 reviews
command is intended for use in
external programs that call
Helix Core Server.
Users subscribe to review files by providing file patterns in the
Reviews
field in their p4
user
form.
See the Examples below.
Notification of changes
Some users might want to be made aware of when certain files are changed.
-
To subscribe to review files, issue the p4 user command and edit the
Reviews
field to include the path to the files to be watched. -
Swarm must also be configured for notifications of committed changes.
Options
|
Limits the files to those opened in the specified client workspace. When used with the |
|
Limits the files to the submitted changelist. |
|
See Global options. |
Usage notes
Can File Arguments Use Revision Specifier? | Can File Arguments Use Revision Range? | Minimal Access Level Required |
---|---|---|
No |
No |
|
- 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 thep4 user
form, which has a very specific meaning.It is possible to enter values in the
Reviews
field that mean something originally unintended by Helix Core Server 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 when a new job is submitted. Because there is nothing built into Helix Core Server that allows users to subscribe to review jobs, we co-opt a single line of theReviews
field: Helix Core Server sends a job email to any users who have subscribed to review the non-existent path//depot/jobs/
. -
The command returns no output if there is no object to report on.
Examples
|
Lists all users who have subscribed to review any files. |
p4 reviews -c change |
Lists each user who has
subscribed to review any of the files included in the submitted changelist
|
|
Lists the users who have subscribed to review any files that match the file patterns provided as arguments. |
Related commands
To subscribe to review files |
|
List all submitted changelists above a provided changelist number |
|
To set or read the value of a Helix Core Server counter |
|
To read full information about a particular changelist |