summaryrefslogtreecommitdiffstats
path: root/Doc
diff options
context:
space:
mode:
authorHugo van Kemenade <1324225+hugovk@users.noreply.github.com>2024-03-19 19:48:08 (GMT)
committerGitHub <noreply@github.com>2024-03-19 19:48:08 (GMT)
commit9080e9ed50d1d3c7933cda88658306f6872d2f87 (patch)
treefc52ebccbec90ca3cf2e68dac6c38695c19b1987 /Doc
parent1ab0d0b1167d78bf19661a3b5e533a2b68a57604 (diff)
downloadcpython-9080e9ed50d1d3c7933cda88658306f6872d2f87.zip
cpython-9080e9ed50d1d3c7933cda88658306f6872d2f87.tar.gz
cpython-9080e9ed50d1d3c7933cda88658306f6872d2f87.tar.bz2
gh-101100: Fix Sphinx warnings in `library/pydoc.rst` (#116913)
Diffstat (limited to 'Doc')
-rw-r--r--Doc/library/pydoc.rst14
-rw-r--r--Doc/tools/.nitignore1
2 files changed, 7 insertions, 8 deletions
diff --git a/Doc/library/pydoc.rst b/Doc/library/pydoc.rst
index 03e0915..df969b2 100644
--- a/Doc/library/pydoc.rst
+++ b/Doc/library/pydoc.rst
@@ -16,19 +16,19 @@
--------------
-The :mod:`pydoc` module automatically generates documentation from Python
+The :mod:`!pydoc` module automatically generates documentation from Python
modules. The documentation can be presented as pages of text on the console,
served to a web browser, or saved to HTML files.
For modules, classes, functions and methods, the displayed documentation is
-derived from the docstring (i.e. the :attr:`__doc__` attribute) of the object,
+derived from the docstring (i.e. the :attr:`!__doc__` attribute) of the object,
and recursively of its documentable members. If there is no docstring,
-:mod:`pydoc` tries to obtain a description from the block of comment lines just
+:mod:`!pydoc` tries to obtain a description from the block of comment lines just
above the definition of the class, function or method in the source file, or at
the top of the module (see :func:`inspect.getcomments`).
The built-in function :func:`help` invokes the online help system in the
-interactive interpreter, which uses :mod:`pydoc` to generate its documentation
+interactive interpreter, which uses :mod:`!pydoc` to generate its documentation
as text on the console. The same text documentation can also be viewed from
outside the Python interpreter by running :program:`pydoc` as a script at the
operating system's command prompt. For example, running ::
@@ -46,7 +46,7 @@ produced for that file.
.. note::
- In order to find objects and their documentation, :mod:`pydoc` imports the
+ In order to find objects and their documentation, :mod:`!pydoc` imports the
module(s) to be documented. Therefore, any code on module level will be
executed on that occasion. Use an ``if __name__ == '__main__':`` guard to
only execute code when a file is invoked as a script and not just imported.
@@ -90,7 +90,7 @@ Python interpreter and typed ``import spam``.
Module docs for core modules are assumed to reside in
``https://docs.python.org/X.Y/library/`` where ``X`` and ``Y`` are the
major and minor version numbers of the Python interpreter. This can
-be overridden by setting the :envvar:`PYTHONDOCS` environment variable
+be overridden by setting the :envvar:`!PYTHONDOCS` environment variable
to a different URL or to a local directory containing the Library
Reference Manual pages.
@@ -101,7 +101,7 @@ Reference Manual pages.
The ``-g`` command line option was removed.
.. versionchanged:: 3.4
- :mod:`pydoc` now uses :func:`inspect.signature` rather than
+ :mod:`!pydoc` now uses :func:`inspect.signature` rather than
:func:`inspect.getfullargspec` to extract signature information from
callables.
diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore
index 5fbc24c..6f38f36 100644
--- a/Doc/tools/.nitignore
+++ b/Doc/tools/.nitignore
@@ -44,7 +44,6 @@ Doc/library/pickletools.rst
Doc/library/platform.rst
Doc/library/plistlib.rst
Doc/library/profile.rst
-Doc/library/pydoc.rst
Doc/library/pyexpat.rst
Doc/library/readline.rst
Doc/library/resource.rst