diff --git a/Doc/library/glob.rst b/Doc/library/glob.rst
index 2a5f0ddc4ef319..9f2df6097570ad 100644
--- 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.
 
    .. note::
       Using the "``**``" pattern in large directory trees may consume