Code examples in docstrings

[anntzer]

"""A module docstring

This is an example::

    def foo():
        ...

Right?

"""

Trying to fold this snippet results in the indented code example getting folded together with the line below ("Right?").

[tmhedberg]

Do you consider this to be a bug because you think the entire module docstring should be folded, or because you don't think the embedded code example should be folded? If the former, you should know that the plugin doesn't currently fold module docstrings (see #43).

[anntzer]

Sorry, I misdescribed the issue; edited the OP.

Additionally, this also affects function docstrings: it is impossible to have just the function docstring folded in the following:

def foo():
    """A module docstring

    This is an example::

        def foo():
            ...

    Right?

    """
    pass

[rflynn]

+1 heredocs are an issue for me as well