mirror of
https://github.com/python/cpython.git
synced 2025-12-08 06:10:17 +00:00
[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:
parent
376e037ecc
commit
f0e603412b
2 changed files with 19 additions and 12 deletions
|
|
@ -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.
|
||||||
|
|
||||||
|
|
|
||||||
|
|
@ -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
|
||||||
|
|
|
||||||
Loading…
Add table
Add a link
Reference in a new issue