[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/
RetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4