[Python-checkins] peps: PEP 257: Drop recommendation of extra blank line at end of docstring.

Fri Feb 28 18:53:36 CET 2014

http://hg.python.org/peps/rev/a7b2b2d5b1d4
changeset: 5389:a7b2b2d5b1d4
user: Guido van Rossum <guido at 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
