p4 reviews

Synopsis

List all the users who have subscribed to review particular files

Syntax

Description

p4 reviews -c changelist# lists each user who have 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. Users subscribe to review files by providing file patterns in the Review: field in their p4 user form.

If you provide no arguments to p4 reviews, all users who have subscribed to review any files will be listed.

This command is meant for use in external programs that call Perforce.

Options

Usage Notes

• The syntax p4 reviews -c changelist# file ... ignores the file arguments entirely.

OK, haven't you ever done anything you're not proud of?

• p4 reviews is a strange command. It was created to support external daemons, but it is completely useless 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. For example, at Perforce we run a jobs daemon that sends email to any users who've 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've 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