?
This document uses PHP Chinese website manual Release
git-check-mailmap - 顯示聯(lián)系人的規(guī)范名稱和電子郵件地址
git check-mailmap [options] <contact>…
對(duì)于命令行或標(biāo)準(zhǔn)輸入(使用時(shí)--stdin
)中的每個(gè)“Name user @ host”或“user @ host” ,請(qǐng)查找此人的規(guī)范名稱和電子郵件地址(請(qǐng)參閱下面的“映射作者”)。如果找到,打印出來(lái);否則按原樣打印輸入。
--stdin
在耗盡命令行中提供的聯(lián)系人之后,從標(biāo)準(zhǔn)輸入讀取每行一個(gè)聯(lián)系人。
對(duì)于每個(gè)聯(lián)系人,輸出一行,以換行符結(jié)尾。如果名稱被提供或已知mailmap
,則打印“名稱用戶@主機(jī)”; 否則只打印“user @ host”。
如果文件.mailmap
存在于版本庫(kù)的頂層,或者位于 mailmap.file 或 mailmap.blob 配置選項(xiàng)指向的位置,則它用于將作者和提交者名稱以及電子郵件地址映射到規(guī)范的實(shí)名和電子郵件地址。
在簡(jiǎn)單的形式中,文件中的每一行由作者的標(biāo)準(zhǔn)真實(shí)姓名,空格以及在提交中使用的電子郵件地址(用<
and 括起來(lái)>
)映射到名稱。例如:
Proper Name <commit@email.xx>
更復(fù)雜的形式是:
<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)在存儲(chǔ)庫(kù)中:
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)在假設(shè)喬想讓他的中間名得到最初的使用,而珍則更喜歡將她的姓氏完整地拼出來(lái)。一個(gè)合適的.mailmap
文件應(yīng)該是這樣的:
Jane Doe <jane@desktop.(none)>Joe R. Developer <joe@example.com>
注意如何不需要輸入<jane@laptop.(none)>
,因?yàn)樵撟髡叩恼鎸?shí)姓名已經(jīng)是正確的。
示例2:您的存儲(chǔ)庫(kù)包含以下作者的提交:
nick1 <bugs@company.xx>nick2 <bugs@company.xx>nick2 <nick2@company.xx>santa <me@company.xx>claus <me@company.xx>CTO <cto@coompany.xx>
那么你可能需要一個(gè)如下所示的.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>
將散列#
用于自己的行中或電子郵件地址之后的注釋。