[Python-Dev] PEP 8 updates/clarifications

[Guido van Rossum]

On 12/14/05, Barry Warsaw <barry at python.org> wrote:
> On Wed, 2005-12-14 at 14:10 -0800, Guido van Rossum wrote:
>
> > Thanks, Barry! I've made another pass and added a couple more tweaks,
> > hopefully non-controversial.
>
> Cool thanks Guido.  I fixed a couple of small typos.
>
> One question: you made the suggestion that a blank line separate the
> last line in a tqs docstring from its closing tqs.  I'm wondering why
> that is.  Note that python-mode now (or shall we say with the fix I just
> made ;) properly fills paragraphs in those strings, even if there is no
> blank line before the closing tqs line.

Primarily because I didn't have that fix when I wrote it, and I think
many people don't have it. And did you fix it in IDLE too?

I can make up another reason too, but this is the main one. (I think
it also visually separates the doc string paragraphs from the code
better.)

--
--Guido van Rossum (home page: http://www.python.org/~guido/)