Sphinx - quick lookup
Hello,
I seem to be having issue with quick documentation lookup when docstring format is set to reStructuredText. The internal help says that in this case, quick-lookup is generated by Sphinx. However, the generated text is quite chaotic and not parsed at all:
I would expect output more similar to the Epytext option (parameters grouped together with their types, etc.):
I have setup the Sphinx working directory to the one created by sphinx-quickstart. I've tried to create ClassName.rst file with autoclass directive, but to no avail.
Have I missed some configuration or is this the expected result when using reStructuredText docstrings?
Thank you,
Pavel
I seem to be having issue with quick documentation lookup when docstring format is set to reStructuredText. The internal help says that in this case, quick-lookup is generated by Sphinx. However, the generated text is quite chaotic and not parsed at all:
I would expect output more similar to the Epytext option (parameters grouped together with their types, etc.):
I have setup the Sphinx working directory to the one created by sphinx-quickstart. I've tried to create ClassName.rst file with autoclass directive, but to no avail.
Have I missed some configuration or is this the expected result when using reStructuredText docstrings?
Thank you,
Pavel
请先登录再写评论。
What I see as the problem is that parameters, exceptions etc are not grouped together and their expected types are not displayed with them, but separately. So, on the quick look, you do not get a nice list of parameters like when using Epytext.
The difference is visible on the images - with Epytext, you get nicely divided parameters, exceptions, return values - easily readable. With reStructuredText, the text is just taken as-is and bold emphasis is added.
If you can confirm this is not intended, I will happily submit a bug. Right now, I don't know if it's not just a configuration problem.