Differential D56664 Diff 176634 tools/tools/git/git-arc.1

Changeset View

Standalone View

tools/tools/git/git-arc.1

	Show All 18 Lines
	.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL			.\" FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
	.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS			.\" DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
	.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)			.\" OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
	.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT			.\" HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
	.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY			.\" LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
	.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF			.\" OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
	.\" SUCH DAMAGE.			.\" SUCH DAMAGE.
	.\"			.\"
	.Dd February 10, 2026			.Dd April 27, 2026
	.Dt GIT-ARC 1			.Dt GIT-ARC 1
	.Os			.Os
	.Sh NAME			.Sh NAME
	.Nm "git arc"			.Nm "git arc"
	.Nd a wrapper to improve integration between git and arcanist			.Nd a wrapper to improve integration between git and arcanist
	.Sh SYNOPSIS			.Sh SYNOPSIS
	.Nm			.Nm
	.Cm create			.Cm create
	.Op Fl l			.Op Fl dl
	.Op Fl r Ar reviewer1 Ns Op Cm \&, Ns Ar reviewer2 ...			.Op Fl r Ar reviewer1 Ns Op Cm \&, Ns Ar reviewer2 ...
	.Op Fl s Ar subscriber1 Ns Op Cm \&, Ns Ar subscriber2 ...			.Op Fl s Ar subscriber1 Ns Op Cm \&, Ns Ar subscriber2 ...
	.Op Fl p Ar parent			.Op Fl p Ar parent
	.Ar commit-ref Op Ar commit-ref ...			.Ar commit-ref Op Ar commit-ref ...
	.Nm			.Nm
	.Cm list Ar commit-ref Op Ar commit-ref ...			.Cm list Ar commit-ref Op Ar commit-ref ...
	.Nm			.Nm
	.Cm patch			.Cm patch
	▲ Show 20 Lines • Show All 45 Lines • ▼ Show 20 Lines
	.Xr git-rev-parse 1			.Xr git-rev-parse 1
	for details on specifying commit references.			for details on specifying commit references.
	The available verbs are:			The available verbs are:
	.Bl -tag -width "create"			.Bl -tag -width "create"
	.It Cm create			.It Cm create
	Create new Differential Revisions from the specified commits.			Create new Differential Revisions from the specified commits.
	Accepts options:			Accepts options:
	.Bl -tag -width "-s subscriber"			.Bl -tag -width "-s subscriber"
				.It Fl d
				Create the diff in draft mode.
				In this mode, the review is not visible to others.
				jrmUnsubmitted Not Done Inline Actions I tested this by creating a test commit and review with `git arc create -d -l -r markj HEAD`. It successfully created the review in draft mode. I then used a private browser window to view the new revision URI, and I could see it. Is this expected? jrm: I tested this by creating a test commit and review with `git arc create -d -l -r markj HEAD`.
				It can be further configured and published via the web UI.
				This is useful for creating reviews with restricted visibility, as the
				visibility can be configured prior to publication, while the draft is
				jrmUnsubmitted Done Inline Actions Should this be cannot be configured prior to publication? jrm: Should this be cannot be configured prior to publication?
				jrmUnsubmitted Done Inline Actions Nevermind. After re-reading, I believe what you have is correct. jrm: Nevermind. After re-reading, I believe what you have is correct.
				markjAuthorUnsubmitted Done Inline Actions I added a bit more clarification there. markj: I added a bit more clarification there.
				markjAuthorUnsubmitted Done Inline Actions Hum. I guess it's "expected", but I didn't realize it worked that way. One has to guess the URL in order to see it (i.e., the draft doesn't show up in reviews.f.o/p/jrm), and auto-added reviewers and subscribers don't get email for a draft, so this approach is still better than nothing, but yes the text here is misleading. I think the proper way to do what I want is to configure a separate phabricator project with different default settings for visibility. I'd need an admin to set that up. :( markj: Hum. I guess it's "expected", but I didn't realize it worked that way. One has to guess the URL…
				still private.
	.It Fl l			.It Fl l
	Before processing commit(s) display list of commits to be processed			Before processing commit(s) display list of commits to be processed
	and wait for confirmation.			and wait for confirmation.
	.It Fl r Ar reviewer			.It Fl r Ar reviewer
	Add one or more reviewers, separated by commas, to revision(s) being created.			Add one or more reviewers, separated by commas, to revision(s) being created.
	Each argument must be an existing Phabricator user or group.			Each argument must be an existing Phabricator user or group.
	Note that group reviewers must be specified using their			Note that group reviewers must be specified using their
	hashtag (e.g. #jails for the "Jails" group).			hashtag (e.g. #jails for the "Jails" group).
	▲ Show 20 Lines • Show All 205 Lines • Show Last 20 Lines