README
¶
golang.org/x/build/cmd/cl
CL prints a list of open Go code reviews (also known as change lists, or CLs).
Documentation
¶
Overview ¶
CL prints a list of open Go code reviews (also known as change lists, or CLs).
Usage:
cl [-closed] [-dnr] [-r] [-url] [-cl 12345] [-project build]
CL searches Gerrit for CLs matching the query and then prints a line for each CL that is waiting for review (as opposed to waiting for revisions by the author).
The output line looks like:
CL 9225 0/ 2d go rsc austin* cmd/internal/gc: emit write barrier
From left to right, the columns show the CL number, the number of days the CL has been in the current waiting state (waiting for author or waiting for review), the number of days since the CL was created, the project name ("go" or the name of a subrepository), the author, the reviewer, and the subject. If the CL is waiting for revisions by the author, the author column has an asterisk. If the CL is waiting for a reviewer, the reviewer column has an asterisk. If the CL has been reviewed by the reviewer, the reviewer column shows the current score.
By default, CL omits closed CLs, those with an R=close reply and no subsequent upload of a new patch set. If the -closed flag is specified, CL adds closed CLs to the output.
By default, CL omits CLs containing “DO NOT REVIEW” in the latest patch's commit message. If the -dnr flag is specified, CL includes those CLs in its output.
If the -r flag is specified, CL shows only CLs that need review, not those waiting for the author. In this mode, the redundant “waiting for reviewer” asterisk is elided.
If the -url flag is specified, CL replaces "CL 1234" at the beginning of each output line with a full URL, "https://golang.org/cl/1234".
If the -cl flag is specified, CL prints the status of just one particular CL.
If the -project flag is specified, CL prints the CLs only from the given project.
By default, CL sorts the output first by the combination of project name and change subject. The -sort flag changes the sort order. The choices are "delay", to sort by the time the change has been in the current waiting state, and "age", to sort by creation time. When sorting, ties are broken by CL number.
TODO: Support do-not-review, output as JSON.
Source Files