From mboxrd@z Thu Jan 1 00:00:00 1970 Return-Path: Received: from mp2 ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by ms12 with LMTPS id YHeLLuMyaF8JEQAAsNZ9tg (envelope-from ) for ; Mon, 21 Sep 2020 04:58:11 +0000 Received: from aspmx1.migadu.com ([2001:41d0:2:4a6f::]) (using TLSv1.3 with cipher TLS_AES_256_GCM_SHA384 (256/256 bits)) by mp2 with LMTPS id EOdbKuMyaF8bWQAAB5/wlQ (envelope-from ) for ; Mon, 21 Sep 2020 04:58:11 +0000 Received: from pb-smtp21.pobox.com (pb-smtp21.pobox.com [173.228.157.53]) (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 5F0E09402A8 for ; Mon, 21 Sep 2020 04:58:10 +0000 (UTC) Received: from pb-smtp21.pobox.com (unknown [127.0.0.1]) by pb-smtp21.pobox.com (Postfix) with ESMTP id B0BEAF5BE0; Mon, 21 Sep 2020 00:58:07 -0400 (EDT) (envelope-from kyle@kyleam.com) DKIM-Signature: v=1; a=rsa-sha1; c=relaxed; d=pobox.com; h=from:to :subject:date:message-id:mime-version:content-transfer-encoding; s=sasl; bh=bltm3GiEOtCHqUMzh/dQqGdpp2U=; b=tfNwasd4vkYukoDfNnJU H3xeCYPOZaJ+NFVPO4ip6Wi0pbi+38Ki2Pe/xebyogewzHtLDDWJL9q9bXCzJcZe c/qPpx+LsWuf72h/2YFg6WmkyUFdU5kv8pOheLrTPd+NsFxFWoT/BgUEpqHXEOUS lUzfX/RrxORIPRKVg22GD30= Received: from pb-smtp21.sea.icgroup.com (unknown [127.0.0.1]) by pb-smtp21.pobox.com (Postfix) with ESMTP id 9BE12F5BDF; Mon, 21 Sep 2020 00:58:07 -0400 (EDT) (envelope-from kyle@kyleam.com) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed; d=kyleam.com; h=from:to:subject:date:message-id:mime-version:content-transfer-encoding; s=mesmtp; bh=jG92/2TJsNGRWussqUef/DPMiUpvNfCTAZacP62L4Ws=; b=GsUnHuSWYiq+0kpZSz0TgFskUZPATLZRw1hHnqlU1GvuEkW2dhyYhxPkNcEq1LiGGFlecM9ufIg/TewCWddei2Il48dBbuKI5CnSUxFe371dhCu1a0XEY5TSiJ7Bj7rJO8Ng79W4r/gpLM7BQwiv06HPhiIU2YJPbR/D5NJPEAk= 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-smtp21.pobox.com (Postfix) with ESMTPSA id DCB3CF5BDD; Mon, 21 Sep 2020 00:58:04 -0400 (EDT) (envelope-from kyle@kyleam.com) From: Kyle Meyer To: piem@inbox.kyleam.com Subject: [PATCH] manual: Add section on applying patches without public-inbox Date: Mon, 21 Sep 2020 00:58:01 -0400 Message-Id: <20200921045801.24501-1-kyle@kyleam.com> X-Mailer: git-send-email 2.28.0 MIME-Version: 1.0 X-Pobox-Relay-ID: 08946436-FBC7-11EA-8B11-843F439F7C89-24757444!pb-smtp21.pobox.com Content-Transfer-Encoding: quoted-printable X-Scanner: scn0 Authentication-Results: aspmx1.migadu.com; dkim=pass header.d=pobox.com header.s=sasl header.b=tfNwasd4; dkim=fail (body hash did not verify) header.d=kyleam.com header.s=mesmtp header.b=GsUnHuSW; dmarc=none; spf=pass (aspmx1.migadu.com: domain of kyle@kyleam.com designates 173.228.157.53 as permitted sender) smtp.mailfrom=kyle@kyleam.com X-Spam-Score: 2.50 X-TUID: 8vOkqjq5lTju --- piem.texi | 24 +++++++++++++++++++++++- 1 file changed, 23 insertions(+), 1 deletion(-) diff --git a/piem.texi b/piem.texi index 1595b39..131ab44 100644 --- a/piem.texi +++ b/piem.texi @@ -1,6 +1,6 @@ \input texinfo @c -*-texinfo-*- =20 -@set VERSION 0.1.0 +@set VERSION 0.2.0 (unreleased) =20 @setfilename piem.info @documentencoding UTF-8 @@ -336,6 +336,28 @@ than identifying the thread based on the specified m= essage ID. =20 @end table =20 +@node Applying patches without a public-inbox archive +@section Applying patches without a public-inbox archive + +Much of the functionality described in the previous sections can work +even if messages aren't available in a public-inbox archive. +@code{piem-am} and @code{piem-b4-am-from-mid} try to generate the +am-ready mbox from a local source (e.g., via Notmuch or Gnus) before +falling back to downloading the thread from a public-inbox archive. + +Note, however, that the @code{piem-notmuch} integration library is +currently the only library that can generate an entire @emph{thread} +from a given message ID. As a result, if you're not a Notmuch user and +are working with a project that doesn't have a public-inbox archive, +you're unlikely to find the @code{piem-b4-am-from-mid} command useful. + +@cindex mailscripts +Also, for those not working with public-inbox archives, it's worth +checking out @url{https://git.spwhitton.name/mailscripts/,mailscripts}, +a nice set of Debian-focused tools by Sean Whitton that provides, among +other things, functionality for applying patch series, including +b4-inspired patch extraction. + =0C @node Injecting messages into a Maildir directory @chapter Injecting messages into a Maildir directory base-commit: 7a98f40e99a1c06ef76e6c92694023c1d8309103 --=20 2.28.0