PEP 257: Drop recommendation of extra blank line at end of docstring.

python · Feb 28, 2014 · ab85e78 · ab85e78
1 parent eba9b93
commit ab85e78
Showing 1 changed file with 5 additions and 6 deletions.
diff --git a/pep-0257.txt b/pep-0257.txt
@@ -201,15 +201,14 @@ to list each argument on a separate line.  For example::
         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