[New-bugs-announce] [issue43721] Documentation of property.{getter, setter, deleter} fails to mention that a *new* property is returned

Antony Lee report at bugs.python.org
Sat Apr 3 19:10:19 EDT 2021

New submission from Antony Lee <anntzer.lee at gmail.com>:

property.{getter,setter,deleter} returns a new property with a new {fget,fset,fdel}.  This is documented at https://docs.python.org/3/library/functions.html#property, and intended behavior (see e.g. https://bugs.python.org/issue1620).

However the corresponding docstrings, e.g. `pydoc property.getter`, are "Descriptor to change the getter (setter, deleter) on a property."  This wording suggests that no copy is being made and that the property is mutated in-place.

assignee: docs at python
components: Documentation
messages: 390149
nosy: Antony.Lee, docs at python
priority: normal
severity: normal
status: open
title: Documentation of property.{getter,setter,deleter} fails to mention that a *new* property is returned

Python tracker <report at bugs.python.org>

More information about the New-bugs-announce mailing list