.\" Automatically generated by Pod::Man 4.14 (Pod::Simple 3.43) .\" .\" Standard preamble: .\" ======================================================================== .de Sp \" Vertical space (when we can't use .PP) .if t .sp .5v .if n .sp .. .de Vb \" Begin verbatim text .ft CW .nf .ne \\$1 .. .de Ve \" End verbatim text .ft R .fi .. .\" Set up some character translations and predefined strings. \*(-- will .\" give an unbreakable dash, \*(PI will give pi, \*(L" will give a left .\" double quote, and \*(R" will give a right double quote. \*(C+ will .\" give a nicer C++. Capital omega is used to do unbreakable dashes and .\" therefore won't be available. \*(C` and \*(C' expand to `' in nroff, .\" nothing in troff, for use with C<>. .tr \(*W- .ds C+ C\v'-.1v'\h'-1p'\s-2+\h'-1p'+\s0\v'.1v'\h'-1p' .ie n \{\ . ds -- \(*W- . ds PI pi . if (\n(.H=4u)&(1m=24u) .ds -- \(*W\h'-12u'\(*W\h'-12u'-\" diablo 10 pitch . if (\n(.H=4u)&(1m=20u) .ds -- \(*W\h'-12u'\(*W\h'-8u'-\" diablo 12 pitch . ds L" "" . ds R" "" . ds C` "" . ds C' "" 'br\} .el\{\ . ds -- \|\(em\| . ds PI \(*p . ds L" `` . ds R" '' . ds C` . ds C' 'br\} .\" .\" Escape single quotes in literal strings from groff's Unicode transform. .ie \n(.g .ds Aq \(aq .el .ds Aq ' .\" .\" If the F register is >0, we'll generate index entries on stderr for .\" titles (.TH), headers (.SH), subsections (.SS), items (.Ip), and index .\" entries marked with X<> in POD. Of course, you'll have to process the .\" output yourself in some meaningful fashion. .\" .\" Avoid warning from groff about undefined register 'F'. .de IX .. .nr rF 0 .if \n(.g .if rF .nr rF 1 .if (\n(rF:(\n(.g==0)) \{\ . if \nF \{\ . de IX . tm Index:\\$1\t\\n%\t"\\$2" .. . if !\nF==2 \{\ . nr % 0 . nr F 2 . \} . \} .\} .rr rF .\" ======================================================================== .\" .IX Title "mbox-extract-patch 1" .TH mbox-extract-patch 1 "Debian Project" "perl v5.36.0" "User Commands" .\" For nroff, turn off justification. Always turn off hyphenation; it makes .\" way too many mistakes in technical documents. .if n .ad l .nh .SH "NAME" mbox\-extract\-patch \- extract a git patch series from an mbox .SH "SYNOPSIS" .IX Header "SYNOPSIS" \&\fBmbox-extract-patch\fR [\fI\s-1OPTIONS\s0\fR] <\fI\s-1MBOX\s0\fR .SH "DESCRIPTION" .IX Header "DESCRIPTION" \&\fBmbox-extract-patch\fR extracts a series of git patches from an mbox. It is designed to extract patches that were originally sent using \&\fBgit\-send\-email\fR\|(1). It skips cover letters and replies/reviews in its output. .SH "OPTIONS" .IX Header "OPTIONS" .IP "\fB\-v\fR|\fB\-\-reroll\-count=\fR\fIN\fR" 4 .IX Item "-v|--reroll-count=N" Try to extract the \fIN\fRth version of a patch series, where these patches are identified by subject prefixes like "[\s-1PATCH\s0 v\fIN\fR 1/3]". .Sp 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. .Sp Note that this option should not usually be needed, because best practices when sharing patches with \fBgit\-send\-email\fR\|(1) include starting a new thread when posting a revised series. The \fI\-\-in\-reply\-to\fR option to \fBgit\-format\-patch\fR\|(1) is used mainly for posting a patch series in reply to a bug report. .IP "\fB\-\-trailers\fR" 4 .IX Item "--trailers" Extract and add to patches lines like .Sp .Vb 1 \& Acked\-by: A. Developer .Ve .Sp sent in reply to those patches. \fB\-\-trailers\fR is on by default, and \&\fB\-\-no\-trailers\fR can be used to disable adding the trailers. .IP "\fB\-\-cover\-letter\-trailers\fR" 4 .IX Item "--cover-letter-trailers" Additionally add to all patches in the series any trailers sent in reply to the cover letter of the patch series. .SH "EXAMPLE" .IX Header "EXAMPLE" .Vb 2 \& % git checkout \-b test\-feature \& % mbox\-extract\-patch