summaryrefslogtreecommitdiffstats
path: root/Help/command/list.rst
diff options
context:
space:
mode:
authorDaniel Franke <franke@edf-online.de>2018-05-11 15:36:49 (GMT)
committerBrad King <brad.king@kitware.com>2018-06-13 18:06:29 (GMT)
commit49a51a61d75741645c824e45abeac215483b297e (patch)
treec2d940fad6ee090299f788495bfc3bb6880fd3de /Help/command/list.rst
parentf31d4ac7d68a1939d22ab7246b51e0ac10842bec (diff)
downloadCMake-49a51a61d75741645c824e45abeac215483b297e.zip
CMake-49a51a61d75741645c824e45abeac215483b297e.tar.gz
CMake-49a51a61d75741645c824e45abeac215483b297e.tar.bz2
list: Add options to control the SORT comparison operation
Diffstat (limited to 'Help/command/list.rst')
-rw-r--r--Help/command/list.rst22
1 files changed, 19 insertions, 3 deletions
diff --git a/Help/command/list.rst b/Help/command/list.rst
index 589e572..ad2c428 100644
--- a/Help/command/list.rst
+++ b/Help/command/list.rst
@@ -28,7 +28,7 @@ Synopsis
`Ordering`_
list(`REVERSE`_ <list>)
- list(`SORT`_ <list>)
+ list(`SORT`_ <list> [...])
Introduction
^^^^^^^^^^^^
@@ -253,7 +253,23 @@ Reverses the contents of the list in-place.
::
- list(SORT <list>)
-
+ list(SORT <list> [COMPARE <compare>] [CASE <case>] [ORDER <order>])
Sorts the list in-place alphabetically.
+Use the option ``<compare>`` to select the compare type for sorting.
+The ``<compare>`` option may be one of:
+
+* ``STRING``: Sorts a list of strings alphabetically.
+* ``FILE_BASENAME``: Sort a list of pathnames of files by their basenames.
+
+Use the option ``<case>`` to select a case sensitive or case insensitive sort mode.
+The ``<case>`` option may be one of:
+
+* ``SENSITIVE``: Sorts the list alphabetically.
+* ``INSENSITIVE``: Sorts the list alphabetically in descending order.
+
+Use the option ``<order>`` to select a case sensitive or case insensitive sort mode.
+The ``<order>`` option may be one of:
+
+* ``ASCENDING``: Sorts the list in ascending order.
+* ``DESCENDING``: Sorts the list in descending order.