# [PATCH] history: fix short help for argument of --update-refs

2 messages from 2026-04-06 to 2026-04-07. Participants: René Scharfe, Patrick Steinhardt.
Thread: https://gitlist.dev/t/65443

## René Scharfe, 2026-04-06 09:31

Subject: [PATCH] history: fix short help for argument of --update-refs
Message-ID: <ff6a940c-39fc-4dbf-a164-7770c7f26a31@web.de>

```
"print" is not a valid argument for --update-refs.  List both valid
alternatives literally in the argh string, consistent with documentation
and usage string.

Signed-off-by: René Scharfe <l.s.r@web.de>
---
git history is a new command in the coming release.

 builtin/history.c | 8 ++++----
 1 file changed, 4 insertions(+), 4 deletions(-)

diff --git a/builtin/history.c b/builtin/history.c
index 568dc75ee7..9526938085 100644
--- a/builtin/history.c
+++ b/builtin/history.c
@@ -437,8 +437,8 @@ static int cmd_history_reword(int argc,
 	enum ref_action action = REF_ACTION_DEFAULT;
 	int dry_run = 0;
 	struct option options[] = {
-		OPT_CALLBACK_F(0, "update-refs", &action, N_("<action>"),
-			       N_("control which refs should be updated (branches|head)"),
+		OPT_CALLBACK_F(0, "update-refs", &action, "(branches|head)",
+			       N_("control which refs should be updated"),
 			       PARSE_OPT_NONEG, parse_ref_action),
 		OPT_BOOL('n', "dry-run", &dry_run,
 			 N_("perform a dry-run without updating any refs")),
@@ -666,8 +666,8 @@ static int cmd_history_split(int argc,
 	enum ref_action action = REF_ACTION_DEFAULT;
 	int dry_run = 0;
 	struct option options[] = {
-		OPT_CALLBACK_F(0, "update-refs", &action, N_("<refs>"),
-			       N_("control ref update behavior (branches|head|print)"),
+		OPT_CALLBACK_F(0, "update-refs", &action, "(branches|head)",
+			       N_("control ref update behavior"),
 			       PARSE_OPT_NONEG, parse_ref_action),
 		OPT_BOOL('n', "dry-run", &dry_run,
 			 N_("perform a dry-run without updating any refs")),
-- 
2.53.0

```

## Patrick Steinhardt, 2026-04-07 05:16

Subject: Re: [PATCH] history: fix short help for argument of --update-refs
Message-ID: <adSTEypmnzKNhgoP@pks.im>
In-Reply-To: <ff6a940c-39fc-4dbf-a164-7770c7f26a31@web.de>

```
On Mon, Apr 06, 2026 at 11:31:21AM +0200, René Scharfe wrote:
> "print" is not a valid argument for --update-refs.  List both valid
> alternatives literally in the argh string, consistent with documentation
> and usage string.

This looks good to me, thanks!

Patrick

```
