diff --git a/Doc/library/pathlib.rst b/Doc/library/pathlib.rst index 60791725c2323d..084d8bf4d3ca2b 100644 --- a/Doc/library/pathlib.rst +++ b/Doc/library/pathlib.rst @@ -993,6 +993,10 @@ call fails (for example because the path doesn't exist). Set *follow_symlinks* to ``True`` or ``False`` to improve performance of recursive globbing. + This method calls :meth:`Path.is_dir` on the top-level directory and + propagates any :exc:`OSError` exception that is raised. Subsequent + :exc:`OSError` exceptions from scanning directories are suppressed. + By default, or when the *case_sensitive* keyword-only argument is set to ``None``, this method matches paths using platform-specific casing rules: typically, case-sensitive on POSIX, and case-insensitive on Windows. diff --git a/Misc/NEWS.d/next/Documentation/2024-01-13-19-36-51.gh-issue-78988.QC-EQP.rst b/Misc/NEWS.d/next/Documentation/2024-01-13-19-36-51.gh-issue-78988.QC-EQP.rst new file mode 100644 index 00000000000000..ab34a29c2523e7 --- /dev/null +++ b/Misc/NEWS.d/next/Documentation/2024-01-13-19-36-51.gh-issue-78988.QC-EQP.rst @@ -0,0 +1 @@ +Document :meth:`pathlib.Path.glob` exception propagation.