From c4454259b8f45e33cf3897946e995223cbd612cc Mon Sep 17 00:00:00 2001 From: Alex Waygood Date: Thu, 7 Dec 2023 20:57:30 +0000 Subject: [PATCH] [3.11] gh-101100: Silence Sphinx warnings when `ntpath` or `posixpath` are referenced (#112833) (cherry-picked from commit 2c3906bc4b) --- Doc/conf.py | 4 ++++ Doc/tools/.nitignore | 1 - Doc/whatsnew/3.7.rst | 6 +++--- 3 files changed, 7 insertions(+), 4 deletions(-) diff --git a/Doc/conf.py b/Doc/conf.py index 042efcea285883..cd890d5076a10f 100644 --- a/Doc/conf.py +++ b/Doc/conf.py @@ -152,6 +152,10 @@ # Deprecated function that was never documented: ('py:func', 'getargspec'), ('py:func', 'inspect.getargspec'), + # Undocumented modules that users shouldn't have to worry about + # (implementation details of `os.path`): + ('py:mod', 'ntpath'), + ('py:mod', 'posixpath'), ] # Temporary undocumented names. diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore index dd201152895c5f..c15f3b57f56120 100644 --- a/Doc/tools/.nitignore +++ b/Doc/tools/.nitignore @@ -75,7 +75,6 @@ Doc/library/multiprocessing.rst Doc/library/multiprocessing.shared_memory.rst Doc/library/numbers.rst Doc/library/optparse.rst -Doc/library/os.path.rst Doc/library/os.rst Doc/library/pickle.rst Doc/library/pickletools.rst diff --git a/Doc/whatsnew/3.7.rst b/Doc/whatsnew/3.7.rst index 9db6d4909300f4..cfc5ea800f045e 100644 --- a/Doc/whatsnew/3.7.rst +++ b/Doc/whatsnew/3.7.rst @@ -2144,9 +2144,9 @@ The following features and APIs have been removed from Python 3.7: * Removed support of the *exclude* argument in :meth:`tarfile.TarFile.add`. It was deprecated in Python 2.7 and 3.2. Use the *filter* argument instead. -* The ``splitunc()`` function in the :mod:`ntpath` module was deprecated in - Python 3.1, and has now been removed. Use the :func:`~os.path.splitdrive` - function instead. +* The :func:`!ntpath.splitunc` function was deprecated in + Python 3.1, and has now been removed. Use :func:`~os.path.splitdrive` + instead. * :func:`collections.namedtuple` no longer supports the *verbose* parameter or ``_source`` attribute which showed the generated source code for the