Doc: recursive glob ** follows symlinks to directories (GH-12918)

diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst
index 96584437cef16beb40463dee40234e5bfc6c88dc..92a8c4d1eb871cfe8120dca583a63756cf8d07b2 100644 (file)
--- a/Doc/library/glob.rst
+++ b/Doc/library/glob.rst
@@ -49,8 +49,9 @@ For example, ``'[?]'`` matches the character ``'?'``.
       single: **; in glob-style wildcards
 
    If *recursive* is true, the pattern "``**``" will match any files and zero or
-   more directories and subdirectories.  If the pattern is followed by an
-   ``os.sep``, only directories and subdirectories match.
+   more directories, subdirectories and symbolic links to directories. If the
+   pattern is followed by an :data:`os.sep` or :data:`os.altsep` then files will not
+   match.
 
    .. audit-event:: glob.glob pathname,recursive glob.glob