diff options
| author | Brad King <brad.king@kitware.com> | 2018-10-08 15:25:33 (GMT) |
|---|---|---|
| committer | Kitware Robot <kwrobot@kitware.com> | 2018-10-08 15:25:38 (GMT) |
| commit | c76e024a3dee8933ff5b213149c295e2925b4860 (patch) | |
| tree | 67beaf240b96c8c805c5975d7e54a0f85567dd7f | |
| parent | f87b0be825ce417fbdc5fd184e6af3d36dd89677 (diff) | |
| parent | cdf8d79e9f02e360b14f675d36587dd94afbb915 (diff) | |
| download | CMake-c76e024a3dee8933ff5b213149c295e2925b4860.zip CMake-c76e024a3dee8933ff5b213149c295e2925b4860.tar.gz CMake-c76e024a3dee8933ff5b213149c295e2925b4860.tar.bz2 | |
Merge topic 'list-SORT-docs'
cdf8d79e9f Help: Improve/fix incorrect docs for list(SORT) sub-options
Acked-by: Kitware Robot <kwrobot@kitware.com>
Merge-request: !2453
| -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. |