https://github.com/python/cpython/commit/c44070b2d51d59f608577b1f6c55c0168d8e416b
commit: c44070b2d51d59f608577b1f6c55c0168d8e416b
branch: 3.13
author: Miss Islington (bot) <31488909+miss-isling...@users.noreply.github.com>
committer: hugovk <1324225+hug...@users.noreply.github.com>
date: 2025-07-08T12:12:22Z
summary:
[3.13] gh-101100: Fix sphinx warnings in `Doc/library/exceptions.rst`
(GH-136309) (#136415)
Co-authored-by: Yuki Kobayashi <drsuaimqj...@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hug...@users.noreply.github.com>
files:
M Doc/library/exceptions.rst
M Doc/tools/.nitignore
diff --git a/Doc/library/exceptions.rst b/Doc/library/exceptions.rst
index 9b6e532a4833cf..f47cc0abb8b667 100644
--- a/Doc/library/exceptions.rst
+++ b/Doc/library/exceptions.rst
@@ -204,10 +204,16 @@ The following exceptions are the exceptions that are
usually raised.
assignment fails. (When an object does not support attribute references or
attribute assignments at all, :exc:`TypeError` is raised.)
- The :attr:`name` and :attr:`obj` attributes can be set using keyword-only
- arguments to the constructor. When set they represent the name of the
attribute
- that was attempted to be accessed and the object that was accessed for said
- attribute, respectively.
+ The optional *name* and *obj* keyword-only arguments
+ set the corresponding attributes:
+
+ .. attribute:: name
+
+ The name of the attribute that was attempted to be accessed.
+
+ .. attribute:: obj
+
+ The object that was accessed for the named attribute.
.. versionchanged:: 3.10
Added the :attr:`name` and :attr:`obj` attributes.
@@ -215,7 +221,7 @@ The following exceptions are the exceptions that are
usually raised.
.. exception:: EOFError
Raised when the :func:`input` function hits an end-of-file condition (EOF)
- without reading any data. (N.B.: the :meth:`io.IOBase.read` and
+ without reading any data. (Note: the :meth:`!io.IOBase.read` and
:meth:`io.IOBase.readline` methods return an empty string when they hit
EOF.)
@@ -312,9 +318,11 @@ The following exceptions are the exceptions that are
usually raised.
unqualified names. The associated value is an error message that includes
the
name that could not be found.
- The :attr:`name` attribute can be set using a keyword-only argument to the
- constructor. When set it represent the name of the variable that was
attempted
- to be accessed.
+ The optional *name* keyword-only argument sets the attribute:
+
+ .. attribute:: name
+
+ The name of the variable that was attempted to be accessed.
.. versionchanged:: 3.10
Added the :attr:`name` attribute.
@@ -382,7 +390,7 @@ The following exceptions are the exceptions that are
usually raised.
The corresponding error message, as provided by
the operating system. It is formatted by the C
- functions :c:func:`perror` under POSIX, and :c:func:`FormatMessage`
+ functions :c:func:`!perror` under POSIX, and :c:func:`!FormatMessage`
under Windows.
.. attribute:: filename
@@ -398,7 +406,7 @@ The following exceptions are the exceptions that are
usually raised.
.. versionchanged:: 3.3
:exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`,
:exc:`socket.error`, :exc:`select.error` and
- :exc:`mmap.error` have been merged into :exc:`OSError`, and the
+ :exc:`!mmap.error` have been merged into :exc:`OSError`, and the
constructor may return a subclass.
.. versionchanged:: 3.4
@@ -586,7 +594,7 @@ The following exceptions are the exceptions that are
usually raised.
handled, the Python interpreter exits; no stack traceback is printed. The
constructor accepts the same optional argument passed to :func:`sys.exit`.
If the value is an integer, it specifies the system exit status (passed to
- C's :c:func:`exit` function); if it is ``None``, the exit status is zero; if
+ C's :c:func:`!exit` function); if it is ``None``, the exit status is zero;
if
it has another type (such as a string), the object's value is printed and
the exit status is one.
diff --git a/Doc/tools/.nitignore b/Doc/tools/.nitignore
index 703330677b03a4..4b2ca6a4f2a9bc 100644
--- a/Doc/tools/.nitignore
+++ b/Doc/tools/.nitignore
@@ -17,7 +17,6 @@ Doc/library/asyncio-extending.rst
Doc/library/asyncio-policy.rst
Doc/library/email.charset.rst
Doc/library/email.parser.rst
-Doc/library/exceptions.rst
Doc/library/functools.rst
Doc/library/http.cookiejar.rst
Doc/library/http.server.rst
_______________________________________________
Python-checkins mailing list -- python-checkins@python.org
To unsubscribe send an email to python-checkins-le...@python.org
https://mail.python.org/mailman3//lists/python-checkins.python.org
Member address: arch...@mail-archive.com
