@matheusbsbs / matheus-bagliano / commits / 5e7013aa14

diff: mark param1 and param2 as placeholders

Some l10n translators translated the parameters "files", "param1" and "param2" in the following message: "synonym for --dirstat=files,param1,param2..." Translating "param1" and "param2" is OK, but changing the parameter "files" is wrong. The parameters that are not meant to be used verbatim should be marked as placeholders, but the verbatim parameter not marked as a placeholder should be left as is. This change is a complement for commit 51e846e673 (doc: enforce placeholders in documentation, 2023-12-25). With the help of Jean-Noël,some parameter combinations in one placeholder (e.g. "<param1,param2>...") are splited into seperate placeholders. Helped-by: Jean-Noël Avila <jn.avila@free.fr> Signed-off-by: Jiang Xin <worldhello.net@gmail.com> Signed-off-by: Junio C Hamano <gitster@pobox.com>

Jiang Xin committed Feb 14, 2024 at 16:46 UTC 5e7013aa14739c3505a35b35ca095eeaace5d181
1 file changed +3 -3
diff.c
+3 -3
@@ -5567,7 +5567,7 @@ struct option *add_diff_options(const struct option *opts,
5567 OPT_BITOP(0, "shortstat", &options->output_format,
5568 N_("output only the last line of --stat"),
5569 DIFF_FORMAT_SHORTSTAT, DIFF_FORMAT_NO_OUTPUT),
5570 - OPT_CALLBACK_F('X', "dirstat", options, N_("<param1,param2>..."),
5570 + OPT_CALLBACK_F('X', "dirstat", options, N_("<param1>,<param2>..."),
5571 N_("output the distribution of relative amount of changes for each sub-directory"),
5572 PARSE_OPT_NONEG | PARSE_OPT_OPTARG,
5573 diff_opt_dirstat),
@@ -5575,8 +5575,8 @@ struct option *add_diff_options(const struct option *opts,
5575 N_("synonym for --dirstat=cumulative"),
5576 PARSE_OPT_NONEG | PARSE_OPT_NOARG,
5577 diff_opt_dirstat),
5578 - OPT_CALLBACK_F(0, "dirstat-by-file", options, N_("<param1,param2>..."),
5579 - N_("synonym for --dirstat=files,param1,param2..."),
5578 + OPT_CALLBACK_F(0, "dirstat-by-file", options, N_("<param1>,<param2>..."),
5579 + N_("synonym for --dirstat=files,<param1>,<param2>..."),
5580 PARSE_OPT_NONEG | PARSE_OPT_OPTARG,
5581 diff_opt_dirstat),
5582 OPT_BIT_F(0, "check", &options->output_format,