[Guido]

...

...

I was originally going to make it an unnamed string literal -- maybe that's better?

[David]

...

In PEP 258 I call those "Additional Docstrings":

[Guido]

Ah, I thought there had to be something like that. :-)

Do you also recognize this if there are comments between? Or blank lines? E.g.

def f(): """ foo """

# blah

""" bar """

We haven't gotten that far get. I see no problems with blank lines, but comments may block recognition, unless we choose to ignore them. On the other hand, comments themselves may be used in some circumstances; HappyDoc recognizes comments *before* a def/class statement if there's no docstring. There's still much to be thought out. -- David Goodger <goodger@users.sourceforge.net> Open-source projects: - Python Docutils: http://docutils.sourceforge.net/ (includes reStructuredText: http://docutils.sf.net/rst.html) - The Go Tools Project: http://gotools.sourceforge.net/