NAME

SYNOPSIS

DESCRIPTION

Git assumes a one-to-one relationship between git commits and Differential Revisions, and the Differential Revision title must match the summary line of the corresponding commit. In particular, the commit summaries must be unique across all open Differential Revisions authored the submitter.

The first parameter must be a verb. The available verbs are:

create

Create new Differential Revisions from the specified commits. Accepts options:

-l

Before processing commit(s) display list of commits to be processed and wait for confirmation.

-r reviewer

Add one or more reviewers, separated by commas, to revision(s) being created. Argument(s) must be existing Phabricator user or group.

-r subscriber

Add one or more subscribers, separated by commas, to revision(s) being created. Argument(s) must be existing Phabricator user or group.

-p parent

Specify the parent of the first commit in the list. This is useful when adding more commits on top of the already existing stack in Phabricator.

list

Print the associated Differential Revisions for the specified commits.

patch

Try to apply a patch from a Differential revision to the currently checked out tree.

stage

Prepare a series of commits to be pushed to the upstream FreeBSD repository. The commits are cherry-picked to a branch (by default the “main” branch), review tags are added to the commit log message, and the log message is opened in an editor for any last-minute updates. The commits need not have associated Differential Revisions.

update

Synchronize the Differential Revisions associated with the specified commits. Currently only the diff is updated; the review description and other metadata is not synchronized.

CONFIGURATION

arc.assume_yes

Assume a “yes” answer to all prompts instead of prompting the user. Equivalent to the -y flag. Defaults to false.

arc.browse

Try to open newly created reviews in a browser tab. Defaults to false.

arc.list

Always use “list mode” (-l) with create. In this mode, the list of git revisions to create reviews for is listed with a single prompt before creating reviews. The diffs for individual commits are not shown. Defaults to false.

arc.verbose

Always use verbose output. Equivalent to the -v flag. Defaults to false.

EXAMPLES

Commit changes with a message and create a Differential review:

$ git commit -m "kern: Rewrite in Rust"
$ git arc create HEAD

Make changes to the diff based on review feedback, then amend the changes to the existing commit and update the Differential review:

$ git commit --amend
$ git arc update HEAD

Now that all reviewers are happy, it is time to stage the commit and push it:

$ git arc stage HEAD
$ git push freebsd HEAD:main

Create a Phabricator review using the contents of the most recent commit in your git checkout:

$ git arc create -r markj HEAD

The commit title is used as the review title, the commit log message is used as the review description, and <markj@FreeBSD.org> is added as a reviewer.

Create a series of Phabricator reviews for each of HEAD~2, HEAD~ and HEAD:

$ git arc create HEAD~3..HEAD

Pairs of consecutive commits are linked into a patch stack. Note that the first commit in the specified range is excluded.

Update the review corresponding to commit b409afcfedcdda:

$ git arc update b409afcfedcdda

The title of the commit must be the same as it was when the review was created. Note that the review description is not automatically updated.

Apply the patch in review D12345 to the currently checked-out tree, and stage it:

$ git arc patch D12345

List the status of reviews for all the commits in the branch “feature”:

$ git arc list main..feature

SEE ALSO

HISTORY

AUTHORS