pycco-docs / pycco

Literate-style documentation generator.

Home Page:https://pycco-docs.github.io/pycco/

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

Docstrings

lukearno opened this issue · comments

pycco is rad but seems to fall down on docstrings.

If I have a function with a docstring like this:

def foo():
    """This is a docstring."""

The closing triplequotes seem to be missed by the parser. When I try putting them on a new line:

def foo():
    """This is a docstring.

    Ok, I'll just use a multiline docstring...
    """

There is ugly whitespace and the docstring is treated like a comment on the code inside the function and not on the function itself. .

I, too, suffer this problem. Single-line docstrings absorb the following code into the generated comment.

Fixed by pull request #38, which is now merged.