git-format-patch - 云端在线

程序：

您的姓名

git-format-patch - 为电子邮件提交准备补丁

概要

混帐 格式补丁 [-k] [(-o|--输出目录) | --标准输出]
[--无线程 | --线程[= ]]
[(--attach|--inline)[= ] | --无附加]
[-s | - 搁笔]
[--签名= | --无签名]
[--签名文件= ]
[-n | --编号 | -N | --无编号]
[--起始编号] [--编号文件]
[--in-reply-to=Message-Id] [--suffix=. ]
[--如果在上游忽略]
[--subject-prefix=Subject-Prefix] [(--reroll-count|-v) ]
[--to= ] [--cc= ]
[--[no-]cover-letter] [--quiet] [--notes[= ]]
[ ]
[ | ]

商品描述

在每个提交的一个文件中准备每个提交及其补丁，格式类似于 UNIX
邮箱格式。 该命令的输出方便邮件提交或使用
- 混帐 am.

有两种方法可以指定要操作的提交。

1. 一次提交， , 指定导致当前提示的提交
不在历史中的分支导致要输出。

2. 通用表达式（参见“规范修订”部分
git 修订版(7)) 表示指定范围内的提交。

在单个的情况下，第一条规则优先. 应用第二个
规则，即格式化从历史开始直到， 使用
- 根 选项：git format-patch --root . 如果您只想格式化
本身，你可以用 git format-patch -1 来做到这一点.

默认情况下，每个输出文件从 1 开始按顺序编号，并使用第一行
提交消息（为路径名安全而按摩）作为文件名。 随着
--numbered-files 选项，输出文件名只会是数字，没有第一个
附加的提交行。 输出文件的名称打印到标准输出，
除非指定了 --stdout 选项。

如果指定了 -o，则在. 否则，它们将在
当前工作目录。

默认情况下，单个补丁的主题是“[PATCH]”，后跟
从提交消息到第一个空行的行（参见 DISCUSSION 部分
git提交（1））。

当输出多个补丁时，主题前缀将改为“[PATCH n/m]”。 到
强制为单个补丁添加 1/1，使用 -n。 要从主题中省略补丁号，
使用 -N。

如果给定 --thread，git-format-patch 将生成 In-Reply-To 和 References 标头到
使第二封和后续补丁邮件显示为对第一封邮件的回复； 这也是
生成一个 Message-Id 标头以供参考。

配置

-p，--无统计
生成没有任何 diffstats 的普通补丁。

-s，--无补丁
抑制差异输出。 对像 git show 这样显示补丁的命令很有用
默认，或者取消 --patch 的效果。

-U , --统一=
生成差异上下文而不是通常的三行。

--最小
花额外的时间来确保产生尽可能小的差异。

- 耐心
使用“耐心差异”算法生成差异。

--直方图
使用“直方图差异”算法生成差异。

--diff-algorithm={耐心|最小|直方图|迈尔斯}
选择差异算法。 变体如下：

默认，迈尔斯
基本的贪心差异算法。 目前，这是默认设置。

最小
花额外的时间来确保产生尽可能小的差异。

忍耐
生成补丁时使用“耐心差异”算法。

直方图
该算法将耐心算法扩展为“支持低发生率的常见
元素”。

例如，如果您将 diff.algorithm 变量配置为非默认值并且
想要使用默认的，那么你必须使用 --diff-algorithm=default 选项。

--统计[= [, [, ]]]
生成差异统计。 默认情况下，将根据需要使用尽可能多的空间
文件名部分，其余部分用于图形部分。 最大宽度默认为终端
宽度，如果未连接到终端，则为 80 列，并且可以被覆盖.
文件名部分的宽度可以通过提供另一个宽度来限制
逗号后。 图形部分的宽度可以通过使用来限制
--stat-graph-width= （影响所有生成统计图的命令）或通过
设置 diff.statGraphWidth= （不影响 git 格式补丁）。 通过给出一个
第三个参数，您可以将输出限制为第一个行，跟随
by ...如果还有更多。

