summaryrefslogtreecommitdiffstats
path: root/Help/command/file.rst
diff options
context:
space:
mode:
authorRuslan Baratov <ruslan_baratov@yahoo.com>2017-08-03 12:41:13 (GMT)
committerBrad King <brad.king@kitware.com>2017-08-03 18:00:07 (GMT)
commit75ca5f04df433cc5e34976ecae446c150ebfc214 (patch)
tree38ce98209a4d6b3946c9a85412784b0b6b5db412 /Help/command/file.rst
parent8e8bf4270734bda61acc3d0ae76c529e2e8b6834 (diff)
downloadCMake-75ca5f04df433cc5e34976ecae446c150ebfc214.zip
CMake-75ca5f04df433cc5e34976ecae446c150ebfc214.tar.gz
CMake-75ca5f04df433cc5e34976ecae446c150ebfc214.tar.bz2
Help: Document that file(GLOB) result is sorted
It has been sorted since commit v3.6.0-rc1~54^2 (file: Sort GLOB results to make it deterministic, 2016-05-14). That commit left the order unspecified in the documentation, but has been stable long enough to document now.
Diffstat (limited to 'Help/command/file.rst')
-rw-r--r--Help/command/file.rst4
1 files changed, 1 insertions, 3 deletions
diff --git a/Help/command/file.rst b/Help/command/file.rst
index 97466ff..9cdce80 100644
--- a/Help/command/file.rst
+++ b/Help/command/file.rst
@@ -105,9 +105,7 @@ Generate a list of files that match the ``<globbing-expressions>`` and
store it into the ``<variable>``. Globbing expressions are similar to
regular expressions, but much simpler. If ``RELATIVE`` flag is
specified, the results will be returned as relative paths to the given
-path. No specific order of results is defined other than that it is
-deterministic. If order is important then sort the list explicitly
-(e.g. using the :command:`list(SORT)` command).
+path. The results will be ordered lexicographically.
By default ``GLOB`` lists directories - directories are omited in result if
``LIST_DIRECTORIES`` is set to false.