]> granicus.if.org Git - python/commit
docroutine() (both instances): Docstrings for class methods weren't
authorTim Peters <tim.peters@gmail.com>
Thu, 27 Sep 2001 04:08:16 +0000 (04:08 +0000)
committerTim Peters <tim.peters@gmail.com>
Thu, 27 Sep 2001 04:08:16 +0000 (04:08 +0000)
commit8ac8be59885f27a1afbcc978be0dc0ceea554aa4
tree51b3a190fe3609a525d3f9fd1d07a090669fbd4a
parent351e362d8975555ca2859becdc95c4943e24ebc9
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).
Lib/pydoc.py