Documentation/git-shortlog.txt

   1 git-shortlog(1)
   2 ===============
   3
   4 NAME
   5 ----
   6 git-shortlog - Summarize 'git-log' output
   7
   8 SYNOPSIS
   9 --------
  10 [verse]
  11 git log --pretty=short | 'git shortlog' [-h] [-n] [-s] [-e] [-w]
  12 git shortlog [-n|--numbered] [-s|--summary] [-e|--email] [-w[<width>[,<indent1>[,<indent2>]]]] [<committish>...]
  13
  14 DESCRIPTION
  15 -----------
  16 Summarizes 'git-log' output in a format suitable for inclusion
  17 in release announcements. Each commit will be grouped by author and
  18 the first line of the commit message will be shown.
  19
  20 Additionally, "[PATCH]" will be stripped from the commit description.
  21
  22 OPTIONS
  23 -------
  24
  25 -h::
  26 --help::
  27         Print a short usage message and exit.
  28
  29 -n::
  30 --numbered::
  31         Sort output according to the number of commits per author instead
  32         of author alphabetic order.
  33
  34 -s::
  35 --summary::
  36         Suppress commit description and provide a commit count summary only.
  37
  38 -e::
  39 --email::
  40         Show the email address of each author.
  41
  42 -w[<width>[,<indent1>[,<indent2>]]]::
  43         Linewrap the output by wrapping each line at `width`.  The first
  44         line of each entry is indented by `indent1` spaces, and the second
  45         and subsequent lines are indented by `indent2` spaces. `width`,
  46         `indent1`, and `indent2` default to 76, 6 and 9 respectively.
  47
  48 FILES
  49 -----
  50
  51 If a file `.mailmap` exists at the toplevel of the repository,
  52 it is used to map an author email address to a canonical real name. This
  53 can be used to coalesce together commits by the same person where their
  54 name was spelled differently (whether with the same email address or
  55 not).
  56
  57 Each line in the file consists, in this order, of the canonical real name
  58 of an author, whitespace, and an email address (enclosed by '<' and '>')
  59 to map to the name. Use hash '#' for comments, either on their own line,
  60 or after the email address.
  61
  62 A canonical name may appear in more than one line, associated with
  63 different email addresses, but it doesn't make sense for a given address
  64 to appear more than once (if that happens, a later line overrides the
  65 earlier ones).
  66
  67 So, for example, if your history contains commits by two authors, Jane
  68 and Joe, whose names appear in the repository under several forms:
  69
  70 ------------
  71 Joe Developer <joe@example.com>
  72 Joe R. Developer <joe@example.com>
  73 Jane Doe <jane@example.com>
  74 Jane Doe <jane@laptop.(none)>
  75 Jane D. <jane@desktop.(none)>
  76 ------------
  77
  78 Then, supposing Joe wants his middle name initial used, and Jane prefers
  79 her family name fully spelled out, a proper `.mailmap` file would look like:
  80
  81 ------------
  82 # Note how we don't need an entry for <jane@laptop.(none)>, because the
  83 # real name of that author is correct already, and coalesced directly.
  84 Jane Doe <jane@desktop.(none)>
  85 Joe R. Developer <joe@example.com>
  86 ------------
  87
  88 Author
  89 ------
  90 Written by Jeff Garzik <jgarzik@pobox.com>
  91
  92 Documentation
  93 --------------
  94 Documentation by Junio C Hamano.
  95
  96 GIT
  97 ---
  98 Part of the linkgit:git[1] suite