这些参数也可以单独设置 --stat-width= ,
--stat-名称-宽度= 和 --stat-count= .

--numstat
与 --stat 类似，但以十进制表示法显示添加和删除的行数和
没有缩写的路径名，以使其对机器更友好。 对于二进制文件，
输出两个 - 而不是说 0 0。

--shortstat
仅输出包含修改总数的 --stat 格式的最后一行
文件，以及添加和删除的行数。

--dirstat[= ]
输出每个子目录的相对变化量分布。 这
--dirstat 的行为可以通过传递一个逗号分隔的列表来自定义
参数。 默认值由 diff.dirstat 配置变量控制
（见 混帐配置(1))。 以下参数可用：

变化
通过计算已从目录中删除的行来计算 dirstat 数
源，或添加到目标。 这忽略了纯代码的数量
文件中的移动。 换句话说，重新排列文件中的行不是
与其他变化一样重要。 这是没有参数时的默认行为
给出。

工艺生产线
通过进行常规的基于行的差异分析来计算 dirstat 数字，以及
对删除/添加的行数求和。 （对于二进制文件，计算 64 字节块
相反，因为二进制文件没有自然的行概念）。 这是一个更
昂贵的 --dirstat 行为比更改行为更昂贵，但它确实很重要
重新排列文件中的行与其他更改一样多。 结果输出是
与您从其他 --*stat 选项中获得的内容一致。

档
通过计算更改的文件数来计算 dirstat 数。 每一个都变了
文件在 dirstat 分析中同等重要。 这是计算上最便宜的
--dirstat 行为，因为它根本不必查看文件内容。

累积的
也计算父目录的子目录中的更改。 注意
使用累积时，报告的百分比总和可能超过 100%。 这
默认（非累积）行为可以用 noncumulative 指定
参数。


整数参数指定截止百分比（默认为 3%）。 目录
低于此百分比的更改不会显示在输出中。

示例：以下将计算更改的文件，同时忽略较少的目录
超过更改文件总数的 10%，并且累积子目录计数
在父目录中：--dirstat=files,10,cumulative。

- 概括
输出扩展头信息的浓缩摘要，例如创建、重命名
和模式改变。

--no-重命名
关闭重命名检测，即使配置文件给出了默认做
所以。

--全索引
显示完整的前图像和后图像 blob，而不是前几个字符
生成补丁格式输出时“索引”行上的对象名称。

--二进制
除了 --full-index 之外，输出一个可以与 git-apply 一起应用的二进制差异。

--缩写[= ]
而不是在 diff-raw 格式输出中显示完整的 40 字节十六进制对象名称
和 diff-tree 标题行，仅显示部分前缀。 这独立于
--full-index 上面的选项，它控制差异补丁输出格式。 非默认
可以使用 --abbrev= 指定位数.

-B[ ][/ ], --break-rewrites[=[ ][/ ]]
将完整的重写更改分解为删除和创建对。 这服务于两个
用途：

它会影响相当于完全重写文件而不是一系列文件的更改方式
删除和插入混合在一起的极少数恰好匹配的行
文本作为上下文，但作为一个单一的删除所有旧的，然后是一个
单次插入所有新内容，数字 m 控制 -B 的这一方面
选项（默认为 60%）。 -B/70% 指定少于原件的 30%
保留在结果中，让 Git 将其视为完全重写（即，否则
结果补丁将是一系列与上下文混合在一起的删除和插入
行）。

与 -M 一起使用时，完全重写的文件也被视为
重命名（通常 -M 只将消失的文件视为重命名的来源），
数字 n 控制 -B 选项的这一方面（默认为 50%）。 -B20%
指定与添加和删除相比的 20% 或更多的更改
文件的大小有资格被选取作为重命名的可能来源
另一个文件。

