.mailmap: Add a stub with documentation

The .mailmap git feature helps fixing commit mistakes (in name/email).

The easiest way to use it is with the --use-mailmap flag:

  $ git log --use-mailmap

See:
* https://git-scm.com/docs/git-shortlog#_mapping_authors
* https://git-scm.com/docs/git-check-mailmap#_mapping_authors

Reviewed-by: Laszlo Ersek <lersek@redhat.com>
Signed-off-by: Philippe Mathieu-Daude <philmd@redhat.com>
Message-Id: <20200106115415.11624-2-philmd@redhat.com>

diff --git a/.mailmap b/.mailmap
new file mode 100644 (file)
index 0000000..6d88189
--- /dev/null
+++ b/.mailmap
@@ -0,0 +1,11 @@
+#\r
+# This list is used by git-shortlog to fix a few botched name translations\r
+# in the git archive, either because the author's full name was messed up\r
+# and/or not always written the same way, making contributions from the\r
+# same person appearing not to be so or badly displayed.\r
+#\r
+# Please keep this file sorted alphabetically, and email in lowercase.\r
+# The format used is:\r
+#\r
+#   Firstname Lastname <email@domain.tld>\r
+#\r