mirrors/cpython
1
0
Fork 0
mirror of https://github.com/python/cpython.git synced 2025-08-31 22:18:28 +00:00
Code Issues Projects Releases Packages Wiki Activity Actions 9

gh-101100: Fix Sphinx warnings in reference/expressions.rst (#114194)

Browse source
This commit is contained in:
Hugo van Kemenade 2024-01-22 18:21:14 +02:00 • committed by GitHub
parent 1b719b39b9
commit 8ccd1ba461
No known key found for this signature in database
GPG key ID: B5690EEEBB952194
2 changed files with 26 additions and 27 deletions
Download patch file Download diff file Expand all files Collapse all files

52
Doc/reference/expressions.rst
View file

@ -1001,7 +1001,7 @@ but does not affect the semantics.
The primary must evaluate to a callable object (user-defined functions, built-in The primary must evaluate to a callable object (user-defined functions, built-in
functions, methods of built-in objects, class objects, methods of class functions, methods of built-in objects, class objects, methods of class
instances, and all objects having a :meth:`__call__` method are callable). All instances, and all objects having a :meth:`~object.__call__` method are callable). All
argument expressions are evaluated before the call is attempted. Please refer argument expressions are evaluated before the call is attempted. Please refer
to section :ref:`function` for the syntax of formal :term:`parameter` lists. to section :ref:`function` for the syntax of formal :term:`parameter` lists.
@ -1159,7 +1159,7 @@ a class instance:
pair: instance; call pair: instance; call
single: __call__() (object method) single: __call__() (object method)
The class must define a :meth:`__call__` method; the effect is then the same as The class must define a :meth:`~object.__call__` method; the effect is then the same as
if that method was called. if that method was called.
@ -1211,7 +1211,7 @@ Raising ``0.0`` to a negative power results in a :exc:`ZeroDivisionError`.
Raising a negative number to a fractional power results in a :class:`complex` Raising a negative number to a fractional power results in a :class:`complex`
number. (In earlier versions it raised a :exc:`ValueError`.) number. (In earlier versions it raised a :exc:`ValueError`.)
This operation can be customized using the special :meth:`__pow__` method. This operation can be customized using the special :meth:`~object.__pow__` method.
.. _unary: .. _unary:
@ -1234,7 +1234,7 @@ All unary arithmetic and bitwise operations have the same priority:
single: - (minus); unary operator single: - (minus); unary operator
The unary ``-`` (minus) operator yields the negation of its numeric argument; the The unary ``-`` (minus) operator yields the negation of its numeric argument; the
operation can be overridden with the :meth:`__neg__` special method. operation can be overridden with the :meth:`~object.__neg__` special method.
.. index:: .. index::
single: plus single: plus
@ -1242,7 +1242,7 @@ operation can be overridden with the :meth:`__neg__` special method.
single: + (plus); unary operator single: + (plus); unary operator
The unary ``+`` (plus) operator yields its numeric argument unchanged; the The unary ``+`` (plus) operator yields its numeric argument unchanged; the
operation can be overridden with the :meth:`__pos__` special method. operation can be overridden with the :meth:`~object.__pos__` special method.
.. index:: .. index::
single: inversion single: inversion
@ -1251,7 +1251,7 @@ operation can be overridden with the :meth:`__pos__` special method.
The unary ``~`` (invert) operator yields the bitwise inversion of its integer The unary ``~`` (invert) operator yields the bitwise inversion of its integer
argument. The bitwise inversion of ``x`` is defined as ``-(x+1)``. It only argument. The bitwise inversion of ``x`` is defined as ``-(x+1)``. It only
applies to integral numbers or to custom objects that override the applies to integral numbers or to custom objects that override the
:meth:`__invert__` special method. :meth:`~object.__invert__` special method.
@ -1289,8 +1289,8 @@ the other must be a sequence. In the former case, the numbers are converted to a
common type and then multiplied together. In the latter case, sequence common type and then multiplied together. In the latter case, sequence
repetition is performed; a negative repetition factor yields an empty sequence. repetition is performed; a negative repetition factor yields an empty sequence.
This operation can be customized using the special :meth:`__mul__` and This operation can be customized using the special :meth:`~object.__mul__` and
:meth:`__rmul__` methods. :meth:`~object.__rmul__` methods.
.. index:: .. index::
single: matrix multiplication single: matrix multiplication
@ -1314,8 +1314,8 @@ integer; the result is that of mathematical division with the 'floor' function
applied to the result. Division by zero raises the :exc:`ZeroDivisionError` applied to the result. Division by zero raises the :exc:`ZeroDivisionError`
exception. exception.
This operation can be customized using the special :meth:`__truediv__` and This operation can be customized using the special :meth:`~object.__truediv__` and
:meth:`__floordiv__` methods. :meth:`~object.__floordiv__` methods.
.. index:: .. index::
single: modulo single: modulo
@ -1340,7 +1340,7 @@ also overloaded by string objects to perform old-style string formatting (also
known as interpolation). The syntax for string formatting is described in the known as interpolation). The syntax for string formatting is described in the
Python Library Reference, section :ref:`old-string-formatting`. Python Library Reference, section :ref:`old-string-formatting`.
The *modulo* operation can be customized using the special :meth:`__mod__` method. The *modulo* operation can be customized using the special :meth:`~object.__mod__` method.
The floor division operator, the modulo operator, and the :func:`divmod` The floor division operator, the modulo operator, and the :func:`divmod`
function are not defined for complex numbers. Instead, convert to a floating function are not defined for complex numbers. Instead, convert to a floating
@ -1356,8 +1356,8 @@ must either both be numbers or both be sequences of the same type. In the
former case, the numbers are converted to a common type and then added together. former case, the numbers are converted to a common type and then added together.
In the latter case, the sequences are concatenated. In the latter case, the sequences are concatenated.
This operation can be customized using the special :meth:`__add__` and This operation can be customized using the special :meth:`~object.__add__` and
:meth:`__radd__` methods. :meth:`~object.__radd__` methods.
.. index:: .. index::
single: subtraction single: subtraction
@ -1367,7 +1367,7 @@ This operation can be customized using the special :meth:`__add__` and
The ``-`` (subtraction) operator yields the difference of its arguments. The The ``-`` (subtraction) operator yields the difference of its arguments. The
numeric arguments are first converted to a common type. numeric arguments are first converted to a common type.
This operation can be customized using the special :meth:`__sub__` method. This operation can be customized using the special :meth:`~object.__sub__` method.
.. _shifting: .. _shifting:
@ -1388,8 +1388,8 @@ The shifting operations have lower priority than the arithmetic operations:
These operators accept integers as arguments. They shift the first argument to These operators accept integers as arguments. They shift the first argument to
the left or right by the number of bits given by the second argument. the left or right by the number of bits given by the second argument.
This operation can be customized using the special :meth:`__lshift__` and This operation can be customized using the special :meth:`~object.__lshift__` and
:meth:`__rshift__` methods. :meth:`~object.__rshift__` methods.
.. index:: pair: exception; ValueError .. index:: pair: exception; ValueError
@ -1416,8 +1416,8 @@ Each of the three bitwise operations has a different priority level:
pair: operator; & (ampersand) pair: operator; & (ampersand)
The ``&`` operator yields the bitwise AND of its arguments, which must be The ``&`` operator yields the bitwise AND of its arguments, which must be
integers or one of them must be a custom object overriding :meth:`__and__` or integers or one of them must be a custom object overriding :meth:`~object.__and__` or
:meth:`__rand__` special methods. :meth:`~object.__rand__` special methods.
.. index:: .. index::
pair: bitwise; xor pair: bitwise; xor
@ -1425,8 +1425,8 @@ integers or one of them must be a custom object overriding :meth:`__and__` or
pair: operator; ^ (caret) pair: operator; ^ (caret)
The ``^`` operator yields the bitwise XOR (exclusive OR) of its arguments, which The ``^`` operator yields the bitwise XOR (exclusive OR) of its arguments, which
must be integers or one of them must be a custom object overriding :meth:`__xor__` or must be integers or one of them must be a custom object overriding :meth:`~object.__xor__` or
:meth:`__rxor__` special methods. :meth:`~object.__rxor__` special methods.
.. index:: .. index::
pair: bitwise; or pair: bitwise; or
@ -1434,8 +1434,8 @@ must be integers or one of them must be a custom object overriding :meth:`__xor_
pair: operator; | (vertical bar) pair: operator; | (vertical bar)
The ``|`` operator yields the bitwise (inclusive) OR of its arguments, which The ``|`` operator yields the bitwise (inclusive) OR of its arguments, which
must be integers or one of them must be a custom object overriding :meth:`__or__` or must be integers or one of them must be a custom object overriding :meth:`~object.__or__` or
:meth:`__ror__` special methods. :meth:`~object.__ror__` special methods.
.. _comparisons: .. _comparisons:
@ -1502,7 +1502,7 @@ comparison implementation.
Because all types are (direct or indirect) subtypes of :class:`object`, they Because all types are (direct or indirect) subtypes of :class:`object`, they
inherit the default comparison behavior from :class:`object`. Types can inherit the default comparison behavior from :class:`object`. Types can
customize their comparison behavior by implementing customize their comparison behavior by implementing
:dfn:`rich comparison methods` like :meth:`__lt__`, described in :dfn:`rich comparison methods` like :meth:`~object.__lt__`, described in
:ref:`customization`. :ref:`customization`.
The default behavior for equality comparison (``==`` and ``!=``) is based on The default behavior for equality comparison (``==`` and ``!=``) is based on
@ -1666,12 +1666,12 @@ substring of *y*. An equivalent test is ``y.find(x) != -1``. Empty strings are
always considered to be a substring of any other string, so ``"" in "abc"`` will always considered to be a substring of any other string, so ``"" in "abc"`` will
return ``True``. return ``True``.
For user-defined classes which define the :meth:`__contains__` method, ``x in For user-defined classes which define the :meth:`~object.__contains__` method, ``x in
y`` returns ``True`` if ``y.__contains__(x)`` returns a true value, and y`` returns ``True`` if ``y.__contains__(x)`` returns a true value, and
``False`` otherwise. ``False`` otherwise.
For user-defined classes which do not define :meth:`__contains__` but do define For user-defined classes which do not define :meth:`~object.__contains__` but do define
:meth:`__iter__`, ``x in y`` is ``True`` if some value ``z``, for which the :meth:`~object.__iter__`, ``x in y`` is ``True`` if some value ``z``, for which the
expression ``x is z or x == z`` is true, is produced while iterating over ``y``. expression ``x is z or x == z`` is true, is produced while iterating over ``y``.
If an exception is raised during the iteration, it is as if :keyword:`in` raised If an exception is raised during the iteration, it is as if :keyword:`in` raised
that exception. that exception.

1
Doc/tools/.nitignore
View file

@ -95,7 +95,6 @@ Doc/library/xmlrpc.server.rst
Doc/library/zlib.rst Doc/library/zlib.rst
Doc/reference/compound_stmts.rst Doc/reference/compound_stmts.rst
Doc/reference/datamodel.rst Doc/reference/datamodel.rst
Doc/reference/expressions.rst
Doc/reference/import.rst Doc/reference/import.rst
Doc/tutorial/datastructures.rst Doc/tutorial/datastructures.rst
Doc/using/windows.rst Doc/using/windows.rst