-M[ ], --find-renames[= ]
检测重命名。 如果指定了 n，则它是相似度指数上的阈值（即
与文件大小相比的添加/删除量）。 例如，-M90% 表示
如果超过 90% 的文件，Git 应该将删除/添加对视为重命名
没有改变。 没有 % 符号，数字将被读作分数，带有
前面的小数点。 即，-M5变为0.5，因此与-M50%相同。
同样，-M05 与-M5% 相同。 要将检测限制为精确重命名，请使用 -M100%。
默认相似度指数为 50%。

-C[ ], --find-copies[= ]
检测副本以及重命名。 另见--find-copies-harder。 如果指定了 n，则它
与 -M 的含义相同.

--查找副本更难
出于性能原因，默认情况下，-C 选项仅在原始文件
在同一个变更集中修改了副本。 此标志使命令检查
未修改的文件作为副本源的候选者。 这是一个非常昂贵的
大项目操作，慎用。 提供多个 -C 选项
具有相同的效果。

-D, --不可逆删除
省略删除的原像，即只打印标题而不打印标题之间的差异
原像和 /dev/null。 生成的补丁不打算与补丁一起应用或
git申请； 这仅适用于只想专注于审查
更改后的文本。 此外，输出显然缺乏足够的信息
反向应用这样的补丁，甚至手动应用，因此该选项的名称。

与 -B 一起使用时，还省略 a 的删除部分中的原像
删除/创建对。

-l
-M 和 -C 选项需要 O(n^2) 处理时间，其中 n 是
潜在的重命名/复制目标。 此选项可防止重命名/复制检测运行
如果重命名/复制目标的数量超过指定的数量。

-O
按照指定的顺序输出补丁, 它有一个 shell glob
每行图案。 这会覆盖 diff.orderFile 配置变量（请参阅 混帐-
配置(1))。 要取消 diff.orderFile，请使用 -O/dev/null。

-a，--文本
将所有文件视为文本。

--忽略 eol 处的空间
在 EOL 时忽略空格的变化。

-b，--忽略空格更改
忽略空格量的变化。 这会忽略行尾的空格，并且
认为一个或多个空白字符的所有其他序列是等效的。

-w，--忽略所有空间
比较行时忽略空格。 即使一行有差异，这也会忽略差异
另一行没有的空白。

--忽略空白行
忽略所有行都是空白的更改。

--inter-hunk-context=
显示差异块之间的上下文，最多指定行数，从而
融合彼此接近的帅哥。

-W，--函数上下文
显示整个变化的周围功能。

--ext 差异
允许执行外部差异帮助程序。 如果您设置外部差异驱动程序
git 属性(5)、你需要使用这个选项 混帐日志(1)和朋友。

--无扩展差异
禁止外部差异驱动程序。

--textconv, --no-textconv
在比较二进制文件时允许（或禁止）运行外部文本转换过滤器
文件。 看 git 属性(5) 详情。 因为 textconv 过滤器通常是一个
单向转换，产生的差异适合人类消费，但不能
被应用。 因此，默认情况下仅启用 textconv 过滤器 混帐-
差异（1）和 混帐日志(1)，但不是为了 git-格式补丁(1) 或 diff 管道命令。

--忽略子模块[= ]
忽略差异生成中对子模块的更改。 可以是“无”，
“untracked”、“dirty”或“all”，这是默认值。 使用“无”将考虑
子模块在包含未跟踪或修改的文件或其 HEAD 时被修改
与超级项目中记录的提交不同，可用于覆盖任何
的设置 忽略 选项 混帐配置（1）或 git模块(5). 当“未跟踪”是
当使用的子模块仅包含未跟踪的内容时，它们不被认为是脏的（但是
他们仍然会扫描修改的内容）。 使用“dirty”会忽略对
子模块的工作树，仅对存储在超级项目中的提交进行更改
显示（这是 1.7.0 之前的行为）。 使用“all”隐藏所有更改
子模块。

