summaryrefslogtreecommitdiffstats
path: root/git-shortlog.html
diff options
context:
space:
mode:
authorJunio C Hamano <gitster@pobox.com>2020-10-04 13:44:12 -0700
committerJunio C Hamano <gitster@pobox.com>2020-10-04 13:44:12 -0700
commit36ebb0e3ab4a7aa8b34196786a989cf6a523c648 (patch)
tree56b92cb7a2d79b1778a381aceec4325bbdf30382 /git-shortlog.html
parent5880aee0090d327fd8b4672385782ce15228f3a4 (diff)
downloadgit-htmldocs-36ebb0e3ab4a7aa8b34196786a989cf6a523c648.tar.gz
Autogenerated HTML docs for v2.28.0-715-gab469
Diffstat (limited to 'git-shortlog.html')
-rw-r--r--git-shortlog.html49
1 files changed, 47 insertions, 2 deletions
diff --git a/git-shortlog.html b/git-shortlog.html
index 8782bc315..720adb148 100644
--- a/git-shortlog.html
+++ b/git-shortlog.html
@@ -821,6 +821,51 @@ reference to the current repository.</p></div>
</div></div>
</dd>
<dt class="hdlist1">
+--group=&lt;type&gt;
+</dt>
+<dd>
+<p>
+ Group commits based on <code>&lt;type&gt;</code>. If no <code>--group</code> option is
+ specified, the default is <code>author</code>. <code>&lt;type&gt;</code> is one of:
+</p>
+<div class="openblock">
+<div class="content">
+<div class="ulist"><ul>
+<li>
+<p>
+<code>author</code>, commits are grouped by author
+</p>
+</li>
+<li>
+<p>
+<code>committer</code>, commits are grouped by committer (the same as <code>-c</code>)
+</p>
+</li>
+<li>
+<p>
+<code>trailer:&lt;field&gt;</code>, the <code>&lt;field&gt;</code> is interpreted as a case-insensitive
+ commit message trailer (see <a href="git-interpret-trailers.html">git-interpret-trailers(1)</a>). For
+ example, if your project uses <code>Reviewed-by</code> trailers, you might want
+ to see who has been reviewing with
+ <code>git shortlog -ns --group=trailer:reviewed-by</code>.
+</p>
+<div class="paragraph"><p>Note that commits that do not include the trailer will not be counted.
+Likewise, commits with multiple trailers (e.g., multiple signoffs) may
+be counted more than once (but only once per unique trailer value in
+that commit).</p></div>
+<div class="paragraph"><p>Shortlog will attempt to parse each trailer value as a <code>name &lt;email&gt;</code>
+identity. If successful, the mailmap is applied and the email is omitted
+unless the <code>--email</code> option is specified. If the value cannot be parsed
+as an identity, it will be taken literally and completely.</p></div>
+</li>
+</ul></div>
+</div></div>
+<div class="paragraph"><p>If <code>--group</code> is specified multiple times, commits are counted under each
+value (but again, only once per unique value in that commit). For
+example, <code>git shortlog --group=author --group=trailer:co-authored-by</code>
+counts both authors and co-authors.</p></div>
+</dd>
+<dt class="hdlist1">
-c
</dt>
<dt class="hdlist1">
@@ -828,7 +873,7 @@ reference to the current repository.</p></div>
</dt>
<dd>
<p>
- Collect and show committer identities instead of authors.
+ This is an alias for <code>--group=committer</code>.
</p>
</dd>
<dt class="hdlist1">
@@ -1994,7 +2039,7 @@ the email address.</p></div>
<div id="footer">
<div id="footer-text">
Last updated
- 2020-03-10 08:03:13 PDT
+ 2020-10-04 13:41:15 PDT
</div>
</div>
</body>