threads / discuss / 64680

Why git branch --show-current ignores -v?

Subject: Why git branch --show-current ignores -v?

## tl;dr

6 messages between Dec 25, 2025 and Dec 26, 2025.

replies: 5people: 3as markdown or json

Sergey Organov· Dec 25, 2025, 16:08 UTC · lore
Hello,

It looks useful and natural for "git branch --show-current -v[v]" to verbosely describe current branch, similar to what --list does. Is there sound reason why -v is not supported by --show-current?

Thanks, -- Sergey Organov

Junio C Hamano· Dec 26, 2025, 02:09 UTC · re: Sergey Organov · lore

Re: Why git branch --show-current ignores -v?

Sergey Organov <sorganov@gmail.com> writes:
> It looks useful and natural for "git branch --show-current -v[v]" to
> verbosely describe current branch, similar to what --list does. Is there
> sound reason why -v is not supported by --show-current?

The "--show-current" feature was invented merely for those who somehow found it ugly to use "git symbolic-ref HEAD" when a user wants to learn what the current branch was. If I have to guess, nobody thought about it as a way to get the same output as "--list" but restricted to the single current branch. Hence nobody felt the need to support any option that the "--list" operation supported, including "-v". IOW, nobody shared your "It looks useful" so far, especially among the people who knew where the "--show-current" option came from.

I do not think anybody terribly objects if somebody teaches "-v" to make "git branch --show-current" more verbose, and other "--list" operations in general, but I suspect that the exact contents in the verbose output may have to be different from that of "--list". For one thing, as "--show-current" limits its output to the current branch, the two-place indent "git branch --list" gives its output is not there, and "-v" would probably not want to add it.

Junio C Hamano· Dec 26, 2025, 02:11 UTC · re: Junio C Hamano · lore

Re: Why git branch --show-current ignores -v?

Junio C Hamano <gitster@pobox.com> writes:
Show 23 quoted lines
> Sergey Organov <sorganov@gmail.com> writes:
>
>> It looks useful and natural for "git branch --show-current -v[v]" to
>> verbosely describe current branch, similar to what --list does. Is there
>> sound reason why -v is not supported by --show-current?
>
> The "--show-current" feature was invented merely for those who
> somehow found it ugly to use "git symbolic-ref HEAD" when a user
> wants to learn what the current branch was.  If I have to guess,
> nobody thought about it as a way to get the same output as "--list"
> but restricted to the single current branch.  Hence nobody felt the
> need to support any option that the "--list" operation supported,
> including "-v".  IOW, nobody shared your "It looks useful" so far,
> especially among the people who knew where the "--show-current"
> option came from.
>
> I do not think anybody terribly objects if somebody teaches "-v" to
> make "git branch --show-current" more verbose, and other "--list"
> operations in general, but I suspect that the exact contents in the
> verbose output may have to be different from that of "--list".  For
> one thing, as "--show-current" limits its output to the current
> branch, the two-place indent "git branch --list" gives its output is
> not there, and "-v" would probably not want to add it.
Forgot to say something much more important.  

Commands should complain when users give them input that they do not understand. If "git branch --show-current -v" silently eats "-v", I would say it is a bug.

Unless we define that the current output is already verbose, that is.

Thanks.
K Jayatheerth· Dec 26, 2025, 03:28 UTC · re: Junio C Hamano · lore

[PATCH] branch: Remove unnecessary verbose flag

The --show-current option doesn't know how to handle verbose logic. In such a case, we want the program to die when both flags are used together.

Signed-off-by: K Jayatheerth <jayatheerthkulkarni2005@gmail.com>
---
 builtin/branch.c  | 2 ++
 t/t3200-branch.sh | 4 ++++
 2 files changed, 6 insertions(+)
