summaryrefslogtreecommitdiff
path: root/notmuch-extract-patch.1.pod
blob: a18cc229ee89494cee55019b53aa10a0e2f720f5 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
=head1 NAME

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>

=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

=head1 EXAMPLE

=over 4

    % git checkout -b test-feature
    % notmuch-extract-patch thread:000000000000265f | git am

=back

=head1 LIMITATIONS

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.

=head1 SEE ALSO

notmuch(1), git-send-email(1)

=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.