man1/git-format-patch.1

   1 .\"Generated by db2man.xsl. Don't modify this, modify the source.
   2 .de Sh \" Subsection
   3 .br
   4 .if t .Sp
   5 .ne 5
   6 .PP
   7 \fB\\$1\fR
   8 .PP
   9 ..
  10 .de Sp \" Vertical space (when we can't use .PP)
  11 .if t .sp .5v
  12 .if n .sp
  13 ..
  14 .de Ip \" List item
  15 .br
  16 .ie \\n(.$>=3 .ne \\$3
  17 .el .ne 3
  18 .IP "\\$1" \\$2
  19 ..
  20 .TH "GIT-FORMAT-PATCH" 1 "" "" ""
  21 .SH NAME
  22 git-format-patch \- Prepare patches for e-mail submission.
  23 .SH "SYNOPSIS"
  24
  25 .nf
  26 git\-format\-patch [\-n | \-k] [\-o <dir> | \-\-stdout] [\-s] [\-c] [\-\-mbox]
  27                  [\-\-diff\-options] <his> [<mine>]
  28 .fi
  29
  30 .SH "DESCRIPTION"
  31
  32
  33 Prepare each commit with its patch since <mine> head forked from <his> head, one file per patch, for e\-mail submission\&. Each output file is numbered sequentially from 1, and uses the first line of the commit message (massaged for pathname safety) as the filename\&.
  34
  35
  36 When \-o is specified, output files are created in that directory; otherwise in the current working directory\&.
  37
  38
  39 When \-n is specified, instead of "[PATCH] Subject", the first line is formatted as "[PATCH N/M] Subject", unless you have only one patch\&.
  40
  41
  42 When \-\-mbox is specified, the output is formatted to resemble UNIX mailbox format, and can be concatenated together for processing with applymbox\&.
  43
  44 .SH "OPTIONS"
  45
  46 .TP
  47 \-o|\-\-output\-directory <dir>
  48 Use <dir> to store the resulting files, instead of the current working directory\&.
  49
  50 .TP
  51 \-n|\-\-numbered
  52 Name output in [PATCH n/m] format\&.
  53
  54 .TP
  55 \-k|\-\-keep\-subject
  56 Do not strip/add [PATCH] from the first line of the commit log message\&.
  57
  58 .TP
  59 \-a|\-\-author, \-d|\-\-date
  60 Output From: and Date: headers for commits made by yourself as well\&. Usually these are output only for commits made by people other than yourself\&.
  61
  62 .TP
  63 \-s|\-\-signoff
  64 Add Signed\-off\-by: line to the commit message, using the committer identity of yourself\&.
  65
  66 .TP
  67 \-c|\-\-check
  68 Display suspicious lines in the patch\&. The definition of suspicious lines is currently the lines that has trailing whitespaces, and the lines whose indentation has a SP character immediately followed by a TAB character\&.
  69
  70 .TP
  71 \-m|\-\-mbox
  72 Format the output files for closer to mbox format by adding a phony Unix "From " line, so they can be concatenated together and fed to git\-applymbox\&. Implies \-\-author and \-\-date\&.
  73
  74 .TP
  75 \-\-stdout
  76 This flag generates the mbox formatted output to the standard output, instead of saving them into a file per patch and implies \-\-mbox\&.
  77
  78 .SH "EXAMPLES"
  79
  80 .TP
  81 git\-format\-patch \-k \-\-stdout R1\&.\&.R2 | git\-am \-3 \-k
  82 Extract commits between revisions R1 and R2, and apply them on top of the current branch using git\-am to cherry\-pick them\&.
  83
  84 .TP
  85 git\-format\-patch origin
  86 Extract commits the current branch accumulated since it pulled from origin the last time in a patch form for e\-mail submission\&.
  87
  88 .TP
  89 git\-format\-patch \-M \-B origin
  90 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\&.
  91
  92 .SH "SEE ALSO"
  93
  94
  95 \fBgit\-am\fR(1), \fBgit\-send\-email\fR(1)
  96
  97 .SH "AUTHOR"
  98
  99
 100 Written by Junio C Hamano <junkio@cox\&.net>
 101
 102 .SH "DOCUMENTATION"
 103
 104
 105 Documentation by Junio C Hamano and the git\-list <git@vger\&.kernel\&.org>\&.
 106
 107 .SH "GIT"
 108
 109
 110 Part of the \fBgit\fR(7) suite
 111