am, rebase: fix arghelp syntax of --empty

Use parentheses and pipes to present alternatives in the argument help
for the --empty options of git am and git rebase, like in the rest of
the documentation.

While at it remove a stray use of the enum empty_action value
STOP_ON_EMPTY_COMMIT to indicate that no short option is present.
While it has a value of 0 and thus there is no user-visible change,
that enum is not meant to hold short option characters.  Hard-code 0,
like we do for other options without a short option.

Signed-off-by: René Scharfe <l.s.r@web.de>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
maint
René Scharfe 2023-10-28 13:58:07 +02:00 committed by Junio C Hamano
parent 43c8a30d15
commit f7c1b23819
3 changed files with 4 additions and 4 deletions

View File

@ -289,7 +289,7 @@ See also INCOMPATIBLE OPTIONS below.
+ +
See also INCOMPATIBLE OPTIONS below. See also INCOMPATIBLE OPTIONS below.


--empty={drop,keep,ask}:: --empty=(drop|keep|ask)::
How to handle commits that are not empty to start and are not How to handle commits that are not empty to start and are not
clean cherry-picks of any upstream commit, but which become clean cherry-picks of any upstream commit, but which become
empty after rebasing (because they contain a subset of already empty after rebasing (because they contain a subset of already
@ -695,7 +695,7 @@ be dropped automatically with `--no-keep-empty`).
Similar to the apply backend, by default the merge backend drops Similar to the apply backend, by default the merge backend drops
commits that become empty unless `-i`/`--interactive` is specified (in commits that become empty unless `-i`/`--interactive` is specified (in
which case it stops and asks the user what to do). The merge backend which case it stops and asks the user what to do). The merge backend
also has an `--empty={drop,keep,ask}` option for changing the behavior also has an `--empty=(drop|keep|ask)` option for changing the behavior
of handling commits that become empty. of handling commits that become empty.


Directory rename detection Directory rename detection

View File

@ -2419,7 +2419,7 @@ int cmd_am(int argc, const char **argv, const char *prefix)
{ OPTION_STRING, 'S', "gpg-sign", &state.sign_commit, N_("key-id"), { OPTION_STRING, 'S', "gpg-sign", &state.sign_commit, N_("key-id"),
N_("GPG-sign commits"), N_("GPG-sign commits"),
PARSE_OPT_OPTARG, NULL, (intptr_t) "" }, PARSE_OPT_OPTARG, NULL, (intptr_t) "" },
OPT_CALLBACK_F(STOP_ON_EMPTY_COMMIT, "empty", &state.empty_type, "{stop,drop,keep}", OPT_CALLBACK_F(0, "empty", &state.empty_type, "(stop|drop|keep)",
N_("how to handle empty patches"), N_("how to handle empty patches"),
PARSE_OPT_NONEG, am_option_parse_empty), PARSE_OPT_NONEG, am_option_parse_empty),
OPT_HIDDEN_BOOL(0, "rebasing", &state.rebasing, OPT_HIDDEN_BOOL(0, "rebasing", &state.rebasing,

View File

@ -1147,7 +1147,7 @@ int cmd_rebase(int argc, const char **argv, const char *prefix)
"instead of ignoring them"), "instead of ignoring them"),
1, PARSE_OPT_HIDDEN), 1, PARSE_OPT_HIDDEN),
OPT_RERERE_AUTOUPDATE(&options.allow_rerere_autoupdate), OPT_RERERE_AUTOUPDATE(&options.allow_rerere_autoupdate),
OPT_CALLBACK_F(0, "empty", &options, "{drop,keep,ask}", OPT_CALLBACK_F(0, "empty", &options, "(drop|keep|ask)",
N_("how to handle commits that become empty"), N_("how to handle commits that become empty"),
PARSE_OPT_NONEG, parse_opt_empty), PARSE_OPT_NONEG, parse_opt_empty),
OPT_CALLBACK_F('k', "keep-empty", &options, NULL, OPT_CALLBACK_F('k', "keep-empty", &options, NULL,