diff options
| author | Miss Islington (bot) <31488909+miss-islington@users.noreply.github.com> | 2021-10-06 11:52:22 -0700 |
|---|---|---|
| committer | GitHub <noreply@github.com> | 2021-10-06 20:52:22 +0200 |
| commit | ce121fd8755d4db9511ce4aab39d0577165e118e (patch) | |
| tree | 3f9be283aaf0d26204d87654ecb86ea082650c24 | |
| parent | 4c35a2aa80d7f55573d83651883d8733fac01e31 (diff) | |
| download | cpython-git-ce121fd8755d4db9511ce4aab39d0577165e118e.tar.gz | |
[doc] Mention __slots__ behavior in weakref.rst (GH-21061) (GH-28772)
It took me longer than I expected to figure out why a random class
I dealt with didn't support weak references. I believe this addition
will make the __slots__/weakref interaction more discoverable to people
having troubles with this. (Before this patch __slots__ was not
mentioned in weakref documentation even once).
Co-authored-by: Ćukasz Langa <lukasz@langa.pl>
(cherry picked from commit b24b47e64355224c1bf4e46ed7c4d9f7df4e6f09)
Co-authored-by: Jakub Stasiak <jakub@stasiak.at>
| -rw-r--r-- | Doc/library/weakref.rst | 4 |
1 files changed, 4 insertions, 0 deletions
diff --git a/Doc/library/weakref.rst b/Doc/library/weakref.rst index b88543e445..4b0945c020 100644 --- a/Doc/library/weakref.rst +++ b/Doc/library/weakref.rst @@ -88,6 +88,10 @@ support weak references but can add support through subclassing:: Extension types can easily be made to support weak references; see :ref:`weakref-support`. +When ``__slots__`` are defined for a given type, weak reference support is +disabled unless a ``'__weakref__'`` string is also present in the sequence of +strings in the ``__slots__`` declaration. +See :ref:`__slots__ documentation <slots>` for details. .. class:: ref(object[, callback]) |
