From a474793a73ad1f0ed156f9b3bfbe1b709d633d6c Mon Sep 17 00:00:00 2001
From: Matthias Bernt <m.bernt@ufz.de>
Date: Thu, 14 Dec 2023 15:08:24 +0100
Subject: [PATCH 1/2] clarify the meaning of lexical

---
 lib/galaxy/tool_util/xsd/galaxy.xsd | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/lib/galaxy/tool_util/xsd/galaxy.xsd b/lib/galaxy/tool_util/xsd/galaxy.xsd
index 02d67e1c35b3..7cb6c7d92a1a 100644
--- a/lib/galaxy/tool_util/xsd/galaxy.xsd
+++ b/lib/galaxy/tool_util/xsd/galaxy.xsd
@@ -5619,7 +5619,13 @@ More information can be found on Planemo's documentation for
     </xs:attribute>
     <xs:attribute name="sort_by" type="xs:string" use="optional">
       <xs:annotation>
-        <xs:documentation xml:lang="en">A string `[reverse_][SORT_COMP_]SORTBY` describing the desired sort order of the collection elements. `SORTBY` can be `filename`, `name`, `designation`, `dbkey` and the optional `SORT_COMP` can be either `lexical` or `numeric`. Default is lexical sorting by filename.</xs:documentation>
+        <xs:documentation xml:lang="en"><![CDATA[
+        A string `[reverse_][SORT_COMP_]SORTBY` describing the desired sort order of the collection elements.
+        `SORTBY` can be `filename`, `name`, `designation`, `dbkey` and the optional `SORT_COMP` can be either
+        `lexical` or `numeric`. Default is lexical sorting by filename. 
+        Note that lexical sorting is case sensitive, i.e. lower case characters are considered larger than
+        upper case characters (e.g. "Banana" < "apple").
+        ]]></xs:documentation>
       </xs:annotation>
     </xs:attribute>
     <xs:attribute name="visible" type="xs:boolean" use="optional">

From a512dae0cfb074a8665f77375d8da012c5bd74e8 Mon Sep 17 00:00:00 2001
From: M Bernt <m.bernt@ufz.de>
Date: Thu, 14 Dec 2023 17:09:21 +0100
Subject: [PATCH 2/2] Extend example

Co-authored-by: John Davis <jdavcs@gmail.com>
---
 lib/galaxy/tool_util/xsd/galaxy.xsd | 3 +--
 1 file changed, 1 insertion(+), 2 deletions(-)

diff --git a/lib/galaxy/tool_util/xsd/galaxy.xsd b/lib/galaxy/tool_util/xsd/galaxy.xsd
index 7cb6c7d92a1a..4672e08fa123 100644
--- a/lib/galaxy/tool_util/xsd/galaxy.xsd
+++ b/lib/galaxy/tool_util/xsd/galaxy.xsd
@@ -5623,8 +5623,7 @@ More information can be found on Planemo's documentation for
         A string `[reverse_][SORT_COMP_]SORTBY` describing the desired sort order of the collection elements.
         `SORTBY` can be `filename`, `name`, `designation`, `dbkey` and the optional `SORT_COMP` can be either
         `lexical` or `numeric`. Default is lexical sorting by filename. 
-        Note that lexical sorting is case sensitive, i.e. lower case characters are considered larger than
-        upper case characters (e.g. "Banana" < "apple").
+        Note that lexical sorting is case sensitive, i.e. upper case characters come before lower case characters (e.g. "Apple" < "Banana" < "apple" < "banana").
         ]]></xs:documentation>
       </xs:annotation>
     </xs:attribute>