Hi Georg,

I've downloaded the last Sphinx version from the webpage and still got the
same issue with the init__ docstring not being parsed properly.

I've investigated a litlle bit further and looked at the autodoc.py
extension. The __init__ docstring is read as expected. So, the
configuration is set correctly. Then, the __init__ docstring is appended
to the class docstring.

However, in the process_doc function (~line 405), in the loop "for
docstringlines in docstrings", the class docstring is returned twice.

Indeed, the "docstrings"  contains the following list:

docstrings = [["class dostring"],["init docstring"]]

However, the problem occurs in the call to "self.env.app.emit", where the
variable docstringlines is replaced by docstrings[0]

so the loop :  "for line in docstringlines" always loop over the class
docstring.

Any thoughts on how to cope with ? I tried to flatten the docstrings but
this does not solve the issue.

cheers
Thomas



>
> Thomas Cokelaer schrieb:
>> Hi Georg,
>>
>> Thanks for looking at this issue. Unfortunately, the documentation is
>> not
>> yet public and the project is not small and trivial to install. I will
>> look at the __init__ file again later. I know that the option
>> autoclass_content works and this is already something good to know.
>>
>> This may be related to my configuration file. I will try with a simple
>> one
>> and see if it works. I let you know anyway once I succeed to parse the
>> init.
>
> Thank you! I'm sorry I couldn't be of more help, so I'm glad if you're
> able
> to do some detective work on it.
>
> In any case, autodoc has been almost completely rewritten in the trunk; so
> it might work out of the box there.
>
> Georg
>
>
> >
>


-- 
Dr Thomas Cokelaer
UMR DAP
Avenue d'Agropolis - TA A-96/02 (Bat 2)
34398 Montpellier Cedex 5
Tel: 04 67 71 58 00 (ask number 5471)



--~--~---------~--~----~------------~-------~--~----~
You received this message because you are subscribed to the Google Groups 
"sphinx-dev" group.
To post to this group, send email to [email protected]
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
-~----------~----~----~----~------~----~------~--~---

Reply via email to