正确使用git检查-mailmap

Question

上下文

在所讨论的项目的根处有一个.mailmap文件。它包括这样的条目：

Some User <some.user@company.com> <someuser@private.com>
Some User <some.user@company.com> <dev5@company.com>
Another User <another.user@company.com> <another.user@private.com>
...

我找到了关于使用git check-mailmap检索任何给定用户的规范联系人数据的文档。

https://git-scm.com/docs/git-check-mailmap

问题

简单的问题，我没有找到一个简明的答案--如何正确地使用命令？

文档提供了如下语法：

git check-mailmap [<options>] <contact>

然而，输入例如：

git check-mailmap some.user@company.com
git check-mailmap Some User
git check-mailmap --std

产生的结果只有

fatal: unable to parse contact ...

此外，我进入git check-mailmap --help是为了寻找更多的信息，但在我看来，提供的HTML相当于我之前链接的页面。

那么，如何正确地使用git check-mailmap呢？

Answer 1

多亏了“博士学位”，才发现了一条安乐死。如需详细信息，请参阅开场白下的评论部分。

用于调用git check-mailmap的语法是不正确的：

git check-mailmap some.user@company.com
git check-mailmap Some User
git check-mailmap --std

相反，为了检索规范别名，需要提供用户名和相应的地址。

在给定的示例中，有效调用可能如下所示：

git check-mailmap 'Some User <someuser@private.com>'

并且应该屈服：

Some User <some.user@company.com>

检查.mailmap有效性的一个简便方法是使用git shortlog -se。