[Python-checkins] bpo-38524: clarify example a bit and improve formatting (GH-17406)
Tal Einat
webhook-mailer at python.org
Thu Nov 28 00:22:30 EST 2019
https://github.com/python/cpython/commit/02519f75d15b063914a11351da30178ca4ceb54b
commit: 02519f75d15b063914a11351da30178ca4ceb54b
branch: master
author: Tal Einat <taleinat+github at gmail.com>
committer: GitHub <noreply at github.com>
date: 2019-11-28T07:22:09+02:00
summary:
bpo-38524: clarify example a bit and improve formatting (GH-17406)
files:
M Doc/reference/datamodel.rst
diff --git a/Doc/reference/datamodel.rst b/Doc/reference/datamodel.rst
index 68098508afbaa..b22ed92ec964d 100644
--- a/Doc/reference/datamodel.rst
+++ b/Doc/reference/datamodel.rst
@@ -1657,13 +1657,16 @@ class' :attr:`~object.__dict__`.
.. note::
- ``__set_name__`` is only called implicitly as part of the ``type`` constructor, so
- it will need to be called explicitly with the appropriate parameters when a
- descriptor is added to a class after initial creation::
+ :meth:`__set_name__` is only called implicitly as part of the
+ :class:`type` constructor, so it will need to be called explicitly with
+ the appropriate parameters when a descriptor is added to a class after
+ initial creation::
+ class A:
+ pass
descr = custom_descriptor()
- cls.attr = descr
- descr.__set_name__(cls, 'attr')
+ A.attr = descr
+ descr.__set_name__(A, 'attr')
See :ref:`class-object-creation` for more details.
More information about the Python-checkins
mailing list