__doc__ should generally be writable

[pitrou]

BPO	47153
Nosy	@warsaw, @gpshead, @pitrou, @scoder

^{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 = None
created_at = <Date 2022-03-29.17:32:48.885>
labels = ['interpreter-core', 'type-feature', '3.11']
title = '__doc__ should generally be writable'
updated_at = <Date 2022-04-05.07:27:02.781>
user = 'https://github.com/pitrou'

bugs.python.org fields:

activity = <Date 2022-04-05.07:27:02.781>
actor = 'gregory.p.smith'
assignee = 'none'
closed = False
closed_date = None
closer = None
components = ['Interpreter Core']
creation = <Date 2022-03-29.17:32:48.885>
creator = 'pitrou'
dependencies = []
files = []
hgrepos = []
issue_num = 47153
keywords = []
message_count = 1.0
messages = ['416277']
nosy_count = 4.0
nosy_names = ['barry', 'gregory.p.smith', 'pitrou', 'scoder']
pr_nums = []
priority = 'normal'
resolution = None
stage = None
status = 'open'
superseder = None
type = 'enhancement'
url = 'https://bugs.python.org/issue47153'
versions = ['Python 3.11']

[pitrou]

The __doc__ attribute of several object types is not writable: notably descriptors (method/member/getset), as well builtin methods.

This is annoying when wanting to generate docstrings for these objects dynamically. While it's not useful for regular Python code, it comes up when using Cython, which uses these types to implement the methods and properties of "cdef" classes.

[rhettinger]

+1