[3.14] gh-101100: Fix sphinx warnings in Doc/library/exceptions.rst (GH-136309) (#136414)

Co-authored-by: Yuki Kobayashi <drsuaimqjgar@gmail.com>
Co-authored-by: Hugo van Kemenade <1324225+hugovk@users.noreply.github.com>
This commit is contained in:
Miss Islington (bot) 2025-07-08 14:11:28 +02:00 committed by GitHub
parent 376e037ecc
commit f0e603412b
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 19 additions and 12 deletions

View file

@ -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 assignment fails. (When an object does not support attribute references or
attribute assignments at all, :exc:`TypeError` is raised.) attribute assignments at all, :exc:`TypeError` is raised.)
The :attr:`name` and :attr:`obj` attributes can be set using keyword-only The optional *name* and *obj* keyword-only arguments
arguments to the constructor. When set they represent the name of the attribute set the corresponding attributes:
that was attempted to be accessed and the object that was accessed for said
attribute, respectively. .. 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 .. versionchanged:: 3.10
Added the :attr:`name` and :attr:`obj` attributes. Added the :attr:`name` and :attr:`obj` attributes.
@ -215,7 +221,7 @@ The following exceptions are the exceptions that are usually raised.
.. exception:: EOFError .. exception:: EOFError
Raised when the :func:`input` function hits an end-of-file condition (EOF) 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.) :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 unqualified names. The associated value is an error message that includes the
name that could not be found. name that could not be found.
The :attr:`name` attribute can be set using a keyword-only argument to the The optional *name* keyword-only argument sets the attribute:
constructor. When set it represent the name of the variable that was attempted
to be accessed. .. attribute:: name
The name of the variable that was attempted to be accessed.
.. versionchanged:: 3.10 .. versionchanged:: 3.10
Added the :attr:`name` attribute. 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 corresponding error message, as provided by
the operating system. It is formatted by the C 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. under Windows.
.. attribute:: filename .. attribute:: filename
@ -398,7 +406,7 @@ The following exceptions are the exceptions that are usually raised.
.. versionchanged:: 3.3 .. versionchanged:: 3.3
:exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`, :exc:`EnvironmentError`, :exc:`IOError`, :exc:`WindowsError`,
:exc:`socket.error`, :exc:`select.error` and :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. constructor may return a subclass.
.. versionchanged:: 3.4 .. versionchanged:: 3.4
@ -590,7 +598,7 @@ The following exceptions are the exceptions that are usually raised.
handled, the Python interpreter exits; no stack traceback is printed. The handled, the Python interpreter exits; no stack traceback is printed. The
constructor accepts the same optional argument passed to :func:`sys.exit`. 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 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 it has another type (such as a string), the object's value is printed and
the exit status is one. the exit status is one.

View file

@ -16,7 +16,6 @@ Doc/library/ast.rst
Doc/library/asyncio-extending.rst Doc/library/asyncio-extending.rst
Doc/library/email.charset.rst Doc/library/email.charset.rst
Doc/library/email.parser.rst Doc/library/email.parser.rst
Doc/library/exceptions.rst
Doc/library/functools.rst Doc/library/functools.rst
Doc/library/http.cookiejar.rst Doc/library/http.cookiejar.rst
Doc/library/http.server.rst Doc/library/http.server.rst