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

[guido.van.rossum]

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