Merge branch 'ac/help-sort-correctly' into jch

The code in "git help" that shows configuration items in sorted
order was awkwardly organized and prone to bugs.

Comments?
cf. <xmqqwlzu43rh.fsf@gitster.g>

* ac/help-sort-correctly:
  help: cleanup the contruction of keys_uniq
This commit is contained in:
Junio C Hamano
2026-03-03 11:08:30 -08:00
2 changed files with 65 additions and 45 deletions

View File

@@ -114,6 +114,49 @@ struct slot_expansion {
int found;
};
static void set_config_vars(struct string_list *keys_uniq, struct string_list_item *var)
{
struct strbuf sb = STRBUF_INIT;
const char *str = var->string;
const char *wildcard = strchr(str, '*');
const char *tag = strchr(str, '<');
const char *cut;
if (wildcard && tag)
cut = wildcard < tag ? wildcard : tag;
else if (wildcard)
cut = wildcard;
else if (tag)
cut = tag;
else {
string_list_append(keys_uniq, str);
return;
}
strbuf_add(&sb, str, cut - str);
string_list_append(keys_uniq, sb.buf);
strbuf_release(&sb);
}
static void set_config_sections(struct string_list *keys_uniq, struct string_list_item *var)
{
struct strbuf sb = STRBUF_INIT;
const char *str = var->string;
const char *dot = strchr(str, '.');
const char *cut;
if (dot)
cut = dot;
else {
set_config_vars(keys_uniq, var);
return;
}
strbuf_add(&sb, str, cut - str);
string_list_append(keys_uniq, sb.buf);
strbuf_release(&sb);
}
static void list_config_help(enum show_config_type type)
{
struct slot_expansion slot_expansions[] = {
@@ -159,50 +202,27 @@ static void list_config_help(enum show_config_type type)
BUG("slot_expansion %s.%s is not used",
e->prefix, e->placeholder);
string_list_sort(&keys);
for (size_t i = 0; i < keys.nr; i++) {
const char *var = keys.items[i].string;
const char *wildcard, *tag, *cut;
const char *dot = NULL;
struct strbuf sb = STRBUF_INIT;
switch (type) {
case SHOW_CONFIG_HUMAN:
puts(var);
continue;
string_list_append(&keys_uniq, keys.items[i].string);
break;
case SHOW_CONFIG_SECTIONS:
dot = strchr(var, '.');
set_config_sections(&keys_uniq, &keys.items[i]);
break;
case SHOW_CONFIG_VARS:
set_config_vars(&keys_uniq, &keys.items[i]);
break;
default:
BUG("%d: unexpected type", type);
}
wildcard = strchr(var, '*');
tag = strchr(var, '<');
if (!dot && !wildcard && !tag) {
string_list_append(&keys_uniq, var);
continue;
}
if (dot)
cut = dot;
else if (wildcard && !tag)
cut = wildcard;
else if (!wildcard && tag)
cut = tag;
else
cut = wildcard < tag ? wildcard : tag;
strbuf_add(&sb, var, cut - var);
string_list_append(&keys_uniq, sb.buf);
strbuf_release(&sb);
}
string_list_clear(&keys, 0);
string_list_remove_duplicates(&keys_uniq, 0);
string_list_sort_u(&keys_uniq, 0);
for_each_string_list_item(item, &keys_uniq)
puts(item->string);
string_list_clear(&keys_uniq, 0);
string_list_clear(&keys, 0);
}
static enum help_format parse_help_format(const char *format)

View File

@@ -141,20 +141,20 @@ test_expect_success 'git help -c' '
'\''git help config'\'' for more information
EOF
grep -v -E \
-e "^[^.]+\.[^.]+$" \
-e "^[^.]+\.[^.]+\.[^.]+$" \
sed \
-e "/^[^.]*\.[^.]*$/d" \
-e "/^[^.]*\.[^.]*\.[^.]*$/d" \
help.output >actual &&
test_cmp expect actual
'
test_expect_success 'git help --config-for-completion' '
git help -c >human &&
grep -E \
-e "^[^.]+\.[^.]+$" \
-e "^[^.]+\.[^.]+\.[^.]+$" human |
sed -e "s/\*.*//" -e "s/<.*//" |
sort -u >human.munged &&
sed -n \
-e "/^[^.]*\.[^.]*$/p" \
-e "/^[^.]*\.[^.]*\.[^.]*$/p" human |
sed -e "s/\*.*//" -e "s/<.*//" |
sort -u >human.munged &&
git help --config-for-completion >vars &&
test_cmp human.munged vars
@@ -162,11 +162,11 @@ test_expect_success 'git help --config-for-completion' '
test_expect_success 'git help --config-sections-for-completion' '
git help -c >human &&
grep -E \
-e "^[^.]+\.[^.]+$" \
-e "^[^.]+\.[^.]+\.[^.]+$" human |
sed -e "s/\..*//" |
sort -u >human.munged &&
sed -n \
-e "/^[^.]*\.[^.]*$/p" \
-e "/^[^.]*\.[^.]*\.[^.]*$/p" human |
sed -e "s/\..*//" |
sort -u >human.munged &&
git help --config-sections-for-completion >sections &&
test_cmp human.munged sections