--src-前缀=
显示给定的源前缀而不是“a/”。

--dst-前缀=
显示给定的目的地前缀而不是“b/”。

--无前缀
不要显示任何源或目标前缀。

有关这些常用选项的更详细说明，另请参见 git差异核心（7）。

——
从最上层准备补丁提交。

-o ， - 输出目录
用存储生成的文件，而不是当前的工作目录。

-n, --编号
名称输出 [修补 米/米] 格式，即使只有一个补丁。

-N, --无编号
名称输出 [修补] 格式。

--起始编号
开始给补丁编号而不是 1。

--编号文件
输出文件名将是一个简单的数字序列，没有默认的第一行
附加提交。

-k，--保持主题
不要剥离/添加 [修补] 从提交日志消息的第一行开始。

-s, --签核
使用提交者身份将 Signed-off-by: 行添加到提交消息
你自己。 请参阅中的签核选项 git提交(1) 了解更多信息。

--标准输出
以 mbox 格式将所有提交打印到标准输出，而不是创建文件
每一个人。

--附加[= ]
创建多部分/混合附件，其中第一部分是提交消息和
第二部分中的补丁本身，带有 Content-Disposition：附件。

--无附加
禁用附件的创建，覆盖配置设置。

--内联[= ]
创建多部分/混合附件，其中第一部分是提交消息和
第二部分中的补丁本身，带有 Content-Disposition: inline。

--线程[= ], --no-thread
控制添加 In-Reply-To 和 References 标题以制作第二个和
随后的邮件显示为对第一封邮件的回复。 还控制生成
要引用的消息 ID 标头。

可选的 argument can be either shallow or deep. 浅 穿线使
每封邮件都会回复该系列的负责人，其中负责人是从封面中选择的
信件、--in-reply-to 和第一封补丁邮件，按此顺序。 深 穿线
使每封邮件都是对前一封邮件的回复。

默认是 --no-thread，除非 格式.线程 配置已设置。 如果 --thread
没有指定样式，默认为指定样式 格式.线程 if
任何，否则浅。

请注意，默认为 混帐 发电子邮件 是线程电子邮件本身。 如果你想要 git
format-patch 来处理线程，您需要确保线程是
对 git send-email 禁用。

--in-reply-to=消息 ID
使第一封邮件（或所有带有 --no-thread 的邮件）显示为对给定的回复
Message-Id，可避免中断线程以提供新的补丁系列。

--忽略如果在上游
不要包含与提交匹配的补丁.. . 这将检查
所有补丁都可以从但不是来自并将它们与
正在生成补丁，并且忽略任何匹配的补丁。

--主题前缀=
而不是标准 [修补] 主题行中的前缀，而不是使用
[ ]. 这允许对补丁系列进行有用的命名，并且可以
结合 --numbered 选项。

-v , --reroll-count=
将该系列标记为- 主题的第 次迭代。 输出文件名有 v
在它们前面加上主题前缀（默认情况下为“PATCH”，但可通过
--subject-prefix 选项）有 `v ` 附加到它。 例如 --reroll-count=4 可能
生成 v4-0001-add-makefile.patch 文件，其中包含“主题：[PATCH v4 1/20] 添加
生成文件”中。

--to=
将 To: 标题添加到电子邮件标题。 这是对任何配置的标头的补充，
并且可以多次使用。 否定形式 --no-to 丢弃所有 To: 标头
到目前为止添加（从配置或命令行）。

--cc=
将抄送：标题添加到电子邮件标题。 这是对任何配置的标头的补充，
并且可以多次使用。 否定形式 --no-cc 丢弃所有 Cc: 标头
到目前为止添加（从配置或命令行）。

--from, --from=
在每个提交电子邮件的 From: 标头中使用 ident。 如果提交的作者身份
与提供的标识在文本上不相同，请将 From: 标头放在
与原作者的消息。 如果没有给出身份，请使用提交者身份。

