浏览代码

Merge topic 'doc-file-GLOB-no-order'

5a208f83 Help: Document that file(GLOB*) order is undefined
Brad King 10 年之前
父节点
当前提交
f1de724f41
共有 1 个文件被更改,包括 2 次插入1 次删除
  1. 2 1
      Help/command/file.rst

+ 2 - 1
Help/command/file.rst

@@ -103,7 +103,8 @@ Generate a list of files that match the ``<globbing-expressions>`` and
 store it into the ``<variable>``.  Globbing expressions are similar to
 store it into the ``<variable>``.  Globbing expressions are similar to
 regular expressions, but much simpler.  If ``RELATIVE`` flag is
 regular expressions, but much simpler.  If ``RELATIVE`` flag is
 specified, the results will be returned as relative paths to the given
 specified, the results will be returned as relative paths to the given
-path.
+path.  No specific order of results is defined.  If order is important then
+sort the list explicitly (e.g. using the :command:`list(SORT)` command).
 
 
 By default ``GLOB`` lists directories - directories are omited in result if
 By default ``GLOB`` lists directories - directories are omited in result if
 ``LIST_DIRECTORIES`` is set to false.
 ``LIST_DIRECTORIES`` is set to false.