## 名称

git-shortlog - 总结`git log`输出

## 概要

    git log --pretty=short | git shortlog [<options>]git shortlog [<options>] [<revision range>] [[\--] <path>…]

## 描述

以适合纳入发布公告的格式汇总`git log`输出。每个提交将按作者和标题进行分组。

此外，“提交”将从提交说明中删除。

如果在命令行上没有传递修订，并且标准输入不是终端或没有当前分支，`git shortlog`则会输出从标准输入中读取的日志的摘要，而不参考当前的存储库。

## 选项

-n --numbered

根据每个作者的提交数量而不是作者字母顺序对输出进行排序。

-s --summary

禁止提交描述并仅提供提交计数摘要。

-e --email

显示每位作者的电子邮件地址。

--format=<format>

使用一些其他信息来描述每个提交，而不是提交主题。`<format>`可以是由`--format`选项接受的任何字符串`git log`，例如`* [%h] %s`。（请参阅 git-log [1]的“PRETTY FORMATS”部分。）

    Each pretty-printed commit will be rewrapped before it is shown.

-c --committer

收集并显示提交者身份而不是作者。

-w[<width>[,<indent1>,<indent2>]]

通过包装每行的输入线来包装输出`width`。每个条目的第一行由`indent1`空格缩进，第二行和后续行由`indent2`空格缩进。`width`，`indent1`和`indent2`分别默认为76，6和9。

如果宽度为`0`（零），则缩进输出的行而不包装它们。

<revision range>

仅显示指定修订范围内的提交。当没有指定<revision range>时，它默认为`HEAD`（即导致当前提交的整个历史记录）。`origin..HEAD`指定从当前提交（ie `HEAD`）可访问的所有提交，但不提供`origin`。有关拼写<修订范围>的完整方法列表，请参阅 gitrevisions [7]的“指定范围”部分。

-- <path>…

只考虑足以解释如何匹配指定路径的文件的提交。

当出现混淆时，路径可能需要以“ - ”作为前缀以将它们与选项或修订范围分开。

## 映射作者

`.mailmap`功能用于合并短日志中同一个人的提交，其姓名和/或电子邮件地址拼写有所不同。

如果文件`.mailmap`存在于版本库的顶层，或者位于 mailmap.file 或 mailmap.blob 配置选项指向的位置，则它用于将作者和提交者名称以及电子邮件地址映射到规范的实名和电子邮件地址。

在简单的形式中，文件中的每一行由作者的标准真实姓名，空格以及在提交中使用的电子邮件地址（用`<`and 括起来`>`）映射到名称。例如：

    Proper Name <commit@email.xx>

更复杂的形式是：

    <proper@email.xx> <commit@email.xx>

它允许 mailmap 只替换提交的电子邮件部分，并且：

    Proper Name <proper@email.xx> <commit@email.xx>

它允许 mailmap 替换与指定的提交电子邮件地址匹配的提交的名称和电子邮件，以及：

    Proper Name <proper@email.xx> Commit Name <commit@email.xx>

它允许 mailmap 替换与指定的提交名称和电子邮件地址相匹配的提交的名称和电子邮件。

示例1：您的历史记录包含两位作者 Jane 和 Joe 的提交，他们的名字以几种形式出现在存储库中：

    Joe Developer <joe@example.com>Joe R. Developer <joe@example.com>Jane Doe <jane@example.com>Jane Doe <jane@laptop.(none)>Jane D. <jane@desktop.(none)>

现在假设乔想让他的中间名得到最初的使用，而珍则更喜欢将她的姓氏完整地拼出来。一个合适的`.mailmap`文件应该是这样的：

    Jane Doe         <jane@desktop.(none)>Joe R. Developer <joe@example.com>

注意如何不需要输入`<jane@laptop.(none)>`，因为该作者的真实姓名已经是正确的。

示例2：您的存储库包含以下作者的提交：

    nick1 <bugs@company.xx>nick2 <bugs@company.xx>nick2 <nick2@company.xx>santa <me@company.xx>claus <me@company.xx>CTO <cto@coompany.xx>

那么你可能需要一个如下所示的`.mailmap`文件：

    <cto@company.xx>                       <cto@coompany.xx>Some Dude <some@dude.xx>         nick1 <bugs@company.xx>Other Author <other@author.xx>   nick2 <bugs@company.xx>Other Author <other@author.xx>         <nick2@company.xx>Santa Claus <santa.claus@northpole.xx> <me@company.xx>

将散列`#`用于自己的行中或电子邮件地址之后的注释。