|
|
|
|
git-am(1)
|
|
|
|
|
=========
|
|
|
|
|
|
|
|
|
|
NAME
|
|
|
|
|
----
|
|
|
|
|
git-am - Apply a series of patches in a mailbox
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
|
--------
|
|
|
|
|
'git-am' [--signoff] [--dotest=<dir>] [--utf8] [--3way] <mbox>...
|
|
|
|
|
'git-am' [--skip]
|
|
|
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
|
-----------
|
|
|
|
|
Splits mail messages in a mailbox into commit log message,
|
|
|
|
|
authorship information and patches, and applies them to the
|
|
|
|
|
current branch.
|
|
|
|
|
|
|
|
|
|
OPTIONS
|
|
|
|
|
-------
|
|
|
|
|
--signoff::
|
|
|
|
|
Add `Signed-off-by:` line to the commit message, using
|
|
|
|
|
the committer identity of yourself.
|
|
|
|
|
|
|
|
|
|
--dotest=<dir>::
|
|
|
|
|
Instead of `.dotest` directory, use <dir> as a working
|
|
|
|
|
area to store extracted patches.
|
|
|
|
|
|
|
|
|
|
--utf8, --keep::
|
|
|
|
|
Pass `--utf8` and `--keep` flags to `git-mailinfo` (see
|
|
|
|
|
gitlink:git-mailinfo[1]).
|
|
|
|
|
|
|
|
|
|
--3way::
|
|
|
|
|
When the patch does not apply cleanly, fall back on
|
|
|
|
|
3-way merge, if the patch records the identity of blobs
|
|
|
|
|
it is supposed to apply to, and we have those blobs
|
|
|
|
|
locally.
|
|
|
|
|
|
|
|
|
|
--skip::
|
|
|
|
|
Skip the current patch. This is only meaningful when
|
|
|
|
|
restarting an aborted patch.
|
|
|
|
|
|
|
|
|
|
--interactive::
|
|
|
|
|
Run interactively, just like git-applymbox.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
DISCUSSION
|
|
|
|
|
----------
|
|
|
|
|
|
|
|
|
|
When initially invoking it, you give it names of the mailboxes
|
|
|
|
|
to crunch. Upon seeing the first patch that does not apply, it
|
|
|
|
|
aborts in the middle, just like 'git-applymbox' does. You can
|
|
|
|
|
recover from this in one of two ways:
|
|
|
|
|
|
|
|
|
|
. skip the current one by re-running the command with '--skip'
|
|
|
|
|
option.
|
|
|
|
|
|
|
|
|
|
. hand resolve the conflict in the working directory, run 'git
|
|
|
|
|
diff HEAD' to extract the merge result into a patch form and
|
|
|
|
|
replacing the patch in .dotest/patch file. After doing this,
|
|
|
|
|
run `git-reset --hard HEAD` to bring the working tree to the
|
|
|
|
|
state before half-applying the patch, then re-run the command
|
|
|
|
|
without any options.
|
|
|
|
|
|
|
|
|
|
The command refuses to process new mailboxes while `.dotest`
|
|
|
|
|
directory exists, so if you decide to start over from scratch,
|
|
|
|
|
run `rm -f .dotest` before running the command with mailbox
|
|
|
|
|
names.
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
|
--------
|
|
|
|
|
gitlink:git-applymbox[1], gitlink:git-applypatch[1].
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Author
|
|
|
|
|
------
|
|
|
|
|
Written by Junio C Hamano <junkio@cox.net>
|
|
|
|
|
|
|
|
|
|
Documentation
|
|
|
|
|
--------------
|
|
|
|
|
Documentation by Petr Baudis, Junio C Hamano and the git-list <git@vger.kernel.org>.
|
|
|
|
|
|
|
|
|
|
GIT
|
|
|
|
|
---
|
|
|
|
|
Part of the gitlink:git[7] suite
|
|
|
|
|
|
