R. David Murray added the comment:

Yeah, on reflection (after I posted) I can see why people tend to leave out 
that blank line, because it is more parallel to not having a blank line after 
the 'def'.  And I don't think I've ever seen anyone do the alternate version of 
keeping things parallel by putting a blank line before the docstring if the 
method has multiple sections, despite the recommendation in the PEP to do so.

However, you then need to delete the "if a method is written as a number of 
sections" sentence, since it has the same problem (it is recommending a blank 
line before the docstring, which nobody does...I didn't remember that 
recommendation at all myself).

----------
resolution: not a bug -> 
stage: resolved -> needs patch
status: closed -> open

_______________________________________
Python tracker <rep...@bugs.python.org>
<http://bugs.python.org/issue22715>
_______________________________________
_______________________________________________
Python-bugs-list mailing list
Unsubscribe: 
https://mail.python.org/mailman/options/python-bugs-list/archive%40mail-archive.com

Reply via email to