[PATCH] D103360: Add a toplevel .mailmap file

[Nico Weber via Phabricator via llvm-commits]

thakis marked an inline comment as done.
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:
> 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 :-)
added


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

https://reviews.llvm.org/D103360