Martin Ågren <martin.agren@xxxxxxxxx> writes: > The first usage we give is the original one where, e.g., `git log` is > piped through `git shortlog`. The description that follows reads the > other way round, by first focusing on the general behavior, then ending > with the behavior when reading from stdin. > ... The result looks a lot more useful than without the patch. I think the current ordering is merely a historical accident made in 2006. Will queue; thanks. > diff --git a/Documentation/git-shortlog.txt b/Documentation/git-shortlog.txt > index ee6c5476c..5e35ea18a 100644 > --- a/Documentation/git-shortlog.txt > +++ b/Documentation/git-shortlog.txt > @@ -8,8 +8,8 @@ git-shortlog - Summarize 'git log' output > SYNOPSIS > -------- > [verse] > -git log --pretty=short | 'git shortlog' [<options>] > 'git shortlog' [<options>] [<revision range>] [[\--] <path>...] > +git log --pretty=short | 'git shortlog' [<options>] > > DESCRIPTION > -----------