<div>My proposal wasn't for people who hand-code the single-line comment syntax but for those that use multi-line string comments.  Since the multi-line string hack's BDFL-approved, people will use it and other people will have to deal with it.<br>
<br>The best alternative would be official discouragement of multi-line string comments.  It's fine if Python doesn't have an officially-sanctioned multi-line comment syntax, but if it's going to have one, it should have one that makes sense.<br>
</div><br><div class="gmail_quote">On Fri, Jun 15, 2012 at 4:12 PM, Steven D'Aprano <span dir="ltr"><<a href="mailto:steve@pearwood.info" target="_blank">steve@pearwood.info</a>></span> wrote:<br><blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
David Gates wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
Multi-line strings as comments don't nest, don't play well with docstrings,<br>
and are counter-intuitive when there's special language support for<br>
single-line comments. Python should only have one obvious way to do things,<br>
</blockquote>
<br>
That's not what the Zen says. The zen says:<br>
<br>
There should be one-- and preferably only one --obvious way to do it.<br>
<br>
which is a positive statement that there should be an obvious way to solve problems, NOT a negative statement that there shouldn't be non-obvious ways.<br>
<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">
and Python has two ways to comment, only one of which is obvious. My<br>
suggestion is to add language support for comment blocks, using Python's<br>
existing comment delimiter:<br>
</blockquote>
<br>
There is already support for nested multi-line comments: the humble # symbol can be nested arbitrarily deep. All you need is a modern editor that understands Python syntax, and with a single command you can comment or uncomment a block:<br>

<br>
# This is a commented line.<br>
<br>
# def fun(a, b, c):<br>
#     """Docstrings are fine when commented"""<br>
#     pass<br>
#     # This is a nested comment.<br>
# And no need for an end-delimiter either.<br>
<br>
If your editor is old or too basic, you can do it by hand, which is a pain, but doable.<br>
<br>
Python doesn't need dedicated syntax to make up for the limitations of your editor. Don't complicate the language for the sake of those poor fools stuck using Notepad.<span class="HOEnZb"><font color="#888888"><br>

<br>
<br>
<br>
-- <br>
Steven<br>
_______________________________________________<br>
Python-ideas mailing list<br>
<a href="mailto:Python-ideas@python.org" target="_blank">Python-ideas@python.org</a><br>
<a href="http://mail.python.org/mailman/listinfo/python-ideas" target="_blank">http://mail.python.org/mailman/listinfo/python-ideas</a><br>
</font></span></blockquote></div><br>