documentation: mention --no-use-mailmap and log.mailmap false setting
authorAriadne Conill <ariadne@dereferenced.org>
Mon, 15 Jul 2019 12:41:05 +0000 (07:41 -0500)
committerJunio C Hamano <gitster@pobox.com>
Mon, 15 Jul 2019 18:44:26 +0000 (11:44 -0700)
The log.mailmap setting may be explicitly set to false, which disables
the mailmap feature implicity. In practice, doing so is equivalent to
always using the previously undocumented --no-use-mailmap option on the
command line.

Accordingly, we document both the existence of --no-use-mailmap as
well as briefly discuss the equivalence of it to log.mailmap=False.

Signed-off-by: Ariadne Conill <ariadne@dereferenced.org>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/config/log.txt
Documentation/git-log.txt
index 78d9e4453ac9082c670d79eda85f095c18b0bb2f..7798e10cb0ac5e4360ad50eae0a8a5a852a8f271 100644 (file)
@@ -40,4 +40,5 @@ log.showSignature::
 
 log.mailmap::
        If true, makes linkgit:git-log[1], linkgit:git-show[1], and
-       linkgit:git-whatchanged[1] assume `--use-mailmap`.
+       linkgit:git-whatchanged[1] assume `--use-mailmap`, otherwise
+       assume `--no-use-mailmap`. False by default.
index b02e922dc33d248493df4bf6e1bb42f342e38daa..b406bc4c48f4230c6a211374556d33a3b18081e7 100644 (file)
@@ -49,7 +49,7 @@ OPTIONS
        Print out the ref name given on the command line by which each
        commit was reached.
 
---use-mailmap::
+--[no-]use-mailmap::
        Use mailmap file to map author and committer names and email
        addresses to canonical real names and email addresses. See
        linkgit:git-shortlog[1].