6 git-format-patch - Prepare patches for e-mail submission
12 'git-format-patch' [-n | -k] [-o <dir> | --stdout] [--attach] [-s] [-c]
13 [--diff-options] <his> [<mine>]
17 Prepare each commit with its patch since <mine> head forked from
18 <his> head, one file per patch formatted to resemble UNIX mailbox
19 format, for e-mail submission or use with gitlink:git-am[1].
21 Each output file is numbered sequentially from 1, and uses the
22 first line of the commit message (massaged for pathname safety)
25 When -o is specified, output files are created in <dir>; otherwise
26 they are created in the current working directory. This option
27 is ignored if --stdout is specified.
29 When -n is specified, instead of "[PATCH] Subject", the first
30 line is formatted as "[PATCH N/M] Subject", unless you have only
36 -o|--output-directory <dir>::
37 Use <dir> to store the resulting files, instead of the
38 current working directory.
41 Name output in '[PATCH n/m]' format.
44 Do not strip/add '[PATCH]' from the first line of the
48 Add `Signed-off-by:` line to the commit message, using
49 the committer identity of yourself.
52 Display suspicious lines in the patch. The definition
53 of 'suspicious lines' is currently the lines that has
54 trailing whitespaces, and the lines whose indentation
55 has a SP character immediately followed by a TAB
59 This flag generates the mbox formatted output to the
60 standard output, instead of saving them into a file per
61 patch and implies --mbox.
64 Create attachments instead of inlining patches.
70 git-format-patch -k --stdout R1..R2 | git-am -3 -k::
71 Extract commits between revisions R1 and R2, and apply
72 them on top of the current branch using `git-am` to
75 git-format-patch origin::
76 Extract commits the current branch accumulated since it
77 pulled from origin the last time in a patch form for
80 git-format-patch -M -B origin::
81 The same as the previous one, except detect and handle
82 renames and complete rewrites intelligently to produce
83 renaming patch. A renaming patch reduces the amount of
84 text output, and generally makes it easier to review
85 it. Note that the "patch" program does not understand
86 renaming patch well, so use it only when you know the
87 recipient uses git to apply your patch.
92 gitlink:git-am[1], gitlink:git-send-email[1]
97 Written by Junio C Hamano <junkio@cox.net>
101 Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
105 Part of the gitlink:git[7] suite