diff options
author | Sean Whitton <spwhitton@spwhitton.name> | 2020-02-20 22:12:52 -0700 |
---|---|---|
committer | Sean Whitton <spwhitton@spwhitton.name> | 2020-02-20 22:12:52 -0700 |
commit | cc1f96c07dd0612e9ae44e41f889dd40315f0d75 (patch) | |
tree | bc960e456d1cba9a4070376d63443b1ec8b8f947 /notmuch-extract-patch.1.pod | |
parent | 46cedb673ae6e63724d010d3fb6a47cc209502f5 (diff) | |
parent | bbf1fc63fa1d88ea204a8cf272511ca85a828794 (diff) | |
download | mailscripts-cc1f96c07dd0612e9ae44e41f889dd40315f0d75.tar.gz |
Merge tag '0.18' into buster-bpo
release 0.18
# gpg: Signature made Sat 15 Feb 2020 03:11:16 PM MST
# gpg: using RSA key 9B917007AE030E36E4FC248B695B7AE4BF066240
# gpg: issuer "spwhitton@spwhitton.name"
# gpg: Good signature from "Sean Whitton <spwhitton@spwhitton.name>" [ultimate]
# Primary key fingerprint: 8DC2 487E 51AB DD90 B5C4 753F 0F56 D055 3B6D 411B
# Subkey fingerprint: 9B91 7007 AE03 0E36 E4FC 248B 695B 7AE4 BF06 6240
Diffstat (limited to 'notmuch-extract-patch.1.pod')
-rw-r--r-- | notmuch-extract-patch.1.pod | 54 |
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 --- a/notmuch-extract-patch.1.pod +++ b/notmuch-extract-patch.1.pod @@ -4,34 +4,15 @@ notmuch-extract-patch - extract a git patch series from notmuch =head1 SYNOPSIS -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> =head1 DESCRIPTION -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 -replies/reviews. - -=head1 OPTIONS - -=over 4 - -=item B<-v>|B<--reroll-count=>I<N> - -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. - -=back +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 +output. =head1 EXAMPLE @@ -44,18 +25,25 @@ series in reply to a bug report. =head1 LIMITATIONS +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) +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 =head1 AUTHOR -B<notmuch-extract-patch> was written by Aurelien Aptel. This manpage -was written by Sean Whitton <spwhitton@spwhitton.name> for the Debian -system, but may be used by others. +Sean Whitton <spwhitton@spwhitton.name> + +Rewrite, with additional features, of a script by Aurelien Aptel. |