http://hg.python.org/peps/rev/a7b2b2d5b1d4 changeset: 5389:a7b2b2d5b1d4 user: Guido van Rossum <guido@dropbox.com> date: Fri Feb 28 09:53:33 2014 -0800 summary: PEP 257: Drop recommendation of extra blank line at end of docstring. files: pep-0257.txt | 11 +++++------ 1 files changed, 5 insertions(+), 6 deletions(-) diff --git a/pep-0257.txt b/pep-0257.txt --- a/pep-0257.txt +++ b/pep-0257.txt @@ -201,15 +201,14 @@ Keyword arguments: real -- the real part (default 0.0) imag -- the imaginary part (default 0.0) - """ - if imag == 0.0 and real == 0.0: return complex_zero + if imag == 0.0 and real == 0.0: + return complex_zero ... -The BDFL [3]_ recommends inserting a blank line between the last -paragraph in a multi-line docstring and its closing quotes, placing -the closing quotes on a line by themselves. This way, Emacs' -``fill-paragraph`` command can be used on it. +Unless the entire docstring fits on a line, place the closing quotes +on a line by themselves. This way, Emacs' ``fill-paragraph`` command +can be used on it. Handling Docstring Indentation -- Repository URL: http://hg.python.org/peps