gh-146646: Document that glob functions suppress OSError

Document that glob.glob() and glob.iglob() silently suppress any
OSError exceptions raised while scanning the filesystem, such as
PermissionError when accessing directories without read permission.

The pathlib.Path.glob() docs already note this behavior (added in 3.13),
but the glob module docs did not mention it.

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>

Author: Chester Li

Doc/library/glob.rst

@@ -83,6 +83,11 @@ The :mod:`!glob` module defines the following functions:
       This function may return duplicate path names if *pathname*
       contains multiple "``**``" patterns and *recursive* is true.
 
+   .. note::
+      Any :exc:`OSError` exceptions raised from scanning the filesystem are
+      suppressed. This includes :exc:`PermissionError` when accessing
+      directories without read permission.
+
    .. versionchanged:: 3.5
       Support for recursive globs using "``**``".
 
@@ -106,6 +111,11 @@ The :mod:`!glob` module defines the following functions:
       This function may return duplicate path names if *pathname*
       contains multiple "``**``" patterns and *recursive* is true.
 
+   .. note::
+      Any :exc:`OSError` exceptions raised from scanning the filesystem are
+      suppressed. This includes :exc:`PermissionError` when accessing
+      directories without read permission.
+
    .. versionchanged:: 3.5
       Support for recursive globs using "``**``".
 

Misc/NEWS.d/next/Documentation/2026-04-02-07-20-00.gh-issue-146646.GlobDoc1.rst

@@ -0,0 +1,2 @@
+Document that :func:`glob.glob` and :func:`glob.iglob` silently suppress
+:exc:`OSError` exceptions raised from scanning the filesystem.