<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=Windows-1252">
</head>
<body dir="auto">
<div>Approved :-)<br>
<br>
</div>
<div><br>
On Feb 27, 2014, at 9:33 PM, "Guido van Rossum" <<a href="mailto:guido@python.org">guido@python.org</a>> wrote:<br>
<br>
</div>
<blockquote type="cite">
<div>
<div dir="ltr">How about this patch? <a href="http://codereview.appspot.com/69870043">
http://codereview.appspot.com/69870043</a><br>
</div>
<div class="gmail_extra"><br>
<br>
<div class="gmail_quote">On Thu, Feb 27, 2014 at 5:48 PM, Ziad Sawalha <span dir="ltr">
<<a href="mailto:ziad.sawalha@rackspace.com" target="_blank">ziad.sawalha@rackspace.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
<div dir="auto">
<div class="">
<div><br>
</div>
<div>On Feb 27, 2014, at 4:42 PM, "Bruce Leban" <<a href="mailto:bruce@leapyear.org" target="_blank">bruce@leapyear.org</a>> wrote:<br>
<br>
</div>
<blockquote type="cite">
<div>
<div dir="ltr">To clarify are you asking to delete the recommendation of a blank line or the entire recommendation?
<div><br>
</div>
<div><span style="font-size:13px;font-family:arial,sans-serif">That is are you suggesting the recommendation change to</span></div>
<div><span style="font-size:13px;font-family:arial,sans-serif"><br>
</span></div>
<blockquote style="margin:0 0 0 40px;border:none;padding:0px">
<div><span style="font-size:13px;font-family:arial,sans-serif">“It is recommended to place</span><span style="font-size:13px;font-family:arial,sans-serif"> the closing quotes on a line by themselves."</span></div>
</blockquote>
</div>
</div>
</blockquote>
<div><br>
</div>
</div>
<div>That's right. I just want to get rid of the recommendation for the blank line.</div>
<div class=""><br>
<blockquote type="cite">
<div>
<div dir="ltr">
<div>
<div>I think deleting it completely is a bad idea as otherwise it's hard to see where the docstring ends and the code begins, especially when using doctest.</div>
</div>
</div>
<div class="gmail_extra"><br clear="all">
<div>
<div dir="ltr"><font face="arial, helvetica, sans-serif">--- Bruce<br>
</font>
<div>
<div><font face="arial, helvetica, sans-serif">Learn how hackers think: <a href="http://j.mp/gruyere-security" target="_blank">http://j.mp/gruyere-security</a></font></div>
</div>
<div>
<div style="font-family:arial;font-size:small"><a href="https://www.linkedin.com/in/bruceleban" style="color:rgb(17,85,204)" target="_blank">https://www.linkedin.com/in/bruceleban</a><br>
</div>
</div>
<div><br>
</div>
</div>
</div>
<br>
<br>
<div class="gmail_quote">On Thu, Feb 27, 2014 at 2:06 PM, Ziad Sawalha <span dir="ltr">
<<a href="mailto:ziad.sawalha@rackspace.com" target="_blank">ziad.sawalha@rackspace.com</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
PEP-257 includes this recommendation:<br>
<br>
“The BDFL [3] recommends inserting a blank line between the last paragraph in a multi-line<br>
docstring and its closing quotes, placing the closing quotes on a line by themselves. This way,<br>
Emacs' fill-paragraph command can be used on it.”<br>
<br>
I believe emacs no longer has this limitation. "If you do fill-paragraph in emacs in Python mode<br>
within a docstring, emacs already ignores the closing triple-quote. In fact, the most recent version<br>
of emacs supports several different docstring formatting styles and gives you the ability to switch<br>
between them.” - quoting Kevin L. Mitchell who is more familiar with emacs than I am.<br>
<br>
I’m considering removing that recommendation and updating some of the examples in PEP-257,<br>
but I’d like some thoughts from this group before I submit the patch. Any thoughts or references to<br>
conversations that may have already been had on this topic?<br>
<br>
Regards,<br>
Ziad<br>
_______________________________________________<br>
Python-ideas mailing list<br>
<a href="mailto:Python-ideas@python.org" target="_blank">Python-ideas@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-ideas" target="_blank">https://mail.python.org/mailman/listinfo/python-ideas</a><br>
Code of Conduct: <a href="http://python.org/psf/codeofconduct/" target="_blank">http://python.org/psf/codeofconduct/</a><br>
</blockquote>
</div>
<br>
</div>
</div>
</blockquote>
</div>
</div>
<br>
_______________________________________________<br>
Python-ideas mailing list<br>
<a href="mailto:Python-ideas@python.org">Python-ideas@python.org</a><br>
<a href="https://mail.python.org/mailman/listinfo/python-ideas" target="_blank">https://mail.python.org/mailman/listinfo/python-ideas</a><br>
Code of Conduct: <a href="http://python.org/psf/codeofconduct/" target="_blank">http://python.org/psf/codeofconduct/</a><br>
</blockquote>
</div>
<br>
<br clear="all">
<br>
-- <br>
--Guido van Rossum (<a href="http://python.org/~guido">python.org/~guido</a>) </div>
</div>
</blockquote>
</body>
</html>