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

[Antony Lee]

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>
<https://bugs.python.org/issue43721>
_______________________________________