请注意，此选项仅在您实际发送电子邮件并且想要
将自己标识为发件人，但保留原作者（并且 git am 将
正确拾取体内标题）。 还要注意 git send-email 已经处理
为您进行此转换，如果您正在喂食，则不应使用此选项
结果到 git send-email。

--add-header=
向电子邮件标题添加任意标题。 这是任何配置的补充
标头，并且可以多次使用。 例如，--add-header="组织：
git-foo"。否定形式 --no-add-header 丢弃 所有 （收件人：、抄送：和自定义）标题
到目前为止从配置或命令行添加。

--[无-]求职信
除了补丁之外，生成一个包含分支的求职信文件
描述、shortlog 和整体 diffstat。 您可以在
发送之前的文件。

--注释[= ]
附加注释（见 git 笔记(1)) 用于三破折线后的提交。

预期的用例是为提交编写支持解释
不属于正确的提交日志消息，并将其包含在补丁中
提交。 虽然可以在 format-patch 运行后简单地编写这些解释
但在发送之前，将它们保留为 Git 笔记可以让它们在
补丁系列的版本（但请参阅 notes.rewrite 的讨论
中的配置选项 git 笔记(1) 使用此工作流）。

--[no]-signature=
为产生的每条消息添加一个签名。 根据 RFC 3676，签名与
正文由带有“--”的线组成。 如果省略签名选项，则签名
默认为 Git 版本号。

--签名文件=
就像 --signature 一样工作，只是签名是从文件中读取的。

--后缀=。
不要使用 .patch 作为生成文件名的后缀，而是使用指定的后缀。 一种
常见的替代方法是 --suffix=.txt。 将此留空将删除 .patch 后缀。

请注意，前导字符不必是点； 例如，您可以使用
--suffix=-patch 得到 0001-description-of-my-change-patch。

-q, --安静
不要将生成的文件的名称打印到标准输出。

--无二进制
不要输出二进制文件中更改的内容，而是显示通知
文件已更改。 无法正确应用使用此选项生成的补丁，但
它们对于代码审查仍然很有用。

--零提交
在每个补丁的 From 标头中输出全零散列，而不是提交的散列。

- 根
将修订参数视为, 即使只是一次提交
（这通常会被视为）。 请注意，root 提交包含在
指定的范围总是被格式化为创建补丁，独立于这个标志。

配置

您可以指定要添加到每封邮件的额外邮件标题行，默认为
主题前缀和文件后缀，输出多个补丁时的补丁数量，添加
“收件人”或“抄送：”标题，配置附件，并使用配置签署补丁
变量。

[格式]
headers = "组织：git-foo\n"
主题前缀 = 更改
后缀 = .txt
编号 = 自动
到 =
cc =
附加 [ = mime-boundary-string ]
注销 = 真
封面 = 自动

讨论

制作的补丁 混帐 格式补丁 是 UNIX 邮箱格式，带有固定的“魔法”
时间戳，表明文件是从格式补丁输出的，而不是真正的
邮箱，像这样：

From 8f72bad1baf19a53459661343e21d6491c3908d3 Mon Sep 17 00:00:00 2001
来自：托尼·拉克[电子邮件保护]>
日期：13 年 2010 月 11 日，星期二 42:54:0700 -XNUMX
Subject: [PATCH] =?UTF-8?q?[IA64]=20Put=20ia64=20config=20files=20on=20the=20?=
=?UTF-8?q?Uwe=20Kleine-K=C3=B6nig=20diet?=
MIME版本：1.0
内容类型：文本/纯文本； 字符集=UTF-8
内容传输编码：8bit

使用 python 脚本精简了 arch/arm 配置文件
(See commit c2330e286f68f1c408b4aa6515ba49d57f05beae comment)

对 ia64 做同样的事情，这样我们就可以拥有时尚和修剪的外观
...

