git-applymbox

Langue: en

Version: 09/23/2007 (openSuse - 09/10/07)

Section: 1 (Commandes utilisateur)

NAME

git-applymbox - Apply a series of patches in a mailbox

SYNOPSIS

git-applymbox [-u] [-k] [-q] [-m] ( -c .dotest/<num> | <mbox> ) [ <signoff> ]

DESCRIPTION

Splits mail messages in a mailbox into commit log message, authorship information and patches, and applies them to the current branch.

OPTIONS

-q

Apply patches interactively. The user will be given opportunity to edit the log message and the patch before attempting to apply it.

-k

Usually the program cleans up the Subject: header line to extract the title line for the commit log message, among which (1) remove Re: or re:, (2) leading whitespaces, (3) [ up to ], typically [PATCH], and then prepends "[PATCH] ". This flag forbids this munging, and is most useful when used to read back git format-patch -k output.

-m

Patches are applied with git-apply command, and unless it cleanly applies without fuzz, the processing fails. With this flag, if a tree that the patch applies cleanly is found in a repository, the patch is applied to the tree and then a 3-way merge between the resulting tree and the current tree.

-u

Pass -u flag to git-mailinfo (see git-mailinfo(1)). The proposed commit log message taken from the e-mail are re-coded into UTF-8 encoding (configuration variable i18n.commitencoding can be used to specify project's preferred encoding if it is not UTF-8). This used to be optional but now it is the default.
Note that the patch is always used as-is without charset conversion, even with this flag.

-n

Pass -n flag to git-mailinfo (see git-mailinfo(1)).

-c .dotest/<num>

When the patch contained in an e-mail does not cleanly apply, the command exits with an error message. The patch and extracted message are found in .dotest/, and you could re-run git applymbox with -c .dotest/<num> flag to restart the process after inspecting and fixing them.

<mbox>

The name of the file that contains the e-mail messages with patches. This file should be in the UNIX mailbox format. See SubmittingPatches document to learn about the formatting convention for e-mail submission.

<signoff>

The name of the file that contains your "Signed-off-by" line. See SubmittingPatches document to learn what "Signed-off-by" line means. You can also just say yes, true, me, or please to use an automatically generated "Signed-off-by" line based on your committer identity.

SEE ALSO

git-am(1), git-applypatch(1).

AUTHOR

Written by Linus Torvalds <torvalds@osdl.org>

DOCUMENTATION

Documentation by Junio C Hamano and the git-list <git@vger.kernel.org>.

GIT

Part of the git(7) suite