diff options
author | Hugo van Kemenade <1324225+hugovk@users.noreply.github.com> | 2024-03-19 19:48:08 (GMT) |
---|---|---|
committer | GitHub <noreply@github.com> | 2024-03-19 19:48:08 (GMT) |
commit | 9080e9ed50d1d3c7933cda88658306f6872d2f87 (patch) | |
tree | fc52ebccbec90ca3cf2e68dac6c38695c19b1987 /Doc | |
parent | 1ab0d0b1167d78bf19661a3b5e533a2b68a57604 (diff) | |
download | cpython-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.rst | 14 | ||||
-rw-r--r-- | Doc/tools/.nitignore | 1 |
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 |