From patchwork Mon Sep 2 10:21:18 2019 Content-Type: text/plain; charset="utf-8" MIME-Version: 1.0 Content-Transfer-Encoding: 8bit X-Patchwork-Submitter: =?utf-8?q?Alex_Benn=C3=A9e?= X-Patchwork-Id: 172730 Delivered-To: patch@linaro.org Received: by 2002:a92:d204:0:0:0:0:0 with SMTP id y4csp4134811ily; Mon, 2 Sep 2019 03:27:29 -0700 (PDT) X-Google-Smtp-Source: APXvYqxWHm9g+FTePl0jkHFY+si0sEVKFb7iWvXADu1DI/6R21iu336njQUE21PE99DT4dXvie3n X-Received: by 2002:a05:620a:1367:: with SMTP id d7mr6649669qkl.20.1567420049232; Mon, 02 Sep 2019 03:27:29 -0700 (PDT) ARC-Seal: i=1; a=rsa-sha256; t=1567420049; cv=none; d=google.com; s=arc-20160816; b=0eHJ2VQ18gMayht+PuZSrtsclMlmLNbf1eaUjDlIpnQ2v04YPVOTbvv9PElof89g1L OJ3prftdn1VGkui2x5+u6YqlioHg/SxfYr4M8EAG8h3NrAehfvV7mvzTJnB1123uzrLa k28q1z25NFB0v2ITHytyCroCEj3YnnC46smswqJwN9B3jN1mQJzjENIOXMZtpt1RLsfw OOUp+DGY9Sv5Xf2klyif6FarCVos9hl65QlorJyj4WBwA0Tg+lusGmNnJO0sqOEa1opY HkaCXoilwtkMcl3XL7ACFllGOl0rj3IIjm3xxQqr6/3mb1khNcuLP4tMEyEVed6o6Otj YUhg== ARC-Message-Signature: i=1; a=rsa-sha256; c=relaxed/relaxed; d=google.com; s=arc-20160816; h=sender:errors-to:cc:list-subscribe:list-help:list-post:list-archive :list-unsubscribe:list-id:precedence:subject :content-transfer-encoding:mime-version:references:in-reply-to :message-id:date:to:from:dkim-signature; bh=FqjuG3RUHS3JckYSNiYZ0vObZ8wV+Y4/XOCXHmnveCo=; b=IqySBd/G/DK/lkOJRQ4cKc/1i5NOPj3U4RpgSbxweSc1lB8vNLK/BMYawa9pPhCBMs 1sqq3W9QZ4/HqO5nqMmhPsjt08PywFNJev2SR01BOREIc++E/gEVKyX6M+Sy1Z+AcqNe jGbjg4pQmSXOBAk4cHPB6KTxTFhERPpka7IQk+dlubzXVZ5QlVX4wdJgvyXdVFi1Ays3 /PE2I05YBEsZD++wKzTz8qUx7E4T3tsQRBeunSGTGU0PmVepDoUctdp4bhYhF2KdMeZG zin6CDE30wXs8ixk0pzJhsV5yEXs2ol0eG4tpFIJQGCgdjROnNNBOya5cghiwXZ1s2tt 8KIQ== ARC-Authentication-Results: i=1; mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=TqOHHbvC; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Return-Path: Received: from lists.gnu.org (lists.gnu.org. [209.51.188.17]) by mx.google.com with ESMTPS id o15si9306473qtg.26.2019.09.02.03.27.29 for (version=TLS1_2 cipher=ECDHE-RSA-CHACHA20-POLY1305 bits=256/256); Mon, 02 Sep 2019 03:27:29 -0700 (PDT) Received-SPF: pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) client-ip=209.51.188.17; Authentication-Results: mx.google.com; dkim=fail header.i=@linaro.org header.s=google header.b=TqOHHbvC; spf=pass (google.com: domain of qemu-devel-bounces+patch=linaro.org@nongnu.org designates 209.51.188.17 as permitted sender) smtp.mailfrom="qemu-devel-bounces+patch=linaro.org@nongnu.org"; dmarc=fail (p=NONE sp=NONE dis=NONE) header.from=linaro.org Received: from localhost ([::1]:34762 helo=lists1p.gnu.org) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i4jYV-0007zL-Tf for patch@linaro.org; Mon, 02 Sep 2019 06:27:27 -0400 Received: from eggs.gnu.org ([2001:470:142:3::10]:54883) by lists.gnu.org with esmtp (Exim 4.90_1) (envelope-from ) id 1i4jSn-0004kG-Di for qemu-devel@nongnu.org; Mon, 02 Sep 2019 06:21:35 -0400 Received: from Debian-exim by eggs.gnu.org with spam-scanned (Exim 4.71) (envelope-from ) id 1i4jSl-0004IF-6i for qemu-devel@nongnu.org; Mon, 02 Sep 2019 06:21:33 -0400 Received: from mail-wm1-x32e.google.com ([2a00:1450:4864:20::32e]:52761) by eggs.gnu.org with esmtps (TLS1.0:RSA_AES_128_CBC_SHA1:16) (Exim 4.71) (envelope-from ) id 1i4jSk-0004HC-W3 for qemu-devel@nongnu.org; Mon, 02 Sep 2019 06:21:31 -0400 Received: by mail-wm1-x32e.google.com with SMTP id t17so13943141wmi.2 for ; Mon, 02 Sep 2019 03:21:30 -0700 (PDT) DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=linaro.org; s=google; h=from:to:cc:subject:date:message-id:in-reply-to:references :mime-version:content-transfer-encoding; bh=FqjuG3RUHS3JckYSNiYZ0vObZ8wV+Y4/XOCXHmnveCo=; b=TqOHHbvCClDHl6VSYqE9nNZYFWu83QoHEE7rROcNBoZPJKgVhutaG3ZUPtulCpCBoD 83polwalRvyvN+L/i6CDyhTldnFxbmtIh3W/4ABJNDniXAbUS7DNqyCN89tmofYRewt1 lxJcKJK/8AXyYZo9ocuyE6w16m5LGg5Bv2LEehVfO4d9g9wFy1tmEzifPji2Kip24Mag yzC2LO9A/Hrt3Zkroz2bXoXSSVceVmVlzuNo0l4R/mWOHDNLOn+9r6orP3s+7khJv3PT dhVCGfWj/cp5HPWpWqxf+fQhdUCySdIKZtJNsNReP5BnzMnz7cTIlLYvmsGbqVVEpQo8 K0Iw== X-Google-DKIM-Signature: v=1; a=rsa-sha256; c=relaxed/relaxed; d=1e100.net; s=20161025; h=x-gm-message-state:from:to:cc:subject:date:message-id:in-reply-to :references:mime-version:content-transfer-encoding; bh=FqjuG3RUHS3JckYSNiYZ0vObZ8wV+Y4/XOCXHmnveCo=; b=arucEsqu5OfUysWgohtJmh1cJWtiZ90XJ2DHph84lh0HFCSLTCXSK17seXzMbZ3rtD 66HeIpj1y22jArBFSpKAkH6RH9n/E/XGbTGUjJlj+9QCR4qd3I5IPE26WegdyTOzVPHY 6MHgVVY5LyHQOlbWPN/wNBPS9jRyuQtOG7qmk+LVfv/73WYjSJiKpKY50ujtKqVBp1py Cw6eCl0ndvphim+USerzsfFDuqGfK9Osf8ehdPtTbif7TBfCUigH3TmZweKfHxzYRsL3 lo0DtA6A551aL/TGWlAExY++Z9RM3DOTGGLumTeDlabdrJlCIe5V+6YvU0wn83jztB2o aK0Q== X-Gm-Message-State: APjAAAVvunD5OnadcANbbHRegT+5JE6HUX3t7ytLLbFyGFe34RUYXLMI xH1O3lsY0aursn1JrmvXjuQuQg== X-Received: by 2002:a1c:eb06:: with SMTP id j6mr36437267wmh.76.1567419688772; Mon, 02 Sep 2019 03:21:28 -0700 (PDT) Received: from zen.linaroharston ([51.148.130.216]) by smtp.gmail.com with ESMTPSA id f66sm729106wmg.2.2019.09.02.03.21.24 (version=TLS1_3 cipher=TLS_AES_256_GCM_SHA384 bits=256/256); Mon, 02 Sep 2019 03:21:24 -0700 (PDT) Received: from zen.lan (localhost [127.0.0.1]) by zen.linaroharston (Postfix) with ESMTP id E46641FF98; Mon, 2 Sep 2019 11:21:22 +0100 (BST) From: =?utf-8?q?Alex_Benn=C3=A9e?= To: peter.maydell@linaro.org Date: Mon, 2 Sep 2019 11:21:18 +0100 Message-Id: <20190902102122.1128-9-alex.bennee@linaro.org> X-Mailer: git-send-email 2.20.1 In-Reply-To: <20190902102122.1128-1-alex.bennee@linaro.org> References: <20190902102122.1128-1-alex.bennee@linaro.org> MIME-Version: 1.0 X-detected-operating-system: by eggs.gnu.org: Genre and OS details not recognized. X-Received-From: 2a00:1450:4864:20::32e Subject: [Qemu-devel] [PULL 08/12] .mailmap/aliases: add some further commentary X-BeenThere: qemu-devel@nongnu.org X-Mailman-Version: 2.1.23 Precedence: list List-Id: List-Unsubscribe: , List-Archive: List-Post: List-Help: List-Subscribe: , Cc: =?utf-8?q?Alex_Benn=C3=A9e?= , qemu-devel@nongnu.org, Aleksandar Markovic Errors-To: qemu-devel-bounces+patch=linaro.org@nongnu.org Sender: "Qemu-devel" 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 Reviewed-by: Aleksandar Markovic -- 2.20.1 diff --git a/.mailmap b/.mailmap index d0fc1d793c6..0756a0bf66d 100644 --- a/.mailmap +++ b/.mailmap @@ -1,4 +1,18 @@ # This mailmap fixes up author names/addresses. +# +# If you are adding to this file consider if a similar change needs to +# be made to contrib/gitdm/aliases. They are not however completely +# analogous. .mailmap is concerned with fixing up damaged author +# fields where as the gitdm equivalent is more concerned with making +# sure multiple email addresses get mapped onto the same author. +# +# From man git-shortlog the forms are: +# +# Proper Name +# +# Proper Name +# Proper Name Commit Name +# # The first section translates weird addresses from the original git import # into proper addresses so that they are counted properly by git shortlog. diff --git a/contrib/gitdm/aliases b/contrib/gitdm/aliases index 07fd3391a56..c1e744312f5 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 05e355d30ec..1c847174380 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