diff --git a/builtin/branch.c b/builtin/branch.c
index c577b5d20f..433c213dc0 100644
--- a/builtin/branch.c
+++ b/builtin/branch.c
@@ -860,6 +860,8 @@ int cmd_branch(int argc,
 		ret = delete_branches(argc, argv, delete > 1, filter.kind, quiet);
 		goto out;
 	} else if (show_current) {
+		if (filter.verbose)
+			die(_("options '%s' and '%s' cannot be used together"), "--show-current", "-v");
 		print_current_branch_name();
 		ret = 0;
 		goto out;
diff --git a/t/t3200-branch.sh b/t/t3200-branch.sh
index c58e505c43..5bb49de9c2 100755
--- a/t/t3200-branch.sh
+++ b/t/t3200-branch.sh
@@ -1716,4 +1716,8 @@ test_expect_success 'errors if given a bad branch name' '
 	test_cmp expect actual
 '
 
+test_expect_success 'git branch --show-current rejects -v' '
+	test_must_fail git branch --show-current -v
+'
+
 test_done
-- 
2.52.0
Junio C Hamano· Dec 26, 2025, 04:15 UTC · re: K Jayatheerth · lore

Re: [PATCH] branch: Remove unnecessary verbose flag

K Jayatheerth <jayatheerthkulkarni2005@gmail.com> writes:
Show 36 quoted lines
> The --show-current option doesn't know how to handle verbose
> logic. In such a case, we want the program to die when both flags
> are used together.
>
> Signed-off-by: K Jayatheerth <jayatheerthkulkarni2005@gmail.com>
> ---
>  builtin/branch.c  | 2 ++
>  t/t3200-branch.sh | 4 ++++
>  2 files changed, 6 insertions(+)
>
> diff --git a/builtin/branch.c b/builtin/branch.c
> index c577b5d20f..433c213dc0 100644
> --- a/builtin/branch.c
> +++ b/builtin/branch.c
> @@ -860,6 +860,8 @@ int cmd_branch(int argc,
>  		ret = delete_branches(argc, argv, delete > 1, filter.kind, quiet);
>  		goto out;
>  	} else if (show_current) {
> +		if (filter.verbose)
> +			die(_("options '%s' and '%s' cannot be used together"), "--show-current", "-v");
>  		print_current_branch_name();
>  		ret = 0;
>  		goto out;
> diff --git a/t/t3200-branch.sh b/t/t3200-branch.sh
> index c58e505c43..5bb49de9c2 100755
> --- a/t/t3200-branch.sh
> +++ b/t/t3200-branch.sh
> @@ -1716,4 +1716,8 @@ test_expect_success 'errors if given a bad branch name' '
>  	test_cmp expect actual
>  '
>  
> +test_expect_success 'git branch --show-current rejects -v' '
> +	test_must_fail git branch --show-current -v
> +'
> +
>  test_done
Thanks.
This is certainly an improvement over status quo.
Ideally, however, if you say
    git branch -v -q --show-current

shouldn't it also barf? IOW, checking the end state (i.e. filter.verbose being zero) is one thing, but to do a good job, we probably should check how we got to the end state.

Since that would require a far larger change without a tangible benefit, I'd say the posted patch that checks only the end state is good enough for now.

Will queue.
Sergey Organov· Dec 26, 2025, 15:43 UTC · re: Junio C Hamano · lore

Re: Why git branch --show-current ignores -v?

Junio C Hamano <gitster@pobox.com> writes:
Show 6 quoted lines
> Sergey Organov <sorganov@gmail.com> writes:
>
>> It looks useful and natural for "git branch --show-current -v[v]" to
>> verbosely describe current branch, similar to what --list does. Is there
>> sound reason why -v is not supported by --show-current?
>
[...]
Show 7 quoted lines
> I do not think anybody terribly objects if somebody teaches "-v" to
> make "git branch --show-current" more verbose, and other "--list"
> operations in general, but I suspect that the exact contents in the
> verbose output may have to be different from that of "--list".  For
> one thing, as "--show-current" limits its output to the current
> branch, the two-place indent "git branch --list" gives its output is
> not there, and "-v" would probably not want to add it.

Yep, I didn't mean to suggest exactly the same format and contents, though just reproducing the --list won't hurt either.

The actual use-case was to quickly figure the upstream branch and relative status of the current one, and

    git br --show-current -vv
just looked more natural for the job at hand than something like
    git br -lvv master

that besides is not exactly the same, and then the following one is kinda overkill for manual use)))

    git br -lvv `git br --show-current`

That suddenly gets me to why Git has no synonym for the current branch in the first place? No @HEAD or @@?

   git br -lvv @@
is pretty-looking perl'y that unfortunately doesn't work.

Thanks, Sergey Organov

← back to recent threads