You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
88 lines
2.1 KiB
88 lines
2.1 KiB
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 |
|
|
|
|