aboutsummaryrefslogtreecommitdiff
path: root/contrib
diff options
context:
space:
mode:
authorAlex Bennée <alex.bennee@linaro.org>2019-08-28 12:03:23 +0100
committerAlex Bennée <alex.bennee@linaro.org>2019-09-02 10:52:22 +0100
commitf4cf1edc3b897c5fbc82b388285de53b7f614ca8 (patch)
tree9948c7fdfc952b9fcff6d4652cbef7dfd33499f4 /contrib
parent1fed8f004465ce1cb6994b5d3de6fd7df91c4c33 (diff)
downloadqemu-f4cf1edc3b897c5fbc82b388285de53b7f614ca8.zip
qemu-f4cf1edc3b897c5fbc82b388285de53b7f614ca8.tar.gz
qemu-f4cf1edc3b897c5fbc82b388285de53b7f614ca8.tar.bz2
.mailmap/aliases: add some further commentary
The two files are not interchangeable but a change to one *might* require a change to the other so lets flag that up with an explanation of what both files are trying to achieve. While we are at it document the many forms .mailmap can take in the header. Signed-off-by: Alex Bennée <alex.bennee@linaro.org> Reviewed-by: Aleksandar Markovic <amarkovic@wavecomp.com>
Diffstat (limited to 'contrib')
-rw-r--r--contrib/gitdm/aliases20
-rw-r--r--contrib/gitdm/group-map-individuals3
2 files changed, 20 insertions, 3 deletions
diff --git a/contrib/gitdm/aliases b/contrib/gitdm/aliases
index 07fd339..c1e7443 100644
--- a/contrib/gitdm/aliases
+++ b/contrib/gitdm/aliases
@@ -1,6 +1,22 @@
#
-# This is the email aliases file, mapping secondary addresses
-# onto a single, canonical address. Duplicates some info from .mailmap
+# This is the email aliases file, mapping secondary addresses onto a
+# single, canonical address. It duplicates some info from .mailmap so
+# if you are adding something here also consider if the .mailmap needs
+# updating.
+#
+# If you just want to avoid gitdm complaining about author fields
+# which are actually email addresses with the message:
+#
+# "...is an author name, probably not what you want"
+#
+# you can just apply --use-mailmap to you git-log command, e.g:
+#
+# git log --use-mailmap --numstat --since "last 2 years" | $GITDM
+#
+# however that will have the effect of squashing multiple addresses to
+# a canonical address which will distort the stats of those who
+# contribute in both personal and professional capacities from
+# different addresses.
#
# weird commits
diff --git a/contrib/gitdm/group-map-individuals b/contrib/gitdm/group-map-individuals
index 05e355d..1c84717 100644
--- a/contrib/gitdm/group-map-individuals
+++ b/contrib/gitdm/group-map-individuals
@@ -2,7 +2,8 @@
# Individual and personal contributors
#
# This is simply to allow prolific developers with no company
-# affiliations to be grouped together in the summary stats.
+# affiliations (or non-company related personal work) to be grouped
+# together in the summary stats.
#
f4bug@amsat.org