通常它会被放置在 MUA 的草稿文件夹中，编辑以添加及时的评论
不应该在三个破折号之后进入变更日志，然后作为消息发送
在我们的示例中，body 以“arch/arm 配置文件是...”开头。 在接收端，
读者可以将有趣的补丁保存在 UNIX 邮箱中并使用 混帐（1）。

当补丁是正在进行的讨论的一部分时，补丁由 混帐 格式补丁 能够
进行调整以利用 混帐 am - 剪刀 特征。 在您回复后
讨论出现一条仅由“-->8--”（剪刀和穿孔）组成的行，
其次是删除了不必要的标头字段的补丁：

...
> 所以我们应该这样做。

我感觉合理。 这个补丁怎么样？

-->8 --
主题：[IA64] 将 ia64 配置文件放在 Uwe Kleine-König 饮食中

使用 python 脚本精简了 arch/arm 配置文件
...

以这种方式发送补丁时，大多数情况下您发送的是自己的补丁，因此另外
到“From $SHA1 $magic_timestamp”标记，您应该省略 From: 和 Date: 行
补丁文件。 补丁标题可能与讨论的主题不同
补丁是为了响应，因此您可能希望保留主题：
行，就像上面的例子。

检查 补丁 腐败
许多邮件程序如果设置不当会破坏空格。 这里有两种常见的类型
腐败：

· 没有的空上下文行 任何 空白。

· 在开头有一个额外空格的非空上下文行。

测试您的 MUA 是否设置正确的一种方法是：

· 完全按照您的方式将补丁发送给您自己，除了 To: 和 Cc: 行
不包含列表和维护者地址。

· 将该补丁保存到 UNIX 邮箱格式的文件中。 称之为 a.patch，比如说。

· 应用它：

$ git 获取大师：测试应用
$ git checkout 测试应用
$ git 重置 --hard
$ git am a.patch

如果应用不正确，可能有多种原因。

· 补丁本身应用不干净。 那是 坏 但没有太大关系
你的 MUA。 您可能希望使用 git 变基(1) 再生之前
在这种情况下。

· MUA 破坏了你的补丁； “am”会抱怨补丁不适用。 看
在 .git/rebase-apply/ 子目录中，看看有什么 补丁 文件包含并检查
上面提到的常见腐败模式。

· 同时，检查 info 和 最后提交 文件也是如此。 如果在什么 最后提交
不是您希望在提交日志消息中看到的内容，很可能
接收器最终会在应用您的补丁时手动编辑日志消息。
补丁电子邮件中的诸如“嗨，这是我的第一个补丁。\n”之类的内容应该出现在
三段划线表示提交消息的结束。

特定于 MUA HINTS

以下是有关如何使用各种邮件程序成功提交内联补丁的一些提示。

GMail的
GMail 没有任何方法可以关闭 Web 界面中的换行，因此它会
破坏您发送的任何电子邮件。 但是，您可以使用“git send-email”并发送您的
通过 GMail SMTP 服务器修补，或使用任何 IMAP 电子邮件客户端连接到
google IMAP 服务器并通过它转发电子邮件。

使用提示 混帐 发电子邮件 要通过 GMail SMTP 服务器发送您的补丁，请参阅
的示例部分 git 发送电子邮件（1）。

有关使用 IMAP 界面提交的提示，请参阅示例部分 git-imap-
提交（1）。

雷鸟
默认情况下，Thunderbird 会包装电子邮件并将它们标记为 格式=流动,
这两者都会使生成的电子邮件无法被 Git 使用。

有三种不同的方法：使用附加组件关闭换行，配置
Thunderbird 不破坏补丁，或使用外部编辑器防止 Thunderbird
修改补丁。

