[issue22656] `help` ignores `__doc__` of descriptors

2021-11-29 Thread Raymond Hettinger
Raymond Hettinger added the comment: This was fixed long ago in commit ac4bdcc80e986bdd5b9d10ab0bce35aabb790a3e The code is in inspect.py::_finddoc(). See issue 25503. -- nosy: +rhettinger resolution: -> out of date stage: patch review -> resolved status: open -> closed

[issue22656] `help` ignores `__doc__` of descriptors

2021-11-29 Thread Irit Katriel
Irit Katriel added the comment: I am unable to reproduce the problem on 3.11 (on a Mac). I get both help messages from Ram's code. -- nosy: +iritkatriel ___ Python tracker

[issue22656] `help` ignores `__doc__` of descriptors

2016-05-02 Thread Serhiy Storchaka
Changes by Serhiy Storchaka : -- nosy: +serhiy.storchaka ___ Python tracker ___ ___

[issue22656] `help` ignores `__doc__` of descriptors

2016-05-02 Thread Berker Peksag
Berker Peksag added the comment: The attached patch should solve this. We probably need to add more tests. test_property_subclass depends on issue 24766. -- keywords: +patch nosy: +berker.peksag stage: -> patch review type: -> behavior versions: +Python 3.5, Python 3.6 -Python 3.4

[issue22656] `help` ignores `__doc__` of descriptors

2015-07-21 Thread Ethan Furman
Changes by Ethan Furman et...@stoneleaf.us: -- nosy: -ethan.furman ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue22656 ___ ___ Python-bugs-list

[issue22656] `help` ignores `__doc__` of descriptors

2014-10-17 Thread Ram Rachum
New submission from Ram Rachum: The builtin `property` lets you specify a `doc` argument for your properties, which is great because then it shows up in `help`. So I figured that when I'm writing my own descriptor, I could set `__doc__` on it and have `help` use it. Not so, `help` ignores it.

[issue22656] `help` ignores `__doc__` of descriptors

2014-10-17 Thread R. David Murray
R. David Murray added the comment: You might find issue 5890 to be interesting reading. It's been long enough that I forget the details, but I think the short answer is yes, property is special cased. So probably what you want to do is subclass property. Given the knock-on issue that fix

[issue22656] `help` ignores `__doc__` of descriptors

2014-10-17 Thread Ethan Furman
Changes by Ethan Furman et...@stoneleaf.us: -- nosy: +ethan.furman ___ Python tracker rep...@bugs.python.org http://bugs.python.org/issue22656 ___ ___ Python-bugs-list

[issue22656] `help` ignores `__doc__` of descriptors

2014-10-17 Thread Ethan Furman
Ethan Furman added the comment: Yeah, that was interesting. ;) I think there are two different, yet related, issues: - which __doc__ should help display? - how should __doc__ be inherited? The issue we should deal with here is the first, as what help displays does not have to follow the