On 6/26/2013 9:56 PM, Guido van Rossum wrote:
PEP 257 says this on the formatting of multi-line docstrings:
"""
Multi-line docstrings consist of a summary line just like a one-line
docstring, followed by a blank line, followed by a more elaborate
description.
fileinput has docstrings like
"""
Return the file number of the current file. When no file is currently
opened, returns -1.
"""
and, perhaps neater,
"""
Return the name of the file currently being read.
Before the first line has been read, returns None.
"""
From the above, I presume these should become
"""
Return the file number of the current file.
When no file is currently opened, returns -1.
"""
and
"""
Return the name of the file currently being read.
Before the first line has been read, returns None.
"""
--
Terry Jan Reedy
_______________________________________________
Python-Dev mailing list
Python-Dev@python.org
http://mail.python.org/mailman/listinfo/python-dev
Unsubscribe:
http://mail.python.org/mailman/options/python-dev/archive%40mail-archive.com