docroutine() (both instances): Docstrings for class methods weren't
getting displayed, due to a special case here whose purpose I didn't understand. So just disabled the doc suppression here. Another special case here skips the docs when picking apart a method and finding that the im_func is also in the class __dict__ under the same name. That one I understood. It has a curious consequence, though, wrt inherited properties: a static class copies inherited stuff into the inheriting class's dict, and that affects whether or not this special case triggers. The upshoot is that pydoc doesn't show the function docstrings of getter/setter/deleter functions of inherited properties in the property section when the class is static, but does when the class is dynamic (bring up Lib/test/pydocfodder.py under GUI pydoc to see this).
This commit is contained in:
parent
351e362d89
commit
8ac8be5988
|
@ -759,7 +759,6 @@ TT { font-family: lucidatypewriter, lucida console, courier }
|
||||||
if cl:
|
if cl:
|
||||||
if imclass is not cl:
|
if imclass is not cl:
|
||||||
note = ' from ' + self.classlink(imclass, mod)
|
note = ' from ' + self.classlink(imclass, mod)
|
||||||
skipdocs = 1
|
|
||||||
else:
|
else:
|
||||||
if object.im_self:
|
if object.im_self:
|
||||||
note = ' method of %s instance' % self.classlink(
|
note = ' method of %s instance' % self.classlink(
|
||||||
|
@ -1117,7 +1116,6 @@ class TextDoc(Doc):
|
||||||
if cl:
|
if cl:
|
||||||
if imclass is not cl:
|
if imclass is not cl:
|
||||||
note = ' from ' + classname(imclass, mod)
|
note = ' from ' + classname(imclass, mod)
|
||||||
skipdocs = 1
|
|
||||||
else:
|
else:
|
||||||
if object.im_self:
|
if object.im_self:
|
||||||
note = ' method of %s instance' % classname(
|
note = ' method of %s instance' % classname(
|
||||||
|
|
Loading…
Reference in New Issue