Documentation/git-format-patch.txt

   1 git-format-patch(1)
   2 ===================
   3
   4 NAME
   5 ----
   6 git-format-patch - Prepare patches for e-mail submission.
   7
   8
   9 SYNOPSIS
  10 --------
  11 'git-format-patch' [-n][-o <dir>][-k][--mbox][--diff-options] <his> [<mine>]
  12
  13 DESCRIPTION
  14 -----------
  15 Prepare each commit with its patch since <mine> head forked from
  16 <his> head, one file per patch, for e-mail submission.  Each
  17 output file is numbered sequentially from 1, and uses the first
  18 line of the commit message (massaged for pathname safety) as the
  19 filename.
  20
  21 When -o is specified, output files are created in that
  22 directory; otherwise in the current working directory.
  23
  24 When -n is specified, instead of "[PATCH] Subject", the first
  25 line is formatted as "[PATCH N/M] Subject", unless you have only
  26 one patch.
  27
  28 When --mbox is specified, the output is formatted to resemble
  29 UNIX mailbox format, and can be concatenated together for
  30 processing with applymbox.
  31
  32
  33 OPTIONS
  34 -------
  35 -o <dir>::
  36         Use <dir> to store the resulting files, instead of the
  37         current working directory.
  38
  39 -n::
  40         Name output in '[PATCH n/m]' format.
  41
  42 -k::
  43         Do not strip/add '[PATCH]' from the first line of the
  44         commit log message.
  45
  46 --author, --date::
  47         Output From: and Date: headers for commits made by
  48         yourself as well.  Usually these are output only for
  49         commits made by people other than yourself.
  50
  51 --mbox::
  52         Format the output files for closer to mbox format by
  53         adding a phony Unix "From " line, so they can be
  54         concatenated together and fed to `git-applymbox`.
  55         Implies --author and --date.
  56
  57
  58 Author
  59 ------
  60 Written by Junio C Hamano <junkio@cox.net>
  61
  62 Documentation
  63 --------------
  64 Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
  65
  66 GIT
  67 ---
  68 Part of the gitlink:git[7] suite
  69