Hi there,
I created a patch for the documentation because there was some weird
behaviour that could not be explained with the current documentation
(see: https://github.com/darktable-org/darktable/issues/7573).
TLDR: If you sort by star rating and two pictures have the same rating,
a secondary (hidden) sort function decides the final order. This makes
images jump around if you change the color label... so people might
think they found a bug.
This update to the documentation might help a lot already, but in my
opinion this secondary sort order should be visible and selectable via a
drop down menu aswell.
Best, Jan
___________________________________________________________________________
darktable developer mailing list
to unsubscribe send a mail to darktable-dev+unsubscr...@lists.darktable.org
>From fa943dd974bffb5842f5fdaa4aace505c9775d8a Mon Sep 17 00:00:00 2001
From: solarer <sola...@hotmail.de>
Date: Mon, 26 Apr 2021 21:18:59 +0200
Subject: [PATCH] changed:
content/overview/user-interface/top-panel.md Added a short explanation on
primary and secondary search order. This created confusion in the past (see:
https://github.com/darktable-org/darktable/issues/7573). Also, slightly
changed wording another paragraph.
---
content/overview/user-interface/top-panel.md | 13 ++++++++++++-
1 file changed, 12 insertions(+), 1 deletion(-)
diff --git a/content/overview/user-interface/top-panel.md b/content/overview/user-interface/top-panel.md
index 883cb49..cdb9b37 100644
--- a/content/overview/user-interface/top-panel.md
+++ b/content/overview/user-interface/top-panel.md
@@ -13,7 +13,7 @@ The top panel is common to all darktable views and provides a number of common u
# On the left-hand-side
view
-: Choose which images to view in the lighttable/filmstrip, based on star rating and reject status.
+: Filter images to view in the lighttable/filmstrip section, based on star rating and reject status.
sort by
: Choose the property to sort by from the dropdown.
@@ -21,6 +21,17 @@ sort by
 sort order
: Switch the sort order (ascending / descending) with the arrow-toggle.
+---
+
+**Note**: sorting by multiple properties at once
+
+Darktable uses a hidden secondary 'sort by' function in case there is a tie between two or more pictures. So for example, if you sort by star rating and multiple pictures have 5 stars, the secondary sort function will decide which picture is displayed first.
+
+The secondary function is whatever was previously enabled as primary sort function. So if you sorted by color label first and then chose star rating, all pictures with identical star rating will be sorted by color label, next.
+
+---
+
+
# On the right-hand-side
 grouping
--
2.31.1
