2005-10-21 00:28:42 +00:00
|
|
|
git-am(1)
|
2005-10-22 03:57:34 +00:00
|
|
|
=========
|
2005-10-21 00:28:42 +00:00
|
|
|
|
|
|
|
NAME
|
|
|
|
----
|
2007-01-18 23:53:37 +00:00
|
|
|
git-am - Apply a series of patches from a mailbox
|
2005-10-21 00:28:42 +00:00
|
|
|
|
|
|
|
|
|
|
|
SYNOPSIS
|
|
|
|
--------
|
2005-12-31 17:37:15 +00:00
|
|
|
[verse]
|
2008-06-30 06:09:04 +00:00
|
|
|
'git am' [--signoff] [--keep] [--utf8 | --no-utf8]
|
2007-05-14 14:44:53 +00:00
|
|
|
[--3way] [--interactive] [--binary]
|
|
|
|
[--whitespace=<option>] [-C<n>] [-p<n>]
|
2008-07-12 15:47:16 +00:00
|
|
|
[<mbox> | <Maildir>...]
|
2008-07-16 10:39:10 +00:00
|
|
|
'git am' (--skip | --resolved | --abort)
|
2005-10-21 00:28:42 +00:00
|
|
|
|
|
|
|
DESCRIPTION
|
|
|
|
-----------
|
|
|
|
Splits mail messages in a mailbox into commit log message,
|
|
|
|
authorship information and patches, and applies them to the
|
|
|
|
current branch.
|
|
|
|
|
2005-10-21 05:14:14 +00:00
|
|
|
OPTIONS
|
|
|
|
-------
|
2007-05-24 22:15:36 +00:00
|
|
|
<mbox>|<Maildir>...::
|
2007-02-09 10:23:23 +00:00
|
|
|
The list of mailbox files to read patches from. If you do not
|
2007-05-24 22:15:36 +00:00
|
|
|
supply this argument, reads from the standard input. If you supply
|
|
|
|
directories, they'll be treated as Maildirs.
|
2007-02-09 10:23:23 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-s::
|
|
|
|
--signoff::
|
2005-10-21 05:14:14 +00:00
|
|
|
Add `Signed-off-by:` line to the commit message, using
|
|
|
|
the committer identity of yourself.
|
2005-10-21 00:28:42 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-k::
|
|
|
|
--keep::
|
2008-07-03 05:41:41 +00:00
|
|
|
Pass `-k` flag to 'git-mailinfo' (see linkgit:git-mailinfo[1]).
|
2007-01-08 21:59:15 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-u::
|
|
|
|
--utf8::
|
2008-07-03 05:41:41 +00:00
|
|
|
Pass `-u` flag to 'git-mailinfo' (see linkgit:git-mailinfo[1]).
|
2007-01-08 21:59:15 +00:00
|
|
|
The proposed commit log message taken from the e-mail
|
2007-05-14 14:44:53 +00:00
|
|
|
is re-coded into UTF-8 encoding (configuration variable
|
2007-01-08 21:59:15 +00:00
|
|
|
`i18n.commitencoding` can be used to specify project's
|
|
|
|
preferred encoding if it is not UTF-8).
|
|
|
|
+
|
|
|
|
This was optional in prior versions of git, but now it is the
|
|
|
|
default. You could use `--no-utf8` to override this.
|
|
|
|
|
|
|
|
--no-utf8::
|
2008-07-03 05:41:41 +00:00
|
|
|
Pass `-n` flag to 'git-mailinfo' (see
|
2007-12-29 06:20:38 +00:00
|
|
|
linkgit:git-mailinfo[1]).
|
2005-10-21 05:14:14 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-3::
|
|
|
|
--3way::
|
2005-10-21 05:14:14 +00:00
|
|
|
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
|
2007-05-14 14:44:53 +00:00
|
|
|
available locally.
|
2005-10-21 05:14:14 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-b::
|
|
|
|
--binary::
|
2008-07-03 05:41:41 +00:00
|
|
|
Pass `--allow-binary-replacement` flag to 'git-apply'
|
2007-12-29 06:20:38 +00:00
|
|
|
(see linkgit:git-apply[1]).
|
2005-10-21 05:14:14 +00:00
|
|
|
|
2006-03-02 08:45:48 +00:00
|
|
|
--whitespace=<option>::
|
2008-07-03 05:41:41 +00:00
|
|
|
This flag is passed to the 'git-apply' (see linkgit:git-apply[1])
|
2007-05-14 14:44:53 +00:00
|
|
|
program that applies
|
2006-03-02 08:45:48 +00:00
|
|
|
the patch.
|
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-C<n>::
|
|
|
|
-p<n>::
|
2008-07-03 05:41:41 +00:00
|
|
|
These flags are passed to the 'git-apply' (see linkgit:git-apply[1])
|
2007-05-14 14:44:53 +00:00
|
|
|
program that applies
|
2007-02-08 13:57:08 +00:00
|
|
|
the patch.
|
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-i::
|
|
|
|
--interactive::
|
2007-05-14 14:44:53 +00:00
|
|
|
Run interactively.
|
|
|
|
|
|
|
|
--skip::
|
|
|
|
Skip the current patch. This is only meaningful when
|
|
|
|
restarting an aborted patch.
|
2005-10-21 05:14:14 +00:00
|
|
|
|
2008-06-08 01:36:09 +00:00
|
|
|
-r::
|
|
|
|
--resolved::
|
2005-11-17 00:46:24 +00:00
|
|
|
After a patch failure (e.g. attempting to apply
|
|
|
|
conflicting patch), the user has applied it by hand and
|
|
|
|
the index file stores the result of the application.
|
|
|
|
Make a commit using the authorship and commit log
|
|
|
|
extracted from the e-mail message and the current index
|
|
|
|
file, and continue.
|
2005-10-21 05:14:14 +00:00
|
|
|
|
2007-04-16 07:21:31 +00:00
|
|
|
--resolvemsg=<msg>::
|
|
|
|
When a patch failure occurs, <msg> will be printed
|
|
|
|
to the screen before exiting. This overrides the
|
|
|
|
standard message informing you to use `--resolved`
|
|
|
|
or `--skip` to handle the failure. This is solely
|
2008-07-03 05:41:41 +00:00
|
|
|
for internal use between 'git-rebase' and 'git-am'.
|
2007-04-16 07:21:31 +00:00
|
|
|
|
2008-07-16 10:39:10 +00:00
|
|
|
--abort::
|
|
|
|
Restore the original branch and abort the patching operation.
|
|
|
|
|
2005-10-21 05:14:14 +00:00
|
|
|
DISCUSSION
|
|
|
|
----------
|
|
|
|
|
2007-03-24 10:08:54 +00:00
|
|
|
The commit author name is taken from the "From: " line of the
|
|
|
|
message, and commit author time is taken from the "Date: " line
|
|
|
|
of the message. The "Subject: " line is used as the title of
|
|
|
|
the commit, after stripping common prefix "[PATCH <anything>]".
|
|
|
|
It is supposed to describe what the commit is about concisely as
|
|
|
|
a one line text.
|
|
|
|
|
|
|
|
The body of the message (iow, after a blank line that terminates
|
|
|
|
RFC2822 headers) can begin with "Subject: " and "From: " lines
|
|
|
|
that are different from those of the mail header, to override
|
|
|
|
the values of these fields.
|
|
|
|
|
|
|
|
The commit message is formed by the title taken from the
|
|
|
|
"Subject: ", a blank line and the body of the message up to
|
|
|
|
where the patch begins. Excess whitespaces at the end of the
|
|
|
|
lines are automatically stripped.
|
|
|
|
|
|
|
|
The patch is expected to be inline, directly following the
|
|
|
|
message. Any line that is of form:
|
|
|
|
|
|
|
|
* three-dashes and end-of-line, or
|
|
|
|
* a line that begins with "diff -", or
|
|
|
|
* a line that begins with "Index: "
|
|
|
|
|
|
|
|
is taken as the beginning of a patch, and the commit log message
|
|
|
|
is terminated before the first occurrence of such a line.
|
|
|
|
|
2005-10-21 05:14:14 +00:00
|
|
|
When initially invoking it, you give it names of the mailboxes
|
|
|
|
to crunch. Upon seeing the first patch that does not apply, it
|
2007-05-20 00:10:13 +00:00
|
|
|
aborts in the middle,. You can recover from this in one of two ways:
|
2005-10-21 05:14:14 +00:00
|
|
|
|
2007-05-14 14:44:53 +00:00
|
|
|
. skip the current patch by re-running the command with '--skip'
|
2005-10-21 05:14:14 +00:00
|
|
|
option.
|
|
|
|
|
2005-11-17 00:46:24 +00:00
|
|
|
. hand resolve the conflict in the working directory, and update
|
|
|
|
the index file to bring it in a state that the patch should
|
2005-12-13 07:24:06 +00:00
|
|
|
have produced. Then run the command with '--resolved' option.
|
2005-10-21 05:14:14 +00:00
|
|
|
|
2008-07-21 10:51:02 +00:00
|
|
|
The command refuses to process new mailboxes while `.git/rebase-apply`
|
2005-10-21 05:14:14 +00:00
|
|
|
directory exists, so if you decide to start over from scratch,
|
2008-07-21 10:51:02 +00:00
|
|
|
run `rm -f -r .git/rebase-apply` before running the command with mailbox
|
2005-10-21 05:14:14 +00:00
|
|
|
names.
|
2005-10-21 00:28:42 +00:00
|
|
|
|
2008-07-08 04:12:22 +00:00
|
|
|
Before any patches are applied, ORIG_HEAD is set to the tip of the
|
|
|
|
current branch. This is useful if you have problems with multiple
|
|
|
|
commits, like running 'git am' on the wrong branch or an error in the
|
|
|
|
commits that is more easily fixed by changing the mailbox (e.g.
|
|
|
|
errors in the "From:" lines).
|
|
|
|
|
2005-10-21 00:28:42 +00:00
|
|
|
|
|
|
|
SEE ALSO
|
|
|
|
--------
|
2007-12-29 06:20:38 +00:00
|
|
|
linkgit:git-apply[1].
|
2005-10-21 00:28:42 +00:00
|
|
|
|
|
|
|
|
|
|
|
Author
|
|
|
|
------
|
2008-07-21 19:14:42 +00:00
|
|
|
Written by Junio C Hamano <gitster@pobox.com>
|
2005-10-21 00:28:42 +00:00
|
|
|
|
|
|
|
Documentation
|
|
|
|
--------------
|
|
|
|
Documentation by Petr Baudis, Junio C Hamano and the git-list <git@vger.kernel.org>.
|
|
|
|
|
|
|
|
GIT
|
|
|
|
---
|
2008-06-06 07:07:32 +00:00
|
|
|
Part of the linkgit:git[1] suite
|