|author||Sean Whitton <email@example.com>||2020-02-15 15:03:23 -0700|
|committer||Sean Whitton <firstname.lastname@example.org>||2020-02-15 15:04:18 -0700|
notmuch-extract-patch: rewrite & split out mbox-extract-patch
Signed-off-by: Sean Whitton <email@example.com>
Diffstat (limited to 'notmuch-extract-patch.1.pod')
1 files changed, 21 insertions, 33 deletions
diff --git a/notmuch-extract-patch.1.pod b/notmuch-extract-patch.1.pod
index a18cc22..242a704 100644
@@ -4,34 +4,15 @@ notmuch-extract-patch - extract a git patch series from notmuch
-B<notmuch-extract-patch> [B<-v>|B<--reroll-count=>I<N>] I<QUERY>
+B<notmuch-extract-patch> [I<mbox-extract-patch(1) options>] [I<-->] I<QUERY>
-B<notmuch-extract-patch> extracts a series of git patches from your
-notmuch database. It is designed to extract patches that were
-originally sent using git-send-email(1). It skips cover letters and
-Try to extract the I<N>th version of a patch series, where these
-patches are identified by subject prefixes like "[PATCH vI<N> 1/3]".
-If this option is not specified, default to extracting the first
-version of the patch series.
-Note that this option should not usually be needed, because best
-practices when sharing patches with git-send-email(1) include starting
-a new thread when posting a revised series. The I<--in-reply-to>
-option to git-format-patch(1) is used mainly for posting a patch
-series in reply to a bug report.
+B<notmuch-extract-patch> is a wrapper around mbox-extract-patch(1) to
+extract a series of git patches from your notmuch database. It is
+designed to extract patches that were originally sent using
+git-send-email(1). It skips cover letters and replies/reviews in its
@@ -44,18 +25,25 @@ series in reply to a bug report.
+We inherit limitations of mbox-extract-patch(1).
B<notmuch-extract-patch> can select patches to extract based on the
-reroll count, but otherwise assumes that there is only one patch
-series in a thread. If this assumption is violated, you would need to
-construct a notmuch query that includes only the patches you want to
-extract, which somewhat defeats the purpose of this script.
+reroll count (see -v in mbox-extract-patch(1)), but otherwise typical
+usage assumes that there is only one patch series in a thread.
+If this assumption is violated, you would need to construct a notmuch
+query that includes only the patches you want to extract, which
+somewhat defeats the purpose of having this script.
=head1 SEE ALSO
+notmuch(1), git-send-email(1), mbox-extract-patch(1)
+Emacs functions 'notmuch-extract-thread-patches' and
+'notmuch-extract-message-patches', provided by mailscripts.el
-B<notmuch-extract-patch> was written by Aurelien Aptel. This manpage
-was written by Sean Whitton <firstname.lastname@example.org> for the Debian
-system, but may be used by others.
+Sean Whitton <email@example.com>
+Rewrite, with additional features, of a script by Aurelien Aptel.