uTools-Manuals/docs/git/git check-mailmap.html

<div class="c-markdown doc-markdown"><div class="doc-postil"><div class="c-markdown"><h2>名称</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>git-check-mailmap  - 显示联系人的规范名称和电子邮件地址</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>概要</h2></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">git check-mailmap [options] &lt;contact&gt;…</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><h2>描述</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>对于命令行或标准输入（使用时<code>--stdin</code>）中的每个“Name user @ host”或“user @ host” ，请查找此人的规范名称和电子邮件地址（请参阅下面的“映射作者”）。如果找到，打印出来；否则按原样打印输入。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>选项</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>--stdin</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在耗尽命令行中提供的联系人之后，从标准输入读取每行一个联系人。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>输出</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>对于每个联系人，输出一行，以换行符结尾。如果名称被提供或已知<code>mailmap</code>，则打印“名称用户@主机”; 否则只打印“user @ host”。</p></div></div><div class="doc-postil"><div class="c-markdown"><h2>映射作者</h2></div></div><div class="doc-postil"><div class="c-markdown"><p>如果文件<code>.mailmap</code>存在于版本库的顶层，或者位于 mailmap.file 或 mailmap.blob 配置选项指向的位置，则它用于将作者和提交者名称以及电子邮件地址映射到规范的实名和电子邮件地址。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>在简单的形式中，文件中的每一行由作者的标准真实姓名，空格以及在提交中使用的电子邮件地址（用<code>&lt;</code>and 括起来<code>&gt;</code>）映射到名称。例如：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">Proper Name &lt;commit@email.xx&gt;</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>更复杂的形式是：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">&lt;proper@email.xx&gt; &lt;commit@email.xx&gt;</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>它允许 mailmap 只替换提交的电子邮件部分，并且：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">Proper Name &lt;proper@email.xx&gt; &lt;commit@email.xx&gt;</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>它允许 mailmap 替换与指定的提交电子邮件地址匹配的提交的名称和电子邮件，以及：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">Proper Name &lt;proper@email.xx&gt; Commit Name &lt;commit@email.xx&gt;</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>它允许 mailmap 替换与指定的提交名称和电子邮件地址相匹配的提交的名称和电子邮件。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>示例1：您的历史记录包含两位作者 Jane 和 Joe 的提交，他们的名字以几种形式出现在存储库中：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">Joe Developer &lt;joe@example.com&gt;Joe R. Developer &lt;joe@example.com&gt;Jane Doe &lt;jane@example.com&gt;Jane Doe &lt;jane@laptop.(none)&gt;Jane D. &lt;jane@desktop.(none)&gt;</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>现在假设乔想让他的中间名得到最初的使用，而珍则更喜欢将她的姓氏完整地拼出来。一个合适的<code>.mailmap</code>文件应该是这样的：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">Jane Doe         &lt;jane@desktop.(none)&gt;Joe R. Developer &lt;joe@example.com&gt;</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>注意如何不需要输入<code>&lt;jane@laptop.(none)&gt;</code>，因为该作者的真实姓名已经是正确的。</p></div></div><div class="doc-postil"><div class="c-markdown"><p>示例2：您的存储库包含以下作者的提交：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">nick1 &lt;bugs@company.xx&gt;nick2 &lt;bugs@company.xx&gt;nick2 &lt;nick2@company.xx&gt;santa &lt;me@company.xx&gt;claus &lt;me@company.xx&gt;CTO &lt;cto@coompany.xx&gt;</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>那么你可能需要一个如下所示的<code>.mailmap</code>文件：</p></div></div><div class="doc-postil"><div class="c-markdown"><pre><code class="language-Bash">&lt;cto@company.xx&gt;                       &lt;cto@coompany.xx&gt;Some Dude &lt;some@dude.xx&gt;         nick1 &lt;bugs@company.xx&gt;Other Author &lt;other@author.xx&gt;   nick2 &lt;bugs@company.xx&gt;Other Author &lt;other@author.xx&gt;         &lt;nick2@company.xx&gt;Santa Claus &lt;santa.claus@northpole.xx&gt; &lt;me@company.xx&gt;</code></pre></div></div><div class="doc-postil"><div class="c-markdown"><p>将散列<code>#</code>用于自己的行中或电子邮件地址之后的注释。</p></div></div></div>