途径 #1 （添加在）
安装可从以下位置获得的 Toggle Word Wrap 插件
https://addons.mozilla.org/thunderbird/addon/toggle-word-wrap/ 它添加了一个菜单项
您可以勾选作曲家的“选项”菜单中的“启用自动换行”。 现在你可以
以其他方式撰写消息（剪切 + 粘贴， 混帐 格式补丁 | 混帐
imap-发送等），但您必须在任何文本中手动插入换行符
类型。

途径 #2 （配置）
三个步骤：

1. 将您的邮件服务器组合配置为纯文本：编辑...帐户
设置...组合和寻址，取消选中“在 HTML 中编写消息”。

2. 将您的常规合成窗口配置为不换行。

在 Thunderbird 2: Edit..Preferences..Composition 中，将纯文本消息包装在 0

在 Thunderbird 3 中：Edit..Preferences..Advanced..Config Editor。 搜索
“mail.wrap_long_lines”。 切换它以确保它被设置为 false。 另外，搜索
对于“mailnews.wraplength”并将值设置为 0。

3. 禁用 format=flowed: Edit..Preferences..Advanced..Config Editor。
搜索“mailnews.send_plaintext_flowed”。 切换它以确保它被设置为
假。

完成后，您应该能够像其他方式一样撰写电子邮件（剪切 +
糊， 混帐 格式补丁 | 混帐 imap-发送等），并且补丁不会被破坏。

途径 #3 （外部的 编辑）
需要以下 Thunderbird 扩展：AboutConfig 来自
http://aboutconfig.mozdev.org/ 和外部编辑器来自
http://globs.org/articles.php?lng=en&pg=8

1. 使用您选择的方法将补丁准备为文本文件。

2. 在打开撰写窗口之前，使用编辑→帐户设置取消选中“撰写
HTML 格式的邮件”设置中的“组合和寻址”面板
用于发送补丁的帐户。

3. 在 Thunderbird 主窗口中， before 你打开补丁的撰写窗口，
使用 Tools→about:config 将以下内容设置为指示值：

mailnews.send_plaintext_flowed => false
mailnews.wraplength => 0

4. 打开撰写窗口并单击外部编辑器图标。

5.在外部编辑器窗口中，读入补丁文件并退出编辑器
一般。

旁注：可以使用 about:config 和以下内容执行第 2 步
设置，但还没有人尝试过。

mail.html_compose => 假
mail.identity.default.compose_html => false
mail.identity.id?.compose_html => false

contrib/thunderbird-patch-inline 中有一个脚本可以帮助您包括
以简单的方式与 Thunderbird 打补丁。 要使用它，请执行上述步骤，然后使用
脚本作为外部编辑器。

KMail的
这应该可以帮助您使用 KMail 内联提交补丁。

1. 准备补丁为文本文件。

2. 单击新邮件。

3. 在 Composer 窗口中的“选项”下，确保没有设置“自动换行”。

4. 使用 Message → Insert file... 并插入补丁。

5. 返回撰写窗口：在消息中添加您想要的任何其他文本，完成
地址和主题字段，然后按发送。

示例

· 提取修订版 R1 和 R2 之间的提交，并将它们应用到当前版本之上
分支使用 混帐 am 挑选它们：

$ git 格式补丁 -k --stdout R1..R2 | git am -3 -k

· 提取当前分支中但不在源分支中的所有提交：

$ git 格式补丁来源

对于每次提交，都会在当前目录中创建一个单独的文件。

· 提取所有导致 起源 自项目启动以来：

$ git 格式补丁 --root 来源

· 与上一个相同：

$ git 格式补丁 -M -B 起源

此外，它还可以智能地检测和处理重命名并完成重写
生成重命名补丁。 重命名补丁减少了文本输出量，并且
通常更容易审查。 请注意，非 Git“补丁”程序不会
了解重命名补丁，所以只有当你知道接收者使用 Git 时才使用它
应用你的补丁。

· 从当前分支中提取三个最顶层的提交并将它们格式化为可通过电子邮件发送
补丁：

$ git 格式补丁 -3

使用 onworks.net 服务在线使用 git-format-patch