=head1 NAME notmuch-extract-patch - extract a git patch series from notmuch =head1 SYNOPSIS B [B<-v>|B<--reroll-count=>I] I =head1 DESCRIPTION B 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 Try to extract the Ith version of a patch series, where these patches are identified by subject prefixes like "[PATCH vI 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 =head1 EXAMPLE =over 4 % git checkout -b test-feature % notmuch-extract-patch thread:000000000000265f | git am =back =head1 LIMITATIONS B 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. =head1 SEE ALSO notmuch(1), git-send-email(1) =head1 AUTHOR B was written by Aurelien Aptel. This manpage was written by Sean Whitton for the Debian system, but may be used by others.