[PATCH] D103360: Add a toplevel .mailmap file

[Martin Storsjö via Phabricator via llvm-commits]

mstorsjo added inline comments.


================
Comment at: .mailmap:3
+# names to a single canonical one for `git shortlog`, `git log --author`,
+# or `git check-mailmap`.
+#
----------------
thakis wrote:
> 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 :)
That sounds very concrete and understandable to me, thanks! Yeah I didn't have any good suggestions - I found it hard to consisely explain what I meant in my previous comment :-)


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

https://reviews.llvm.org/D103360