1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
10 .de Sp \" Vertical space (when we can't use .PP)
16 .ie \\n(.$>=3 .ne \\$3
20 .TH "GIT-FORMAT-PATCH" 1 "" "" ""
22 git-format-patch \- Prepare patches for e-mail submission
26 \fIgit\-format\-patch\fR [\-n | \-k] [\-o <dir> | \-\-stdout] [\-s] [\-c]
27 [\-\-diff\-options] <his> [<mine>]
33 Prepare each commit with its patch since <mine> head forked from <his> head, one file per patch formatted to resemble UNIX mailbox format, for e\-mail submission or use with \fBgit\-am\fR(1)\&.
36 Each output file is numbered sequentially from 1, and uses the first line of the commit message (massaged for pathname safety) as the filename\&.
39 When \-o is specified, output files are created in <dir>; otherwise they are created in the current working directory\&. This option is ignored if \-\-stdout is specified\&.
42 When \-n is specified, instead of "[PATCH] Subject", the first line is formatted as "[PATCH N/M] Subject", unless you have only one patch\&.
47 \-o|\-\-output\-directory <dir>
48 Use <dir> to store the resulting files, instead of the current working directory\&.
52 Name output in \fI[PATCH n/m]\fR format\&.
56 Do not strip/add \fI[PATCH]\fR from the first line of the commit log message\&.
60 Add Signed\-off\-by: line to the commit message, using the committer identity of yourself\&.
64 Display suspicious lines in the patch\&. The definition of \fIsuspicious lines\fR is currently the lines that has trailing whitespaces, and the lines whose indentation has a SP character immediately followed by a TAB character\&.
68 This flag generates the mbox formatted output to the standard output, instead of saving them into a file per patch and implies \-\-mbox\&.
73 git\-format\-patch \-k \-\-stdout R1\&.\&.R2 | git\-am \-3 \-k
74 Extract commits between revisions R1 and R2, and apply them on top of the current branch using git\-am to cherry\-pick them\&.
77 git\-format\-patch origin
78 Extract commits the current branch accumulated since it pulled from origin the last time in a patch form for e\-mail submission\&.
81 git\-format\-patch \-M \-B origin
82 The same as the previous one, except detect and handle renames and complete rewrites intelligently to produce renaming patch\&. A renaming patch reduces the amount of text output, and generally makes it easier to review it\&. Note that the "patch" program does not understand renaming patch well, so use it only when you know the recipient uses git to apply your patch\&.
87 \fBgit\-am\fR(1), \fBgit\-send\-email\fR(1)
92 Written by Junio C Hamano <junkio@cox\&.net>
97 Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
102 Part of the \fBgit\fR(7) suite