git-am

原文： https://git-scm.com/docs/git-am

名称

git-am - 从邮箱中应用一系列补丁

概要

  1. git am [--signoff] [--keep] [--[no-]keep-cr] [--[no-]utf8]
  2.      [--[no-]3way] [--interactive] [--committer-date-is-author-date]
  3.      [--ignore-date] [--ignore-space-change | --ignore-whitespace]
  4.      [--whitespace=<option>] [-C<n>] [-p<n>] [--directory=<dir>]
  5.      [--exclude=<path>] [--include=<path>] [--reject] [-q | --quiet]
  6.      [--[no-]scissors] [-S[<keyid>]] [--patch-format=<format>]
  7.      [(<mbox> | <Maildir>)…​]
  8. git am (--continue | --skip | --abort | --quit | --show-current-patch)

描述

将邮箱中的邮件拆分为提交日志消息，作者信息和修补程序，并将其应用于当前分支。

OPTIONS

  1.  (<mbox>|<Maildir>)…​

要从中读取修补程序的邮箱文件列表。如果您不提供此参数，则该命令将从标准输入读取。如果您提供目录，它们将被视为Maildirs。

  1.  -s
  1.  --signoff

使用您自己的提交者标识在提交消息中添加Signed-off-by:行。有关详细信息，请参阅 git-commit [1] 中的签收选项。

  1.  -k
  1.  --keep

将-k标志传递给 git mailinfo （参见 git-mailinfo [1] ）。

  1.  --keep-non-patch

将-b标志传递给 git mailinfo （参见 git-mailinfo [1] ）。

  1.  --[no-]keep-cr

使用--keep-cr，使用相同选项调用 git mailsplit （参见 git-mailsplit [1] ），以防止它在行末端剥离CR。 am.keepcr配置变量可用于指定默认行为。 --no-keep-cr可用于覆盖am.keepcr。

  1.  -c
  1.  --scissors

在剪刀线之前移除体内的所有物体（参见 git-mailinfo [1] ）。默认情况下可以使用mailinfo.scissors配置变量激活。

  1.  --no-scissors

忽略剪刀线（见 git-mailinfo [1] ）。

  1.  -m
  1.  --message-id

将-m标志传递给 git mailinfo （参见 git-mailinfo [1] ），以便将Message-ID标头添加到提交消息中。 am.messageid配置变量可用于指定默认行为。

  1.  --no-message-id

不要将Message-ID标头添加到提交消息中。 no-message-id用于覆盖am.messageid。

  1.  -q
  1.  --quiet

安静。仅打印错误消息。

  1.  -u
  1.  --utf8

将-u标志传递给 git mailinfo （参见 git-mailinfo [1] ）。从电子邮件中获取的建议提交日志消息被重新编码为UTF-8编码（配置变量i18n.commitencoding可用于指定项目的首选编码，如果它不是UTF-8）。

这在git的早期版本中是可选的，但现在它是默认的。您可以使用--no-utf8覆盖它。

  1.  --no-utf8

将-n标志传递给 git mailinfo （参见 git-mailinfo [1] ）。

  1.  -3
  1.  --3way
  1.  --no-3way

当补丁不能干净地应用时，如果补丁记录了它应该应用的blob的身份，则回退到三向合并，并且我们在本地可以使用这些blob。 --no-3way可用于覆盖am.threeWay配置变量。有关更多信息，请参阅 git-config [1] 中的am.threeWay。

  1.  --ignore-space-change
  1.  --ignore-whitespace
  1.  --whitespace=<option>
  1.  -C<n>
  1.  -p<n>
  1.  --directory=<dir>
  1.  --exclude=<path>
  1.  --include=<path>
  1.  --reject

这些标志传递给应用补丁的 git apply （参见 git-apply [1] ）程序。

  1.  --patch-format

默认情况下，该命令将尝试自动检测修补程序格式。此选项允许用户绕过自动检测并指定应将补丁解释为的补丁格式。有效格式为mbox，mboxrd，stgit，stgit-series和hg。

  1.  -i
  1.  --interactive

以交互方式运行。

  1.  --committer-date-is-author-date

默认情况下，该命令将电子邮件中的日期记录为提交作者日期，并使用提交创建时间作为提交者日期。这允许用户使用与作者日期相同的值来说谎提交者日期。

  1.  --ignore-date

默认情况下，该命令将电子邮件中的日期记录为提交作者日期，并使用提交创建时间作为提交者日期。这允许用户使用与提交者日期相同的值来欺骗作者日期。

  1.  --skip

跳过当前的补丁。这仅在重新启动已中止的修补程序时才有意义。

  1.  -S[<keyid>]
  1.  --gpg-sign[=<keyid>]

GPG签名提交。 keyid参数是可选的，默认为提交者标识;如果指定，它必须粘在没有空格的选项上。

  1.  --continue
  1.  -r
  1.  --resolved

在修补程序失败（例如，尝试应用冲突的修补程序）之后，用户已手动应用它并且索引文件存储应用程序的结果。使用从电子邮件和当前索引文件中提取的作者和提交日志进行提交，然后继续。

  1.  --resolvemsg=<msg>

当发生补丁失败时，< msg>将在退出前打印到屏幕上。这将覆盖标准消息，通知您使用--continue或--skip来处理故障。这仅供 git rebase 和 git am 之间的内部使用。

  1.  --abort

恢复原始分支并中止修补操作。

  1.  --quit

中止修补操作但保持HEAD和索引不变。

  1.  --show-current-patch

显示因“冲突”而停止“git am”时正在应用的补丁。

讨论

提交作者姓名取自消息的“发件人：”行，提交作者日期取自消息的“日期：”行。在剥离公共前缀“[PATCH< anything>]”之后，“Subject：”行被用作提交的标题。 “Subject：”行应该在一行文本中简明地描述提交的内容。

“From：”和“Subject：”行开始正文覆盖从标题中获取的相应提交作者姓名和标题值。

提交消息由从“主题：”获取的标题，空白行和消息正文直到补丁开始的位置形成。每行末尾的多余空格会自动删除。

该补丁预计将是内联的，直接跟在消息之后。任何形式的行：

  • 三个破折号和行尾，或

  • 以“diff - ”开头的行，或

  • 一行以“索引：”开头

被视为补丁的开头，并且在第一次出现这样的行之前终止提交日志消息。

最初调用git am时，为其指定要处理的邮箱的名称。在看到第一个不适用的补丁时，它会在中间中止。您可以通过以下两种方式之一从中恢复：

  1. 通过使用--skip选项重新运行命令来跳过当前补丁。

  2. 手解决工作目录中的冲突，并更新索引文件，使其进入补丁应生成的状态。然后使用--continue选项运行命令。

该命令在当前操作完成之前拒绝处理新邮箱，因此如果您决定从头开始，请在运行带有邮箱名称的命令之前运行git am --abort。

在应用任何补丁之前，ORIGHEAD设置为当前分支的尖端。如果您遇到多次提交有问题，例如在错误的分支上运行 _git am ，或者通过更改邮箱更容易修复提交中的错误（例如“From：”行中的错误），这很有用）。

挂钩

该命令可以运行applypatch-msg，pre-applypatch和post-applypatch挂钩。有关详细信息，请参阅 githooks [5] 。

也可以看看

git-apply [1] 。

GIT

部分 git [1] 套件