Re: What's in git.git (stable)
From: Junio C Hamano <hidden>
Date: 2016-08-11 20:34:09
Jakub Narebski [off-list ref] writes:
Shawn Pearce wrote:quoted
Andy Parkins [off-list ref] wrote:quoted
* git-show-branch output is cryptic.Agreed. I still don't know how to read its output. So I just don't use it. Ever. :-)And the way it uses it's options is even more cryptic, and differs from other similar commands.
(Jakub, please do not drop people from cc: list; you were asked
more than once).
Ok, so what's the action you guys are proposing?
(1) show-branch output is cryptic and it does not do anything
useful. Drop it.
(2) show-branch output is cryptic and I do not understand what
it is trying to do. Document it better.
(3) While I agree what show-branch is trying to do is useful,
its output is useless. Instead of showing an example
situation like this:
[ picture here ]
It should show the same situation like this:
[ improved picture here ]
(4) None of the above.
The same question goes for its input branch specification.
Personally, I find its input branch globbing very handy, and
often wish that 'git branch' had a '--list' option that lists
branches that match the glob pattern given on the command line,
not just listing everything when no parameter is given.