NAME

       mbox-extract-patch - extract a git patch series from an mbox

SYNOPSIS

       mbox-extract-patch [OPTIONS] <MBOX

DESCRIPTION

       mbox-extract-patch extracts a series of git patches from an mbox.  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.

OPTIONS

       -v|--reroll-count=N
           Try to extract the Nth version of a patch series, where these patches are identified
           by subject prefixes like "[PATCH vN 1/3]".

           If this option is not specified, and there is more than one series, default to
           extracting the version of the patch series with the highest version number we find.

           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 --in-reply-to option to git-format-patch(1) is used mainly for
           posting a patch series in reply to a bug report.

       --trailers
           Extract and add to patches lines like

               Acked-by: A. Developer <a.dev@example.net>

           sent in reply to those patches.  --trailers is on by default, and --no-trailers can be
           used to disable adding the trailers.

       --cover-letter-trailers
           Additionally add to all patches in the series any trailers sent in reply to the cover
           letter of the patch series.

EXAMPLE

           % git checkout -b test-feature
           % mbox-extract-patch <thread.mbox | git am

LIMITATIONS

       Detection of cover letters is currently quite simplistic.

SEE ALSO

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

AUTHOR

       Sean Whitton <spwhitton@spwhitton.name>