]> git.ipfire.org Git - thirdparty/git.git/commit - ref-filter.c
ref-filter.c: sort formatted dates by byte value
authorVictoria Dye <vdye@github.com>
Thu, 8 Feb 2024 01:57:19 +0000 (01:57 +0000)
committerJunio C Hamano <gitster@pobox.com>
Thu, 8 Feb 2024 05:33:37 +0000 (21:33 -0800)
commit46176d77c9e0b219a78d64cb99d8dbf4d9bcde2d
tree92e90882f3a31f6104345813c3ed18ba3cbfc713
parent235986be822c9f8689be2e9a0b7804d0b1b6d821
ref-filter.c: sort formatted dates by byte value

Update the ref sorting functions of 'ref-filter.c' so that when date fields
are specified with a format string (such as in 'git for-each-ref
--sort=creatordate:<something>'), they are sorted by their formatted string
value rather than by the underlying numeric timestamp. Currently, date
fields are always sorted by timestamp, regardless of whether formatting
information is included in the '--sort' key.

Leaving the default (unformatted) date sorting unchanged, sorting by the
formatted date string adds some flexibility to 'for-each-ref' by allowing
for behavior like "sort by year, then by refname within each year" or "sort
by time of day". Because the inclusion of a format string previously had no
effect on sort behavior, this change likely will not affect existing usage
of 'for-each-ref' or other ref listing commands.

Additionally, update documentation & tests to document the new sorting
mechanism.

Signed-off-by: Victoria Dye <vdye@github.com>
Signed-off-by: Junio C Hamano <gitster@pobox.com>
Documentation/git-for-each-ref.txt
ref-filter.c
t/t6300-for-each-ref.sh