uTools-Manuals/docs/git/git send-email.html
2019-04-08 23:22:26 +08:00

10 lines
28 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<div class="c-markdown doc-markdown"><div class="doc-postil"><div class="c-markdown"><h2>名称Name</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>git-send-email  - 以电子邮件的形式发送一组补丁</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>Synopsis</h2></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">git send-email [options] &lt;file|directory|rev-list options&gt;
git send-email --dump-aliases</pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>接受命令行上给出的补丁并将其发送出去。修补程序可以指定为文件目录这将发送目录中的所有文件或直接作为修订列表。在最后一种情况下git-format-patch [1]接受的任何格式都可以传递给 git send-email。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>电子邮件的标题可通过命令行选项进行配置。如果未在命令行中指定,则系统将提示用户使用启用了 ReadLine 的接口来提供必要的信息。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>接受补丁文件有两种格式:</p></div></div><div class="doc-postil"><div class="c-markdown"><ol class="ol-level-0 list-paddingleft-2"><li><p>mbox 格式文件这是 git-format-patch [1]生成的内容。大多数标题和 MIME 格式都会被忽略。</p></li><li><p>Greg Kroah-Hartman <code>send_lots_of_email.pl</code>脚本使用的原始格式此格式预期文件的第一行包含消息的“Cc”值和“Subject”作为第二行。</p></li></ol></div></div><div class="doc-postil"><div class="c-markdown"><h2>选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><h3>构成</h3></div></div><div class="doc-postil"><div class="c-markdown"><p>--annotate</p></div></div><div class="doc-postil"><div class="c-markdown"><p>查看并编辑您即将发送的每个补丁。默认值是<code>sendemail.annotate</code>。请参阅 CONFIGURATION 部分<code>sendemail.multiEdit</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--bcc=&lt;address&gt;,…</p></div></div><div class="doc-postil"><div class="c-markdown"><p>为每封电子邮件指定一个“密件抄送:”值。默认值是<code>sendemail.bcc</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>此选项可能会多次指定。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--cc=&lt;address&gt;,…</p></div></div><div class="doc-postil"><div class="c-markdown"><p>为每封电子邮件指定一个开始的“抄送:”值。默认值是<code>sendemail.cc</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>此选项可能会多次指定。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--compose</p></div></div><div class="doc-postil"><div class="c-markdown"><p>调用文本编辑器(请参阅 git-var [1]中的 GIT_EDITOR以编辑补丁系列的介绍性消息。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>何时<code>--compose</code>使用git send-email 将使用消息中指定的 FromSubject 和 In-Reply-To头。如果邮件正文在标题和空白行之后键入的内容仅包含空白或 Git前缀则不会发送摘要但发件人主题和收件人回复标题将除非被移除否则应该使用。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>缺少 From 或 In-Reply-To 头将被提示输入。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>请参阅 CONFIGURATION 部分<code>sendemail.multiEdit</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--from=&lt;address&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定电子邮件的发件人。如果未在命令行中指定,<code>sendemail.from</code>则使用配置选项的值。如果没有设置命令行选项<code>sendemail.from</code>,则会提示用户输入值。提示的缺省值将是 GIT_AUTHOR_IDENT 或 GIT_COMMITTER_IDENT 的值如果未设置则返回“git var -l”。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--in-reply-to=&lt;identifier&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>使第一封邮件(或所有邮件<code>--no-thread</code>)显示为对给定 Message-Id 的回复,从而避免中断线程以提供新的补丁系列。根据设置,第二封和随后的电子邮件将作为回复发送<code>--[no-]chain-reply-to</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>因此,例如,当<code>--thread</code><code>--no-chain-reply-to</code>被指定,第二和后续的补丁将是回复到第一个像在下面,其中插图<code>[PATCH v2 0/3]</code>是答复<code>[PATCH 0/2]</code></p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">[PATCH 0/2] Here is what I did...  [PATCH 1/2] Clean up and tests  [PATCH 2/2] Implementation  [PATCH v2 0/3] Here is a reroll    [PATCH v2 1/3] Clean up    [PATCH v2 2/3] New tests    [PATCH v2 3/3] Implementation</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>只有在--compose 也被设置时才有必要。如果--compose 未设置,则会提示输入。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--subject=&lt;string&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定电子邮件线索的初始主题。只有在--compose 也被设置时才有必要。如果--compose 未设置,则会提示输入。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--to=&lt;address&gt;,…</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定生成的电子邮件的主要收件人。一般来说,这将是所涉及项目的上游维护者。默认值是<code>sendemail.to</code>配置值的值; 如果未指定,并且未指定--to-cmd则会提示此处。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>该选项可能会多次指定。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--8bit-encoding=&lt;encoding&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>遇到非 ASCII 消息或未声明其编码的主题时,请添加标题/引用以指示它在&lt;编码&gt;中编码。默认值是该值<code>sendemail.assume8bitEncoding</code>; 如果未指定则会提示是否遇到任何非ASCII文件。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>请注意,没有任何尝试验证编码。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--compose-encoding=&lt;encoding&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定撰写邮件的编码。默认值是该值<code>sendemail.composeencoding</code>; 如果没有指定,则假定为 UTF-8。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--transfer-encoding=(7bit|8bit|quoted-printable|base64)</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定用于通过 SMTP 发送消息的传输编码。遇到非 ASCII 消息时7bit将失败。当存储库包含包含回车符的文件时quoted-printable 可能很有用,但会使原始修补程序电子邮件文件(如从 MUA 保存的文件难以手动检查。base64 更加笨手笨脚,但也更加不透明。默认值是<code>sendemail.transferEncoding</code>配置值的值; 如果没有指定git 将使用8位而不添加 Content-Transfer-Encoding 标头。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--xmailer   --no-xmailer</p></div></div><div class="doc-postil"><div class="c-markdown"><p>添加或阻止添加“X-Mailer”标题。默认情况下添加标题但可以通过设置<code>sendemail.xmailer</code>配置变量来关闭标题<code>false</code></p></div></div><div class="doc-postil"><div class="c-markdown"><h3>发出</h3></div></div><div class="doc-postil"><div class="c-markdown"><p>--envelope-sender=&lt;address&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定用于发送电子邮件的信封发件人。如果您的默认地址不是订阅列表的地址,这很有用。为了使用<code>From</code>地址请将该值设置为“auto”。如果使用 sendmail 二进制文件,则必须具有-f参数的适当权限。默认值是<code>sendemail.envelopeSender</code>配置变量的值; 如果没有指定,选择信封发件人留给您的 MTA。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-encryption=&lt;encryption&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定要使用的加密,<code>ssl</code>或者<code>tls</code>。任何其他值都会恢复为普通 SMTP。默认值是<code>sendemail.smtpEncryption</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-domain=&lt;FQDN&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定在 SMTP 服务器的 HELO / EHLO 命令中使用的完全限定的域名FQDN。一些服务器需要 FQDN 来匹配您的 IP 地址。如果未设置git send-email会自动尝试确定您的 FQDN。默认值是<code>sendemail.smtpDomain</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-auth=&lt;mechanisms&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>空白分隔的允许的 SMTP-AUTH 机制列表。该设置强制只使用列出的机制。例:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">$ git send-email --smtp-auth="PLAIN LOGIN GSSAPI" ...</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>如果至少有一个指定的机制与 SMTP 服务器通告的机制匹配,并且所用的 SASL 库支持该机制,则使用该机制进行身份验证。如果既没有<code>sendemail.smtpAuth</code>也没有<code>--smtp-auth</code>指定,可以使用 SASL 库支持的所有机制。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-pass=&lt;password&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>SMTP-AUTH 的密码。该参数是可选的:如果未指定参数,则将使用空字符串作为密码。默认值是值<code>sendemail.smtpPass</code>,但<code>--smtp-pass</code>总是覆盖此值。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>此外,密码不需要在配置文件或命令行中指定。如果指定了用户名(带有<code>--smtp-user</code><code>sendemail.smtpUser</code>),但没有指定密码(带有<code>--smtp-pass</code><code>sendemail.smtpPass</code>),则使用密码获取<code>git-credential</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-server=&lt;host&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果设置,则指定要使用的传出 SMTP 服务器(例如,<code>smtp.example.com</code>或原始IP地址。或者它可以指定类似 sendmail 的程序的完整路径名; 该计划必须支持该<code>-i</code>选项。默认值可以由<code>sendemail.smtpServer</code>配置选项指定; 内置的默认是<code>/usr/sbin/sendmail</code>或者<code>/usr/lib/sendmail</code>如果这样的程序是可用的,<code>localhost</code>否则。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-server-port=&lt;port&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定一个与默认端口不同的端口SMTP 服务器通常监听 smtp 端口25但也可以侦听提交端口587或公共 SSL smtp 端口465; 符号端口名称(例如“提交”而不是 587也被接受。该端口也可以通过<code>sendemail.smtpServerPort</code>配置变量进行设置。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-server-option=&lt;option&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果设置,则指定要使用的传出 SMTP 服务器选项。默认值可以由<code>sendemail.smtpServerOption</code>配置选项指定。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>对于要传递给服务器的每个选项,必须重复--smtp-server-option 选项。同样,每个选项都必须使用配置文件中的不同行。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-ssl</p></div></div><div class="doc-postil"><div class="c-markdown"><p>旧版别名<code>--smtp-encryption ssl</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-ssl-cert-path</p></div></div><div class="doc-postil"><div class="c-markdown"><p>用于 SMTP SSL / TLS 证书验证的可信 CA 证书存储区的路径(可以是经过处理的目录,也可以是<code>c_rehash</code>包含一个或多个连接在一起的PEM格式证书的单个文件请参阅 verify1-CAfile 和 -CApath for 关于这些的更多信息)。将其设置为空字符串以禁用证书验证。默认为<code>sendemail.smtpsslcertpath</code>配置变量的值(如果设置),否则默认情况下支持 SSL 库的编译默认值(这应该是大多数平台上的最佳选择)。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-user=&lt;user&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>SMTP-AUTH 的用户名。默认值是<code>sendemail.smtpUser</code>; 的值。如果没有指定用户名(使用<code>--smtp-user</code><code>sendemail.smtpUser</code>),则不会尝试进行身份验证。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--smtp-debug=0|1</p></div></div><div class="doc-postil"><div class="c-markdown"><p>启用1或禁用0调试输出。如果启用将打印 SMTP 命令和回复。用于调试 TLS 连接和身份验证问题。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--batch-size=&lt;num&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>一些电子邮件服务器(例如 smtp.163.com会限制每个会话连接发送的电子邮件数量这会在发送多条消息时导致失败。使用此选项send-email 将在发送$ &lt;num&gt;消息并等待几秒钟(请参阅--relogin-delay并重新连接后断开连接以解决此限制。您可能需要使用某种形式的凭证帮助程序以避免每次发生这种情况时都必须重新输入密码。缺省为<code>sendemail.smtpBatchSize</code>配置变量。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--relogin-delay=&lt;int&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在重新连接到 SMTP 服务器之前等待$ &lt;int&gt;秒。与--batch-size 选项一起使用。缺省为<code>sendemail.smtpReloginDelay</code>配置变量。</p></div></div><div class="doc-postil"><div class="c-markdown"><h3>自动化</h3></div></div><div class="doc-postil"><div class="c-markdown"><p>--to-cmd=&lt;command&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定一个命令为每个补丁文件执行一次该文件应生成特定于补丁文件的“To”条目。此命令的输出必须是每行一个电子邮件地址。默认值是<code>sendemail.tocmd</code>配置值的值。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--cc-cmd=&lt;command&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定一个命令为每个补丁文件执行一次该文件应生成补丁文件特定的“Cc”条目。此命令的输出必须是每行一个电子邮件地址。默认值是<code>sendemail.ccCmd</code>配置值的值。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-chain-reply-to</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果已设置,每封电子邮件将作为对以前发送的电子邮件的回复发送。如果使用“--no-chain-reply-to”禁用则首先发送的所有电子邮件将作为回复发送给第一封电子邮件。当使用这个时建议给出的第一个文件是整个补丁系列的概述。默认情况下禁用<code>sendemail.chainReplyTo</code>可以使用配置变量启用它。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--identity=&lt;identity&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>配置标识。给出时,导致<code>sendemail.&lt;identity&gt;</code><code>sendemail</code>部分中的值优先于部分中的值。默认标识是的值<code>sendemail.identity</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-signed-off-by-cc</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果已设置,请将添加到 Signed-off-by 或 Cc行中的电子邮件添加到cc列表。默认值是<code>sendemail.signedoffbycc</code>配置值的值; 如果没有指定,默认为 --signed-off-by-cc。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-cc-cover</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果已设置则在该系列的第一个补丁通常为求职信中的Cc标题中找到的电子邮件将添加到每个电子邮件集的cc列表中。默认值是<code>sendemail.cccover</code>配置值的值; 如果未指定,则默认为--no-cc-cover。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-to-cover</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果已设置,则在系列的第一个补丁(通常为求职信)中的“收件人:”标题中找到的电子邮件将添加到每个电子邮件集的列表中。默认值是<code>sendemail.tocover</code>配置值的值; 如果未指定,则默认为 - 不覆盖。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--suppress-cc=&lt;category&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>指定一个额外的收件人类别以禁止以下的自动抄送:</p></div></div><div class="doc-postil"><div class="c-markdown"><ul class="ul-level-0 list-paddingleft-2" style="margin: 10px 0px 10px 20px;"><li><p><code>author</code> 将避免包括修补程序作者</p></li><li><p><code>self</code> 将避免包括发件人</p></li><li><p><code>cc</code>将避免在修补程序头文件中包含Cc行中提到的任何人除了self<code>self</code>用于此目的)。</p></li><li><p><code>bodycc</code>将避免包括在补丁体提交消息中的Cc行中提到的任何人除了self<code>self</code>用于此)外。</p></li><li><p><code>sob</code>将避免包括在自签名外的任何人(除此之外<code>self</code>)。</p></li><li><p><code>cccmd</code> 将避免运行--cc-cmd。</p></li><li><p><code>body</code>相当于<code>sob</code>+<code>bodycc</code></p></li><li><p><code>all</code> 将抑制所有自动cc值。</p></li></ul></div></div><div class="doc-postil"><div class="c-markdown"><p>默认值是<code>sendemail.suppresscc</code>配置值的值; 如果没有指定,则默认为 - <code>self</code>如果指定了--suppress-from并且指定了<code>body</code>--no-signed-off-cc。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-suppress-from</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果已设置请不要将发件人地址添加到cc列表。默认值是<code>sendemail.suppressFrom</code>配置值的值; 如果未指定,则默认为--no-suppress-from。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-thread</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果设置了此项,则会将 In-Reply-To 和 References 标题添加到发送的每封电子邮件中。每个邮件是指以前的电子邮件(<code>deep</code>每个<code>git format-patch</code>字词的线程)还是第一封电子邮件(<code>shallow</code>线程)都由“--no-chain-reply-to”来管理。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果使用“--no-thread”禁用则不会添加这些标头除非用--in-reply-to指定。默认值是<code>sendemail.thread</code>配置值的值; 如果未指定,则默认为--thread。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>用户需要确保在<code>git send-email</code>被要求添加 In-Reply-To 头时已经存在(特别是<code>git format-patch</code>可以配置为自己执行线程。如果不这样做可能无法在收件人的MUA中产生预期结果。</p></div></div><div class="doc-postil"><div class="c-markdown"><h3>管理</h3></div></div><div class="doc-postil"><div class="c-markdown"><p>--confirm=&lt;mode&gt;</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在发送之前确认:</p></div></div><div class="doc-postil"><div class="c-markdown"><ul class="ul-level-0 list-paddingleft-2" style="margin: 10px 0px 10px 20px;"><li><p><code>always</code> 在发送之前会一直确认</p></li><li><p><code>never</code> 发送前绝不会确认</p></li><li><p><code>cc</code> 将在发送之前确认发送电子邮件已自动将补丁中的地址添加到Cc列表</p></li><li><p><code>compose</code> 将在使用--compose时发送第一条消息之前进行确认。</p></li><li><p><code>auto</code>相当于<code>cc</code>+<code>compose</code></p></li></ul></div></div><div class="doc-postil"><div class="c-markdown"><p>默认值是<code>sendemail.confirm</code>配置值的值; 如果未指定,则默认为<code>auto</code>除非指定了任何禁止选项,在这种情况下,默认值为<code>compose</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--dry-run</p></div></div><div class="doc-postil"><div class="c-markdown"><p>除了实际发送电子邮件之外,别做任何事</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-format-patch</p></div></div><div class="doc-postil"><div class="c-markdown"><p>当参数可以理解为参考或文件名时选择将其理解为format-patch参数<code>--format-patch</code>)或文件名(<code>--no-format-patch</code>。默认情况下当发生这种冲突时git send-email 将会失败。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--quiet</p></div></div><div class="doc-postil"><div class="c-markdown"><p>让 git-send-email 不那么冗长。每封电子邮件一行应该是输出的全部内容。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>--no-validate</p></div></div><div class="doc-postil"><div class="c-markdown"><p>对补丁执行完整性检查。目前,验证意味着以下内容:</p></div></div><div class="doc-postil"><div class="c-markdown"><ul class="ul-level-0 list-paddingleft-2" style="margin: 10px 0px 10px 20px;"><li><p>调用 sendemail-validate 挂钩(如果存在)(请参阅 githooks [5])。</p></li><li><p>警告包含超过998个字符的行; 这是由于 <strong>http://www.ietf.org/rfc/rfc2821.txt中</strong>描述的 SMTP 限制。</p></li></ul></div></div><div class="doc-postil"><div class="c-markdown"><p>默认值是<code>sendemail.validate</code>; 的值。如果未设置,则默认为<code>--validate</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>--force</p></div></div><div class="doc-postil"><div class="c-markdown"><p>发送电子邮件即使安全检查会阻止它。</p></div></div><div class="doc-postil"><div class="c-markdown"><h3>信息</h3></div></div><div class="doc-postil"><div class="c-markdown"><p>--dump-aliases</p></div></div><div class="doc-postil"><div class="c-markdown"><p>代替正常操作,从配置的别名文件中转储简写别名,每行按字母顺序排列一个。请注意,这只包含别名,不包括其扩展的电子邮件地址。查看<code>sendemail.aliasesfile</code>关于别名的更多信息。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>组态</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>sendemail.aliasesFile</p></div></div><div class="doc-postil"><div class="c-markdown"><p>为避免输入长电子邮件地址,请将其指向一个或多个电子邮件别名文件。你还必须提供<code>sendemail.aliasFileType</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>sendemail.aliasFileType</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在 sendemail.aliasesFile 中指定的文件格式。必须是一<code>mutt</code><code>mailrc</code><code>pine</code><code>elm</code>其中之一,或<code>gnus</code>,或<code>sendmail</code></p></div></div><div class="doc-postil"><div class="c-markdown"><p>在同一个名字的电子邮件程序的文档中可以找到每种格式的别名文件。标准格式的差异和局限性如下所述:</p></div></div><div class="doc-postil"><div class="c-markdown"><p>发送邮件     sendmail </p></div></div><div class="doc-postil"><div class="c-markdown"><ul class="ul-level-0 list-paddingleft-2" style="margin: 10px 0px 10px 20px;"><li><p>引用的别名和引用地址不受支持:包含<code>"</code>符号的行将被忽略。</p></li><li><p>不支持重定向到文件(<code>/path/name</code>)或管道(<code>|command</code>)。</p></li><li><p>文件包含(<code>:include: /path/name</code>)不受支持。</p></li><li><p>对于任何显式不支持的构造以及解析器无法识别的其他行,将在标准错误输出上显示警告。</p></li></ul></div></div><div class="doc-postil"><div class="c-markdown"><p>sendemail.multiEdit</p></div></div><div class="doc-postil"><div class="c-markdown"><p>如果为 true默认则会生成单个编辑器实例以编辑您必须编辑的文件使用补丁时<code>--annotate</code>,使用摘要时<code>--compose</code>)。如果为 false则文件将依次编辑每次产生一个新的编辑器。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>sendemail.confirm</p></div></div><div class="doc-postil"><div class="c-markdown"><p>设置发送前是否确认的默认值。必须是<code>always</code><code>never</code><code>cc</code><code>compose</code>,或<code>auto</code>其中之一。请参阅<code>--confirm</code>上一节中这些值的含义。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>示例</h2></div></div><div class="doc-postil"><div class="c-markdown"><h3>使用 Gmail 作为 smtp 服务器</h3></div></div><div class="doc-postil"><div class="c-markdown"><p><code>git send-email</code>通过 GMail SMTP 服务器发送补丁,请编辑〜/ .gitconfig 指定您的帐户设置:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">[sendemail]
        smtpEncryption = tls
        smtpServer = smtp.gmail.com
        smtpUser = yourname@gmail.com
        smtpServerPort = 587</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>如果您的 gmail 帐户有多因素身份验证设置,则需要生成特定于应用程序的密码以供使用<code>git send-email</code>。访问 <strong>https://security.google.com/settings/security/apppasswords </strong>以设置应用专用密码。安装完成后,您可以使用凭据助手来存储它:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">$ git credential fill
protocol=smtp
host=smtp.gmail.com
username=youname@gmail.com
password=app-password</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>一旦您的提交已准备好发送到邮件列表,请运行以下命令:</p></div></div><div class="doc-postil"><div class="c-markdown"><pre class="prism-token token language-javascript">$ git format-patch --cover-letter -M origin/master -o outgoing/$ edit outgoing/0000-*$ git send-email outgoing/*</pre></div></div><div class="doc-postil"><div class="c-markdown"><p>注意:需要以下 perl 模块 Net :: SMTP :: SSLMIME :: Base64 和 Authen :: SASL</p></div></div></div>