sage_getdoc_original() finds wrong doc

[jdemeyer]

sage: from sage.misc.sageinspect import *
sage: print(sage_getdoc_original(sage.categories.category_types.AbelianCategory))

        Initializes this category.

        EXAMPLES::

            sage: class SemiprimitiveRings(Category):
...

This is the doc for Category.__init__ and it seems incorrect to use this as doc for AbelianCategory.

[jdemeyer]

Erik: I moved the first commit of #24312 to this ticket. This is meant to make it easier to review #24312.

---

New commits:

​6c09c50	Replace the argument name 'object' with just 'obj'--this is consistent with other functions in this module, and doesn't involve a jarring overwrite of a built-in
​c1c83e3	Only take __init__.__doc__ from the actual class

[embray]

I'm not necessarily sure this is the best case either. I could imagine cases where I would want to inherit the docstring from the base class's __init__. Better though would be to just write docstrings for each class where applicable...

[jdemeyer]

Replying to embray:

I could imagine cases where I would want to inherit the docstring from the base class's __init__.

Maybe, but inheriting docstrings is not what Python does, so that should be considered a bug unless explicitly asked for.

[embray]

Alright then, I trust you've thought it through.