X-Git-Url: https://git.tokkee.org/?a=blobdiff_plain;ds=sidebyside;f=Documentation%2Fgit-applymbox.txt;h=3bc92d8cf17297e7b4a88bd2aeb9339b83d9d283;hb=e18ee576b1420e7b2cfc5c686872fa3b439ac45f;hp=3d813ec4cf67c039cd49b7e3e35941056e69b1a8;hpb=51017101c7a308745ba3c04944457f1dc6a55780;p=git.git diff --git a/Documentation/git-applymbox.txt b/Documentation/git-applymbox.txt index 3d813ec4c..3bc92d8cf 100644 --- a/Documentation/git-applymbox.txt +++ b/Documentation/git-applymbox.txt @@ -8,7 +8,7 @@ git-applymbox - Apply a series of patches in a mailbox SYNOPSIS -------- -'git-applymbox' [-u] [-k] [-q] ( -c .dotest/ | ) [ ] +'git-applymbox' [-u] [-k] [-q] [-m] ( -c .dotest/ | ) [ ] DESCRIPTION ----------- @@ -22,7 +22,7 @@ OPTIONS -q:: Apply patches interactively. The user will be given opportunity to edit the log message and the patch before - attempting to apply patch in each e-mail message. + attempting to apply it. -k:: Usually the program 'cleans up' the Subject: header line @@ -33,14 +33,28 @@ OPTIONS munging, and is most useful when used to read back 'git format-patch --mbox' 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:: - By default, the commit log message, author name and - author email are taken from the e-mail without any - charset conversion, after minimally decoding MIME - transfer encoding. This flag causes the resulting - commit to be encoded in utf-8 by transliterating them. - Note that the patch is always used as is without charset - conversion, even with this flag. + Pass `-u` flag to `git-mailinfo` (see gitlink: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 + gitlink:git-mailinfo[1]). -c .dotest/:: When the patch contained in an e-mail does not cleanly @@ -64,6 +78,12 @@ OPTIONS generated "Signed-off-by" line based on your committer identity. + +SEE ALSO +-------- +gitlink:git-am[1], gitlink:git-applypatch[1]. + + Author ------ Written by Linus Torvalds @@ -74,5 +94,5 @@ Documentation by Junio C Hamano and the git-list . GIT --- -Part of the link:git.html[git] suite +Part of the gitlink:git[7] suite