[3.12] gh-101100: Silence Sphinx warnings when `ntpath` or `posixpath` are referenced...

(cherry-picked from commit 2c3906bc4b)

diff --git a/Doc/conf.py b/Doc/conf.py
index 6bc8090f62f3d25e2b749d3f0350a53b08a9ff83..c8e4e0f5790f05d826d96a19d58268ca0079b08e 100644 (file)
--- a/Doc/conf.py
+++ b/Doc/conf.py
@@ -160,6 +160,10 @@ nitpick_ignore = [
     # 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 039bbf7a844cc2d281535185eb49c561862d558d..3b5bd6a108cd795156440a73c23bea4bce45272c 100644 (file)
--- a/Doc/tools/.nitignore
+++ b/Doc/tools/.nitignore
@@ -82,7 +82,6 @@ Doc/library/multiprocessing.shared_memory.rst
 Doc/library/nntplib.rst
 Doc/library/numbers.rst
 Doc/library/optparse.rst
-Doc/library/os.path.rst
 Doc/library/os.rst
 Doc/library/ossaudiodev.rst
 Doc/library/pickle.rst

diff --git a/Doc/whatsnew/3.7.rst b/Doc/whatsnew/3.7.rst
index 625140bb15613867578bce9decae15329fd74e3e..fbd495e3d8651af46c3949ac5ba4037514e99726 100644 (file)
--- 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