This issue tracker has been migrated to GitHub, and is currently read-only.
For more information, see the GitHub FAQs in the Python's Developer Guide.

classification
Title: __doc__ should generally be writable
Type: enhancement Stage:
Components: Interpreter Core Versions: Python 3.11
process
Status: open Resolution:
Dependencies: Superseder:
Assigned To: Nosy List: barry, gregory.p.smith, pitrou, scoder
Priority: normal Keywords:

Created on 2022-03-29 17:32 by pitrou, last changed 2022-04-11 14:59 by admin.

Messages (1)
msg416277 - (view) Author: Antoine Pitrou (pitrou) * (Python committer) Date: 2022-03-29 17:32
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.
History
Date User Action Args
2022-04-11 14:59:57adminsetgithub: 91309
2022-04-05 07:27:02gregory.p.smithsetnosy: + gregory.p.smith
2022-03-29 17:43:34barrysetnosy: + barry
2022-03-29 17:33:02pitrousetnosy: + scoder
2022-03-29 17:32:48pitroucreate