Document arbitrary ordering in Path.glob

Author: johnslavik

Doc/library/pathlib.rst

@@ -1320,6 +1320,10 @@ Reading directories
    Glob the given relative *pattern* in the directory represented by this path,
    yielding all matching files (of any kind)::
 
+   .. note::
+      Akin to :mod:`glob`, the paths are returned in no particular order.
+      If you need a specific order, sort them.
+
       >>> sorted(Path('.').glob('*.py'))
       [PosixPath('pathlib.py'), PosixPath('setup.py'), PosixPath('test_pathlib.py')]
       >>> sorted(Path('.').glob('*/*.py'))