Hello:
I am new to Sphinx, and am going to use it for a python project to
generate HTML documentation. My problem is rather basic, I'm not sure
how to format my docstrings so that Sphinx can extract the
information.
I understand about using autodoc extension, and making sure that my
modules are available to python so that sphinx can find my code - my
problem is a bit basic, how do I actually comment the code?
Do I have to enter *verbatim* examples are written in the
documentation? So for example, is it like this:
def my_funct(param=None,param2=None):
"""
.. py:func:: my_funct(param=None,param2=None)
This function does something with two parameters,
which are default to :py:`None`
"""
Or do I have to document it separately in another file? A simple
python code example would really help me out.
Thanks.
--
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.
