[Python-Dev] PEP 8 updates/clarifications

[Barry Warsaw]

On Wed, 2005-12-14 at 17:04 -0800, Guido van Rossum wrote:

> > 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. 

Actually, the fix just made paragraph filling not throw an error.  I'm
pretty sure the bug of M-q filling past the closing tqs has been fixed
for a long time.

> And did you fix it in IDLE too?

Nope, I assigned that to Tim <wink>.

> 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.)

I'm just trying to suss out whether the reason is linked to the old
python-mode bug or whether there's a stylistic motivation here.  If it's
the former, I think we should remove the recommendation.  If it's the
latter, I might disagree but we can leave it in.

-Barry

-------------- next part --------------
A non-text attachment was scrubbed...
Name: not available
Type: application/pgp-signature
Size: 307 bytes
Desc: This is a digitally signed message part
Url : http://mail.python.org/pipermail/python-dev/attachments/20051215/a842457f/attachment.pgp