diff -r 309e32df2f58 pep-0257.txt --- a/pep-0257.txt Wed Oct 15 18:18:02 2014 -0400 +++ b/pep-0257.txt Sat Oct 25 00:35:17 2014 +0900 @@ -140,16 +140,10 @@ docstring is indented the same as the quotes at its first line (see example below). -Insert a blank line before and after all docstrings (one-line or -multi-line) that document a class -- generally speaking, the class's -methods are separated from each other by a single blank line, and the -docstring needs to be offset from the first method by a blank line; -for symmetry, put a blank line between the class header and the -docstring. Docstrings documenting functions or methods generally -don't have this requirement, unless the function or method's body is -written as a number of blank-line separated sections -- in this case, -treat the docstring as another section, and precede it with a blank -line. +Insert a blank line after all docstrings (one-line or multi-line) that +document a class -- generally speaking, the class's methods are +separated from each other by a single blank line, and the docstring +needs to be offset from the first method by a blank line. The docstring of a script (a stand-alone program) should be usable as its "usage" message, printed when the script is invoked with incorrect