Documentation / git-applymbox.txton commit svn import: skip initial revisions (7ee74a9)
   1git-applymbox(1)
   2================
   3
   4NAME
   5----
   6git-applymbox - Apply a series of patches in a mailbox
   7
   8
   9SYNOPSIS
  10--------
  11'git-applymbox' [-u] [-k] [-q] ( -c .dotest/<num> | <mbox> ) [ <signoff> ]
  12
  13DESCRIPTION
  14-----------
  15Splits mail messages in a mailbox into commit log message,
  16authorship information and patches, and applies them to the
  17current branch.
  18
  19
  20OPTIONS
  21-------
  22-q::
  23        Apply patches interactively.  The user will be given
  24        opportunity to edit the log message and the patch before
  25        attempting to apply patch in each e-mail message.
  26
  27-k::
  28        Usually the program 'cleans up' the Subject: header line
  29        to extract the title line for the commit log message,
  30        among which (1) remove 'Re:' or 're:', (2) leading
  31        whitespaces, (3) '[' up to ']', typically '[PATCH]', and
  32        then prepends "[PATCH] ".  This flag forbids this
  33        munging, and is most useful when used to read back 'git
  34        format-patch --mbox' output.
  35
  36-u::
  37        By default, the commit log message, author name and
  38        author email are taken from the e-mail without any
  39        charset conversion, after minimally decoding MIME
  40        transfer encoding.  This flag causes the resulting
  41        commit to be encoded in utf-8 by transliterating them.
  42        Note that the patch is always used as is without charset
  43        conversion, even with this flag.
  44
  45-c .dotest/<num>::
  46        When the patch contained in an e-mail does not cleanly
  47        apply, the command exits with an error message. The
  48        patch and extracted message are found in .dotest/, and
  49        you could re-run 'git applymbox' with '-c .dotest/<num>'
  50        flag to restart the process after inspecting and fixing
  51        them.
  52
  53<mbox>::
  54        The name of the file that contains the e-mail messages
  55        with patches.  This file should be in the UNIX mailbox
  56        format.  See 'SubmittingPatches' document to learn about
  57        the formatting convention for e-mail submission.
  58
  59<signoff>::
  60        The name of the file that contains your "Signed-off-by"
  61        line.  See 'SubmittingPatches' document to learn what
  62        "Signed-off-by" line means.  You can also just say
  63        'yes', 'true', 'me', or 'please' to use an automatically
  64        generated "Signed-off-by" line based on your committer
  65        identity.
  66
  67
  68SEE ALSO
  69--------
  70gitlink:git-applypatch[1].
  71
  72
  73Author
  74------
  75Written by Linus Torvalds <torvalds@osdl.org>
  76
  77Documentation
  78--------------
  79Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.
  80
  81GIT
  82---
  83Part of the gitlink:git[7] suite
  84