Setup and Config
Getting and Creating Projects
Basic Snapshotting
Branching and Merging
Sharing and Updating Projects
Inspection and Comparison
Patching
Debugging
External Systems
Server Admin
Guides
- gitattributes
- Command-line interface conventions
- Everyday Git
- Frequently Asked Questions (FAQ)
- Glossary
- Hooks
- gitignore
- gitmodules
- Revisions
- Submodules
- Tutorial
- Workflows
- All guides...
Administration
Plumbing Commands
- 2.43.1 → 2.47.1 no changes
- 2.43.0 11/20/23
- 2.38.1 → 2.42.3 no changes
- 2.38.0 10/02/22
- 2.32.1 → 2.37.7 no changes
- 2.32.0 06/06/21
- 2.31.1 → 2.31.8 no changes
- 2.31.0 03/15/21
- 2.29.1 → 2.30.9 no changes
- 2.29.0 10/19/20
- 2.9.5 → 2.28.1 no changes
- 2.8.6 07/30/17
- 2.4.12 → 2.7.6 no changes
- 2.3.10 09/28/15
- 2.1.4 → 2.2.3 no changes
- 2.0.5 12/17/14
描述
从标准输入中读取一条电子邮件,并将提交日志信息写入<msg> 文件,将补丁写入<patch>文件。 作者姓名、电子邮件和电子邮件主题会被写到标准输出,以便被 git am 用来创建一个提交。 通常没有必要直接使用这个命令。 请参见 git-am[1]。
选项
- -k
-
通常情况下,程序会从Subject: header 行中删除电子邮件的残余部分,以提取提交日志信息的标题行。 这个选项可以防止这种删除,在用于回读 git format-patch -k 输出时最有用。
具体来说,以下内容会被删除,直到一个都不剩:
-
前导和尾部的多余空白字符。
-
前导的的
Re:
,re:
,和:
。 -
前导括号内的字符串(在
[
和]
之间,通常是[PATCH]
)。
最后,空格被规范化为一个ASCII空格字符。
-
- -b
-
当-k 不生效时,所有用 [ 和 ] 对括起来的前导字符串都被剥离。 这个选项限制了剥离的范围,只限于括号内的字符串包含 "PATCH " 一词的对括号。
- -u
-
提交日志信息、作者姓名和作者的电子邮件来自电子邮件,在对 MIME 传输编码进行最小化解码后,通过音译将其重新编码为
i18n.commitEncoding
指定的字符集(默认为 UTF-8)。 这曾经是可选的,但现在是默认的。注意,即使有这个标志,补丁也总是按原样使用,不进行字符集转换。
- --encoding=<编码>
-
与 -u 类似。 但在重新编码时,使用这里指定的字符集,而不是
i18n.commitEncoding
或 UTF-8 所指定的。 - -n
-
禁用元数据的所有字符集重新编码。
- -m
- --message-id
-
复制提交信息末尾的 Message-ID 头。 这对于将提交与邮件列表讨论联系起来是很有用的。
- --scissors
-
删除正文中剪刀线之前的所有内容(如"-→8--")。 这条线代表剪刀和打孔的标记,用来要求读者在该线处剪切信息。 如果该行出现在邮件正文中的补丁之前,当使用该选项时,它之前的所有内容(包括剪刀线本身)都会被忽略。
如果你想在讨论线中开始你的信息,对你所回应的信息提出评论和建议,并以提交补丁作为结束,用剪刀线把讨论和建议的提交日志信息的开头分开,这很有用。
这可以通过配置选项 mailinfo.scissors 来默认启用。
- --no-scissors
-
忽略剪切线。对于覆盖 mailinfo.scissors 设置很有用。
- --quoted-cr=<行为>
-
当处理以 base64 或 quoted-printable 编码发送的电子邮件,并且解码后的行以 CRLF 而不是简单的 LF 结尾时,就会启用。
有效的行为是:
-
nowarn
: 当发现这样的 CRLF 时,Git将不做任何事情。 -
warn
: 如果有这样的 CRLF,Git 会对每条信息发出警告 找到了。 -
strip
: Git 将把这些 CRLF 转换为 LF。
默认动作可以通过配置选项
mailinfo.quotedCR
设置。 如果没有设置这样的配置选项,将使用warn
。 -
- <消息>
-
从电子邮件中提取的提交日志信息,通常除了来自电子邮件主题的标题行。
- <补丁>
-
从电子邮件中提取的补丁。
配置
Warning
|
Missing See original version for this content. |
Warning
|
Missing See original version for this content. |
GIT
属于 git[1] 文档