gh-148765: Fix description of include_hidden parameter in glob docs

Author: EoinTrial

Doc/library/glob.rst

@@ -70,7 +70,8 @@ The :mod:`!glob` module defines the following functions:
    pattern is followed by an :data:`os.sep` or :data:`os.altsep` then files will not
    match.
 
-   If *include_hidden* is true, "``**``" pattern will match hidden directories.
+   If *include_hidden* is true, patterns that do not begin with a dot (``.``)
+   may also match path components that begin with a dot.
 
    .. audit-event:: glob.glob pathname,recursive glob.glob
    .. audit-event:: glob.glob/2 pathname,recursive,root_dir,dir_fd glob.glob

Misc/NEWS.d/next/Documentation/2026-04-19-20-31-27.gh-issue-148765.SNB_1A.rst

@@ -0,0 +1,12 @@
+Fix inaccurate description of the *include_hidden* parameter in
+:func:`glob.glob` and :func:`glob.iglob`. The parameter allows all wildcard
+patterns to match path components beginning with a dot, not just ``**``
+matching "hidden directories" as previously stated.
+
+#.. section: Tests #.. section: Build #.. section: Windows #.. section:
+macOS #.. section: IDLE #.. section: Tools/Demos #.. section: C API
+
+# Write your Misc/NEWS.d entry below.  It should be a simple ReST paragraph.
+# Don't start with "- Issue #<n>: " or "- gh-issue-<n>: " or that sort of
+stuff.
+###########################################################################