diff options
| author | Brad King <brad.king@kitware.com> | 2018-10-08 15:21:23 (GMT) |
|---|---|---|
| committer | Brad King <brad.king@kitware.com> | 2018-10-08 15:21:23 (GMT) |
| commit | bad9bc78e392f26efa42348c76dfdd9431668fa2 (patch) | |
| tree | bc695a2106cd8ec88cd243fdb43ea8cedb781ab8 /Help/command | |
| parent | c780f5eea70f9b609e17adf5f192e024d1dd46b5 (diff) | |
| parent | cdf8d79e9f02e360b14f675d36587dd94afbb915 (diff) | |
| download | CMake-bad9bc78e392f26efa42348c76dfdd9431668fa2.zip CMake-bad9bc78e392f26efa42348c76dfdd9431668fa2.tar.gz CMake-bad9bc78e392f26efa42348c76dfdd9431668fa2.tar.bz2 | |
Merge branch 'list-SORT-docs' into release-3.13
Merge-request: !2453
Diffstat (limited to 'Help/command')
| -rw-r--r-- | Help/command/list.rst | 26 |
1 files changed, 15 insertions, 11 deletions
diff --git a/Help/command/list.rst b/Help/command/list.rst index ad2c428..2357a9b 100644 --- a/Help/command/list.rst +++ b/Help/command/list.rst @@ -256,20 +256,24 @@ Reverses the contents of the list in-place. 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: +Use the ``COMPARE`` keyword to select the comparison method for sorting. +The ``<compare>`` option should be one of: -* ``STRING``: Sorts a list of strings alphabetically. -* ``FILE_BASENAME``: Sort a list of pathnames of files by their basenames. +* ``STRING``: Sorts a list of strings alphabetically. This is the + default behavior if the ``COMPARE`` option is not given. +* ``FILE_BASENAME``: Sorts 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: +Use the ``CASE`` keyword to select a case sensitive or case insensitive +sort mode. The ``<case>`` option should be one of: -* ``SENSITIVE``: Sorts the list alphabetically. -* ``INSENSITIVE``: Sorts the list alphabetically in descending order. +* ``SENSITIVE``: List items are sorted in a case-sensitive manner. This is + the default behavior if the ``CASE`` option is not given. +* ``INSENSITIVE``: List items are sorted case insensitively. The order of + items which differ only by upper/lowercase is not specified. -Use the option ``<order>`` to select a case sensitive or case insensitive sort mode. -The ``<order>`` option may be one of: +To control the sort order, the ``ORDER`` keyword can be given. +The ``<order>`` option should be one of: -* ``ASCENDING``: Sorts the list in ascending order. +* ``ASCENDING``: Sorts the list in ascending order. This is the default + behavior when the ``ORDER`` option is not given. * ``DESCENDING``: Sorts the list in descending order. |