[PATCH] D103360: Add a toplevel .mailmap file

[Nico Weber via Phabricator via llvm-commits]

thakis added inline comments.


================
Comment at: .mailmap:3
+# names to a single canonical one for `git shortlog`, `git log --author`,
+# or `git check-mailmap`.
+#
----------------
mstorsjo wrote:
> Maybe one can mention that this also can be useful for just canonicalizing/merging various spellings of the name even if they use just one email address.
I was trying to say that with "mapping … email addresses and names to a single canonical one". Do you have a suggestion for how to make that more clear?

Maybe we could add:

```
For example, if you commit as `random.person at example.com` but sometimes use "Rañdom Person" and sometimes "Random Person" as name and you want the former to be your canonical name, add

    Rañdom Person <random.person at example.com>

If you commit as both `random.person at example.com` and `ranp at example.com` and you want the former to be your canonical email address, add

  <random.person at example.com> <ranp at example.com>

Combinations of both are possible too, see https://git-scm.com/docs/gitmailmap for format details.
```

Would that help?

Concrete change suggestions for the text that's here are also very welcome :)


CHANGES SINCE LAST ACTION
  https://reviews.llvm.org/D103360/new/

https://reviews.llvm.org/D103360