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

[anntzer]

BPO	43721
Nosy	@rhettinger, @hugovk, @miss-islington, @iritkatriel
PRs	bpo-43721: Fix docstrings for property.getter/setter/deleter #31046 [3.9] bpo-43721: Fix docstrings for property.getter/setter/deleter (GH-31046) #31886 [3.10] bpo-43721: Fix docstrings for property.getter/setter/deleter (GH-31046) #31887 Add missing newline to NEWS entry #31893

^{Note: these values reflect the state of the issue at the time it was migrated and might not reflect the current state.}

Show more details

GitHub fields:

assignee = None
closed_at = <Date 2022-03-15.00:12:50.969>
created_at = <Date 2021-04-03.23:10:19.625>
labels = ['3.11', 'type-bug', '3.9', '3.10', 'docs']
title = 'Documentation of property.{getter,setter,deleter} fails to mention that a *new* property is returned'
updated_at = <Date 2022-03-15.07:54:28.664>
user = 'https://github.com/anntzer'

bugs.python.org fields:

activity = <Date 2022-03-15.07:54:28.664>
actor = 'hugovk'
assignee = 'none'
closed = True
closed_date = <Date 2022-03-15.00:12:50.969>
closer = 'AlexWaygood'
components = ['Documentation']
creation = <Date 2021-04-03.23:10:19.625>
creator = 'Antony.Lee'
dependencies = []
files = []
hgrepos = []
issue_num = 43721
keywords = ['patch']
message_count = 4.0
messages = ['390149', '415208', '415209', '415210']
nosy_count = 5.0
nosy_names = ['rhettinger', 'docs@python', 'hugovk', 'miss-islington', 'iritkatriel']
pr_nums = ['31046', '31886', '31887', '31893']
priority = 'normal'
resolution = 'fixed'
stage = 'resolved'
status = 'closed'
superseder = None
type = 'behavior'
url = 'https://bugs.python.org/issue43721'
versions = ['Python 3.9', 'Python 3.10', 'Python 3.11']

[anntzer]

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.

[iritkatriel]

New changeset e3d348a by Irit Katriel in branch 'main':
bpo-43721: Fix docstrings for property.getter/setter/deleter (GH-31046)
e3d348a

[miss-islington]

New changeset cebdc32 by Miss Islington (bot) in branch '3.10':
bpo-43721: Fix docstrings for property.getter/setter/deleter (GH-31046)
cebdc32

[miss-islington]

New changeset f1a5e1b by Miss Islington (bot) in branch '3.9':
bpo-43721: Fix docstrings for property.getter/setter/deleter (GH-31046)
f1a5e1b