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

From: Georg Pfuetzenreuter <georg@syscid.com>
Date: May 11, 2024, 13:12 UTC
Message-ID: <7c11e562-8476-4b0f-aadd-14695065b80e@syscid.com>
In-Reply-To: <77e42d15-fcaf-5c1b-3a00-f1f1e3cedfc4@pfeifer.com>

On 5/11/24 14:34, Gerald Pfeifer wrote:

Show 25 quoted lines

> `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.