[issue8488] Docstrings of non-data descriptors "ignored"

Serhiy Storchaka added the comment: Ah, all correct. In doc.py unlike to the inlined code Descriptor is a subclass of property. And since fset is None the instance is classified as a readonly property. -- resolution: -> out of date stage: -> resolved status: open -> closed

[issue8488] Docstrings of non-data descriptors "ignored"

Serhiy Storchaka added the comment: Actually there is no bug in not showing docstring for "data" and "non_data". "Doc of a data-descriptor." is the docstring of the type of the descriptor, not the descriptor itself. If it would be "Type of a data-descriptor." it would be more obvious. To

[issue8488] Docstrings of non-data descriptors "ignored"

Irit Katriel added the comment: Ah yes. Bisect seems to be pointing at this commit: https://github.com/python/cpython/commit/fbf2786c4c89430e2067016603078cf3500cfe94 -- ___ Python tracker

[issue8488] Docstrings of non-data descriptors "ignored"

Serhiy Storchaka added the comment: Python 3.7 (2.7 looks almost the same): class Demo(builtins.object) | Data descriptors defined here: | | __dict__ | dictionary for instance variables (if defined) | | __weakref__ | list of weak references to the object (if defined)

[issue8488] Docstrings of non-data descriptors "ignored"

Irit Katriel added the comment: I got this output on 3.10, so I think this has been fixed: lass Demo(builtins.object) | Readonly properties defined here: | | data | | non_data | | prop | Doc of a property. | |

[issue8488] Docstrings of non-data descriptors "ignored"

Change by Sergey Fedoseev : -- nosy: +sir-sigurd ___ Python tracker ___ ___ Python-bugs-list mailing list Unsubscribe:

[issue8488] Docstrings of non-data descriptors "ignored"

Serhiy Storchaka added the comment: Since the descriptor is classified as a routine (inspect.isroutine() returns True because inspect.ismethoddescriptor() returns True), pydoc outputs it in the "Methods defined here" section and uses the docroutine(). But docroutine() requires the __name__

[issue8488] Docstrings of non-data descriptors ignored

Changes by Éric Araujo mer...@netwok.org: -- nosy: +eric.araujo versions: +Python 2.7, Python 3.3 ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8488 ___

[issue8488] Docstrings of non-data descriptors ignored

Torsten Landschoff t.landsch...@gmx.net added the comment: FYI, this still applies to r86094 of py3k. -- ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8488 ___

[issue8488] Docstrings of non-data descriptors ignored

Changes by Raymond Hettinger rhettin...@users.sourceforge.net: -- priority: normal - low ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8488 ___

[issue8488] Docstrings of non-data descriptors ignored

Benjamin Peterson benja...@python.org added the comment: pydoc should probably be adapted to look at a type for descrs. -- nosy: +benjamin.peterson ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue8488

[issue8488] Docstrings of non-data descriptors ignored

New submission from Torsten Landschoff t.landsch...@gmx.net: [I would assign priority minor to this, but the tracker won't let me] I really like the online documentation features of python. However, I wonder about the output of the following simple example: class Descriptor(object): Doc

[issue8488] Docstrings of non-data descriptors ignored

R. David Murray rdmur...@bitdance.com added the comment: There is either an issue or a python-dev (or maybe even python-ideas) discussion about this subject somewhere. It's a much deeper issue than it appears on the surface. -- nosy: +r.david.murray versions: -Python 2.5, Python