Re: git shortlog --committer=name is documented, alas not implemented

[Georg Pfuetzenreuter <georg@syscid.com>]

On 5/11/24 14:34, Gerald Pfeifer wrote:
> `man git shortlog` (from git 2.45.0) has the following:
> 
>     --author=<pattern>, --committer=<pattern>
>         Limit the commits output to ones with author/committer header lines
>         that match the specified pattern (regular expression). With more
>         than one --author=<pattern>, commits whose author matches any of
>         the given patterns are chosen (similarly for multiple
>         --committer=<pattern>).
> 
> Now `git shortlog --author=gerald` works as expected.
> 
> However `git shortlog --committer=gerald` results in an error:
> 
>    error: option `committer' takes no value
> 
> This is either a doc bug or an implementation issue?
> 
> 
> Also, how does one list all commits by a certain committer (as opposed
> to author) then?
> 
> 
> Thanks,
> Gerald
> 

I think this is not implemented for shortlog, and the man page is 
confusing. The --author=<pattern>/--committer=<pattern> section in 
git-shortlog(1) (Documentation/git-shortlog.txt) is just included from 
git-rev-list(1) (Documentation/rev-list-options.txt), but only the 
--committer argument documented in the "parent" git-shortlog.txt is valid.