From: Junio C Hamano <gitster@pobox.com>
To: Jeff King <peff@peff.net>
Cc: git@vger.kernel.org
Subject: Re: [PATCH] for-each-ref: delay parsing of --sort=<atom> options
Date: Wed, 20 Oct 2021 06:58:04 -0700 [thread overview]
Message-ID: <xmqq4k9bssr7.fsf@gitster.g> (raw)
In-Reply-To: YW9EP5UNX0f+eOke@coredump.intra.peff.net
Jeff King <peff@peff.net> writes:
>> As side effects, this change also cleans up a few issues:
>>
>> - 95be717c (parse_opt_ref_sorting: always use with NONEG flag,
>> 2019-03-20) muses that "git for-each-ref --no-sort" should simply
>> clear the sort keys accumulated so far; it now does.
>
> Neat. Is it worth adding a test here?
It probably is. The feature lets you defeat the configured personal
default, if I understand the code right, which is probably a good
thing.
I think that the command line option is cumulative on top of
configured values, with or without this change, and I think that
qualifies as a bug to be fixed. E.g. with a command line option
$ git -c branch.sort=-committerdate branch --sort=subject
any configured sort keys should be cleared and the branches ought to
be sorted solely on their subject string, but I think the code with
or without the patch still uses the "-committerdate" as a secondary
key to tiebreak sorting by "subject".
Until that bug is fixed, using --no-sort as the first command line
option before the true --sort=<key> option(s) you want to use would
be a workaround.
However, it is tricky to arrange, as the command already takes
multiple --sort keys, and the laster ones are taken as more
significant sort order, so it is tricky to come up with two keys A
and B such that --sort=A --no-sort --sort=B will produce one order,
while --sort=A --sort=B will produce another different order.
>> + if (sorting_options.nr) {
>> + struct ref_sorting *sorting;
>> + UNLEAK(sorting);
>> +
>> + sorting = ref_sorting_options(&sorting_options);
>> ref_array_sort(sorting, &ref_array);
>> + }
>
> I wondered at first about pulling this UNLEAK() down, but it's because
> you move the "sorting" variable itself into the smaller scope. So this
> makes sense (and calling UNLEAK() before the pointer is set is perfectly
> fine, since it takes the address of the auto variable). It is a shame
> you can't just ref_sorting_free() afterwards, but we don't have that
> function yet. And adding it is way out of scope here. :)
>
> I do find it interesting that this case checks sorting_options.nr
> itself, rather than relying on ref_sorting_options() to give us the
> default. But that's because the existing code avoids sorting at all in
> that case, so this is staying faithful to the original.
One thing that is somewhat scary was that with all the other
changes, but without the changes to builtin/ls-remote.c file, the
resulting tree still _compiles_ without any warning and only
segfaults at runtime. Since this does not use the "if nothing is
specified, use the default", I didn't even find it as a candidate
for conversion before seeing the tests to fail. This is an oddball
case.
> - I'd probably have kept the word "parse" somewhere in the name, since
> it really is turning the user-provided text into our internal form
Perhaps.
> - clearing the list at the end feels a little funny to me, just
> because this is conceptually a read-only operation (parse the user's
> text into our internal format). Your comment tells me what you're
> trying to protect against, but I find it unlikely anybody would
> mis-use the string_list afterwards (it doesn't do anything itself
> unless you parse it into the ref_sorting struct).
>
> All of the current callers are happy with this (and it even saves
> them clearing it themselves), but it just feels like an unusual
> interface.
Yes. The story the comment gives is an officially sounding lame
excuse; the true motivation was that I was too lazy to repeat
writing resource deallocation for each caller and made the callee to
do the freeing ;-)
>> @@ -97,9 +94,8 @@ struct ref_format {
>> #define OPT_NO_MERGED(f, h) _OPT_MERGED_NO_MERGED("no-merged", f, h)
>>
>> #define OPT_REF_SORT(var) \
>> - OPT_CALLBACK_F(0, "sort", (var), \
>> - N_("key"), N_("field name to sort on"), \
>> - PARSE_OPT_NONEG, parse_opt_ref_sorting)
>> + OPT_STRING_LIST(0, "sort", (var), \
>> + N_("key"), N_("field name to sort on"))
>
> Oh, this part makes using a string_list more appealing. ;)
Yes.
next prev parent reply other threads:[~2021-10-20 13:58 UTC|newest]
Thread overview: 20+ messages / expand[flat|nested] mbox.gz Atom feed top
2021-10-18 18:32 [PATCH] for-each-ref: delay parsing of --sort=<atom> options Junio C Hamano
2021-10-19 22:18 ` Jeff King
2021-10-20 2:20 ` Jeff King
2021-10-20 12:30 ` Ævar Arnfjörð Bjarmason
2021-10-20 13:24 ` [RFC PATCH v2 0/4] for-each-ref: delay parsing of --sort=<atom> options + linux-leaks fixes Ævar Arnfjörð Bjarmason
2021-10-20 13:24 ` [RFC PATCH v2 1/4] tag: use a "goto cleanup" pattern, leak less memory Ævar Arnfjörð Bjarmason
2021-10-20 14:37 ` Junio C Hamano
2021-10-20 13:24 ` [RFC PATCH v2 2/4] ref-filter API user: add and use a ref_sorting_release() Ævar Arnfjörð Bjarmason
2021-10-20 14:39 ` Junio C Hamano
2021-10-20 13:24 ` [RFC PATCH v2 3/4] for-each-ref: delay parsing of --sort=<atom> options Ævar Arnfjörð Bjarmason
2021-10-20 13:24 ` [RFC PATCH v2 4/4] branch: use ref_sorting_release() Ævar Arnfjörð Bjarmason
2021-10-20 14:43 ` [RFC PATCH v2 0/4] for-each-ref: delay parsing of --sort=<atom> options + linux-leaks fixes Junio C Hamano
2021-10-20 18:27 ` [PATCH 0/3] ref-filter: add a ref_sorting_release() Ævar Arnfjörð Bjarmason
2021-10-20 18:27 ` [PATCH 1/3] tag: use a "goto cleanup" pattern, leak less memory Ævar Arnfjörð Bjarmason
2021-10-20 18:27 ` [PATCH 2/3] ref-filter API user: add and use a ref_sorting_release() Ævar Arnfjörð Bjarmason
2021-10-20 18:27 ` [PATCH 3/3] branch: use ref_sorting_release() Ævar Arnfjörð Bjarmason
2021-10-20 13:58 ` Junio C Hamano [this message]
2021-10-20 20:48 ` [PATCH] for-each-ref: delay parsing of --sort=<atom> options Jeff King
2021-10-20 21:32 ` Junio C Hamano
2021-10-21 14:54 ` Jeff King
Reply instructions:
You may reply publicly to this message via plain-text email
using any one of the following methods:
* Save the following mbox file, import it into your mail client,
and reply-to-all from there: mbox
Avoid top-posting and favor interleaved quoting:
https://en.wikipedia.org/wiki/Posting_style#Interleaved_style
List information: http://vger.kernel.org/majordomo-info.html
* Reply using the --to, --cc, and --in-reply-to
switches of git-send-email(1):
git send-email \
--in-reply-to=xmqq4k9bssr7.fsf@gitster.g \
--to=gitster@pobox.com \
--cc=git@vger.kernel.org \
--cc=peff@peff.net \
/path/to/YOUR_REPLY
https://kernel.org/pub/software/scm/git/docs/git-send-email.html
* If your mail client supports setting the In-Reply-To header
via mailto: links, try the mailto: link
Be sure your reply has a Subject: header at the top and a blank line
before the message body.
Code repositories for project(s) associated with this public inbox
https://80x24.org/mirrors/git.git
This is a public inbox, see mirroring instructions
for how to clone and mirror all data and code used for this inbox;
as well as URLs for read-only IMAP folder(s) and NNTP newsgroup(s).