From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp0 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms12 with LMTPS id iEmjDbHHsF9wKwAAsNZ9tg (envelope-from ) for ; Sun, 15 Nov 2020 06:16:17 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp0 with LMTPS id yHhlCbHHsF+bawAA1q6Kng (envelope-from ) for ; Sun, 15 Nov 2020 06:16:17 +0000 Received: from pb-smtp20.pobox.com (pb-smtp20.pobox.com [173.228.157.52]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by aspmx1.migadu.com (Postfix) with ESMTPS id C33059402DD for ; Sun, 15 Nov 2020 06:16:16 +0000 (UTC) Received: from pb-smtp20.pobox.com (unknown [127.0.0.1]) by pb-smtp20.pobox.com (Postfix) with ESMTP id 6FC1F107601; Sun, 15 Nov 2020 01:16:15 -0500 (EST) (envelope-from kyle@kyleam.com) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=from:to:cc :subject:date:message-id:in-reply-to:references:mime-version :content-transfer-encoding; s=sasl; bh=kFCirW0+yIVh92V/U21I3GHoH 6E=; b=uXAknZcBvYYYl4LesUvhhb8JKZt7dWBv2mtJvdtex69xLtjtWeoJ6c0FC t5R6Cr7lo4MWu4+291wK0R6aYunMLThpikyxddCqa2PtSX26v0v2ugKMkfQK32Zw DdAuzX+NSQEdVMgr2sfeamy/CDyaxgDgBX86tOsDga/LtzfBaE= Received: from pb-smtp20.sea.icgroup.com (unknown [127.0.0.1]) by pb-smtp20.pobox.com (Postfix) with ESMTP id 694C0107600; Sun, 15 Nov 2020 01:16:15 -0500 (EST) (envelope-from kyle@kyleam.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=kyleam.com; h=from:to:cc:subject:date:message-id:in-reply-to:references:mime-version:content-transfer-encoding; s=mesmtp; bh=/atUpWhLymN7CrYDLypMQxz116hPplHgAZoDEmKyFao=; b=ZClLKtz/q3B8ZUZ7+FIB7i3EENkvrIMa4LxXxXXQGl10VVe91FD9sc05zGc2xYI9bVFH3M9wdGNc1RWojC6V+vV8faVfmxfhVgcic9oOO96AXZIdcJdDSFXwdyEqq/MxDCyuFFJFuKndSQND0ZZBcHjsMMgbCS9eum7uUI8JTrY= Received: from localhost (unknown [45.33.91.115]) (using TLSv1.2 with cipher ECDHE-RSA-AES256-GCM-SHA384 (256/256 bits)) (No client certificate requested) by pb-smtp20.pobox.com (Postfix) with ESMTPSA id D9A3E1075F6; Sun, 15 Nov 2020 01:16:12 -0500 (EST) (envelope-from kyle@kyleam.com) From: Kyle Meyer To: piem@inbox.kyleam.com Cc: zimoun Subject: [PATCH 6/6] manual: Document worktree-related options Date: Sun, 15 Nov 2020 01:15:18 -0500 Message-Id: <20201115061518.22191-7-kyle@kyleam.com> X-Mailer: git-send-email 2.29.2 In-Reply-To: <20201115061518.22191-1-kyle@kyleam.com> References: <20201115061518.22191-1-kyle@kyleam.com> MIME-Version: 1.0 X-Pobox-Relay-ID: 0F8E0ED6-270A-11EB-83F9-E43E2BB96649-24757444!pb-smtp20.pobox.com Content-Transfer-Encoding: quoted-printable X-Scanner: ns3122888.ip-94-23-21.eu Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=pobox.com header.s=sasl header.b=uXAknZcB; dkim=fail (body hash did not verify) header.d=kyleam.com header.s=mesmtp header.b=ZClLKtz/; dmarc=none; spf=pass (aspmx1.migadu.com: domain of kyle@kyleam.com designates 173.228.157.52 as permitted sender) smtp.mailfrom=kyle@kyleam.com X-Spam-Score: 2.50 X-TUID: 7rtZy3R1IVyJ --- piem.texi | 15 ++++++++++++++- 1 file changed, 14 insertions(+), 1 deletion(-) diff --git a/piem.texi b/piem.texi index cf39fe8..5f90055 100644 --- a/piem.texi +++ b/piem.texi @@ -251,6 +251,17 @@ Applying patches contained in a message be provided as the default completion candidate. Entering an empty base signals to use the current branch of the repository as the base. =20 +@vindex piem-am-create-worktree +@vindex piem-am-read-worktree-function +Rather than applying the patches directly to the associated code +repository, you can create a dedicated worktree by setting +@code{piem-am-create-worktree} to a non-nil value. Giving a prefix +argument to @code{piem-am} inverts the meaning of +@code{piem-am-create-worktree}; that is, by default a prefix argument is +useful if you generally prefer to work within the configured code +repository but would like to trigger the one-off creation of a worktree +for a particular call. + @cindex magit @vindex piem-use-magit When piem loads, it detects whether Magit is loaded and sets @@ -320,7 +331,9 @@ Using b4 to apply patches ID of the current buffer is not known (i.e. @code{piem-mid} returns nil), one is read from the caller. The caller is also queried for the branch name and base, as described for @code{piem-am} (@pxref{Applying -patches contained in a message}). +patches contained in a message}). And, as with @code{piem-am}, a +worktree can be created by configuring @code{piem-am-create-worktree} to +a non-nil value or by giving a prefix argument. =20 @findex piem-mid-to-thread-functions To generate the input thread, first any functions in --=20 2.29.2