?
本文檔使用 php中文網(wǎng)手冊 發(fā)布
名稱
git-check-mailmap - 顯示聯(lián)系人的規(guī)范名稱和電子郵件地址
概要
git check-mailmap [options] <contact>…
描述
對于命令行或標準輸入（使用時--stdin）中的每個“Name user @ host”或“user @ host” ，請查找此人的規(guī)范名稱和電子郵件地址（請參閱下面的“映射作者”）。如果找到，打印出來；否則按原樣打印輸入。
選項
--stdin
在耗盡命令行中提供的聯(lián)系人之后，從標準輸入讀取每行一個聯(lián)系人。
輸出
對于每個聯(lián)系人，輸出一行，以換行符結尾。如果名稱被提供或已知mailmap，則打印“名稱用戶@主機”; 否則只打印“user @ host”。
映射作者
如果文件.mailmap存在于版本庫的頂層，或者位于 mailmap.file 或 mailmap.blob 配置選項指向的位置，則它用于將作者和提交者名稱以及電子郵件地址映射到規(guī)范的實名和電子郵件地址。
在簡單的形式中，文件中的每一行由作者的標準真實姓名，空格以及在提交中使用的電子郵件地址（用<and 括起來>）映射到名稱。例如：
Proper Name <commit@email.xx>
更復雜的形式是：
<proper@email.xx> <commit@email.xx>
它允許 mailmap 只替換提交的電子郵件部分，并且：
Proper Name <proper@email.xx> <commit@email.xx>
它允許 mailmap 替換與指定的提交電子郵件地址匹配的提交的名稱和電子郵件，以及：
Proper Name <proper@email.xx> Commit Name <commit@email.xx>
它允許 mailmap 替換與指定的提交名稱和電子郵件地址相匹配的提交的名稱和電子郵件。
示例1：您的歷史記錄包含兩位作者 Jane 和 Joe 的提交，他們的名字以幾種形式出現(xiàn)在存儲庫中：
Joe Developer <joe@example.com>Joe R. Developer <joe@example.com>Jane Doe <jane@example.com>Jane Doe <jane@laptop.(none)>Jane D. <jane@desktop.(none)>
現(xiàn)在假設喬想讓他的中間名得到最初的使用，而珍則更喜歡將她的姓氏完整地拼出來。一個合適的.mailmap文件應該是這樣的：
Jane Doe <jane@desktop.(none)>Joe R. Developer <joe@example.com>
注意如何不需要輸入<jane@laptop.(none)>，因為該作者的真實姓名已經(jīng)是正確的。
示例2：您的存儲庫包含以下作者的提交：
nick1 <bugs@company.xx>nick2 <bugs@company.xx>nick2 <nick2@company.xx>santa <me@company.xx>claus <me@company.xx>CTO <cto@coompany.xx>
那么你可能需要一個如下所示的.mailmap文件：
<cto@company.xx> <cto@coompany.xx>Some Dude <some@dude.xx> nick1 <bugs@company.xx>Other Author <other@author.xx> nick2 <bugs@company.xx>Other Author <other@author.xx> <nick2@company.xx>Santa Claus <santa.claus@northpole.xx> <me@company.xx>
將散列#用于自己的行中或電子郵件地址之后的注釋。