the issue has a simple workaround, which is to docstring like this:
def __init__(self):
"""
Begin the description here.
"""
I.e., a newline then the indent prevents the concatenation of
"classdoc" + "\n\n" + "initdoc" from screwing up the indentation.
The usual, "this should be accounted for/ or throw a warning" requests
apply here.
Also would it be so controversial to include __init__ as one of the
methods auto-rendered by :members: ? Or at least a config option
autoclass_content='split' which does this ? im not so thrilled with
the look of "autoclass_content='both'". The workaround of explicitly
adding __init__ to :members: means the whole "automembers"
functionality is gone, since its all auto or all manual. That's
another silly thing...can't it support a syntax like ":members:
+__init__", meaning "give me all the automembers, plus __init__" ? I
can of course provide patches for all this since its pretty simple.
--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups
"sphinx-dev" group.
To post to this group, send email to sphinx-dev@googlegroups.com
To unsubscribe from this group, send email to [EMAIL PROTECTED]
For more options, visit this group at
http://groups.google.com/group/sphinx-dev?hl=en
-~----------~----~----~----~------~----~------~--~---
