git-log --pretty=short | git-shortlog [-h] [-n] [-s] [-e] git-shortlog [-n|--numbered] [-s|--summary] [-e|--email] [<committish>…]


Summarizes git log output in a format suitable for inclusion in release announcements. Each commit will be grouped by author and the first line of the commit message will be shown.

Additionally, "[PATCH]" will be stripped from the commit description.


-h, --help

Print a short usage message and exit.

-n, --numbered

Sort output according to the number of commits per author instead of author alphabetic order.

-s, --summary

Suppress commit description and provide a commit count summary only.

-e, --email

Show the email address of each author.


If the file .mailmap exists, it will be used for mapping author email addresses to a real author name. One mapping per line, first the author name followed by the email address enclosed by < and >. Use hash # for comments. Example:

# Keep alphabetized
Adam Morrow <adam@localhost.localdomain>
Eve Jones <eve@laptop.(none)>


Written by Jeff Garzik <>


Documentation by Junio C Hamano.


Part of the linkgit:git[7] suite