<div>@Robert Kern: "Multi-line string literals aren't comments. They are multi-line string literals.  Unlike a comment, which does not show up in the compiled bytecode, the Python interpreter actually does something with those string literals."<br>
<br>They have Guido's stamp of approval, and apparently the interpreter ignores them: <a href="https://twitter.com/gvanrossum/status/112670605505077248">https://twitter.com/gvanrossum/status/112670605505077248</a><br>
They feel like an ugly hack to me too, though.<br><br>@Robert Kern: "The main problem is that #: currently has a meaning as a line comment. This could break existing code."<br><br>It could, but the only case I can see is when the comment isn't following indentation convention:<br>
<br><font face="courier new,monospace">#: Valid either way; next line's not indented,</font></div><div><font face="courier new,monospace">#: so it's not counted as part of the block.<br>print('a')<br><br># Causes an IndentationError in existing code.<br>
#:<br>    print('b') <br><br>def foo():<br>#: This one would break.<br>    print('c')</font><br></div><br><div class="gmail_quote">On Fri, Jun 15, 2012 at 4:00 AM,  <span dir="ltr"><<a href="mailto:python-ideas-request@python.org" target="_blank">python-ideas-request@python.org</a>></span> wrote:<br>
<blockquote class="gmail_quote" style="margin:0 0 0 .8ex;border-left:1px #ccc solid;padding-left:1ex">Send Python-ideas mailing list submissions to<br>
        <a href="mailto:python-ideas@python.org">python-ideas@python.org</a><br>
<br>
To subscribe or unsubscribe via the World Wide Web, visit<br>
        <a href="http://mail.python.org/mailman/listinfo/python-ideas" target="_blank">http://mail.python.org/mailman/listinfo/python-ideas</a><br>
or, via email, send a message with subject or body 'help' to<br>
        <a href="mailto:python-ideas-request@python.org">python-ideas-request@python.org</a><br>
<br>
You can reach the person managing the list at<br>
        <a href="mailto:python-ideas-owner@python.org">python-ideas-owner@python.org</a><br>
<br>
When replying, please edit your Subject line so it is more specific<br>
than "Re: Contents of Python-ideas digest..."<br>
<br>
<br>
Today's Topics:<br>
<br>
   1. Multi-line comment blocks. (David Gates)<br>
   2. Re: Multi-line comment blocks. (Robert Kern)<br>
<br>
<br>
----------------------------------------------------------------------<br>
<br>
Message: 1<br>
Date: Fri, 15 Jun 2012 02:49:18 -0600<br>
From: David Gates <<a href="mailto:gatesda@gmail.com">gatesda@gmail.com</a>><br>
To: <a href="mailto:python-ideas@python.org">python-ideas@python.org</a><br>
Subject: [Python-ideas] Multi-line comment blocks.<br>
Message-ID:<br>
        <<a href="mailto:CAG2%2Bq8Ska2HLksy6D49wOzgBbQ6E44xLFjqQyZRnhfJTywCmKw@mail.gmail.com">CAG2+q8Ska2HLksy6D49wOzgBbQ6E44xLFjqQyZRnhfJTywCmKw@mail.gmail.com</a>><br>
Content-Type: text/plain; charset="iso-8859-1"<br>
<br>
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>
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>
<br>
# Single-line comment<br>
#:<br>
    Multi-line comment<br>
    #:<br>
        Nested multi-line comments work perfectly<br>
        Of course they do, they're just nested blocks<br>
    def foo():<br>
        """Docstrings work perfectly. Why wouldn't they?"""<br>
        pass<br>
# No need for an end-delimiter like """ or */<br>
-------------- next part --------------<br>
An HTML attachment was scrubbed...<br>
URL: <<a href="http://mail.python.org/pipermail/python-ideas/attachments/20120615/84005c9f/attachment-0001.html" target="_blank">http://mail.python.org/pipermail/python-ideas/attachments/20120615/84005c9f/attachment-0001.html</a>><br>

<br>
------------------------------<br>
<br>
Message: 2<br>
Date: Fri, 15 Jun 2012 10:50:40 +0100<br>
From: Robert Kern <<a href="mailto:robert.kern@gmail.com">robert.kern@gmail.com</a>><br>
To: <a href="mailto:python-ideas@python.org">python-ideas@python.org</a><br>
Subject: Re: [Python-ideas] Multi-line comment blocks.<br>
Message-ID: <jrf0hg$sj4$<a href="mailto:1@dough.gmane.org">1@dough.gmane.org</a>><br>
Content-Type: text/plain; charset=ISO-8859-1; format=flowed<br>
<br>
On 6/15/12 9:49 AM, David Gates wrote:<br>
> Multi-line strings as comments don't nest, don't play well with docstrings, and<br>
> are counter-intuitive when there's special language support for single-line<br>
> comments. Python should only have one obvious way to do things, and Python has<br>
> two ways to comment, only one of which is obvious.<br>
<br>
Multi-line string literals aren't comments. They are multi-line string literals.<br>
Unlike a comment, which does not show up in the compiled bytecode, the Python<br>
interpreter actually does something with those string literals. Sometimes people<br>
abuse them as ways to poorly emulate block comments, but this is an abuse, not a<br>
feature of the language.<br>
<br>
> My suggestion is to add<br>
> language support for comment blocks, using Python's existing comment delimiter:<br>
><br>
> # Single-line comment<br>
> #:<br>
>      Multi-line comment<br>
>      #:<br>
>          Nested multi-line comments work perfectly<br>
>          Of course they do, they're just nested blocks<br>
>      def foo():<br>
> """Docstrings work perfectly. Why wouldn't they?"""<br>
>          pass<br>
> # No need for an end-delimiter like """ or */<br>
<br>
The main problem is that #: currently has a meaning as a line comment. This<br>
could break existing code.<br>
<br>
--<br>
Robert Kern<br>
<br>
"I have come to believe that the whole world is an enigma, a harmless enigma<br>
  that is made terrible by our own mad attempt to interpret it as though it had<br>
  an underlying truth."<br>
   -- Umberto Eco<br>
<br>
<br>
<br>
------------------------------<br>
<br>
_______________________________________________<br>
Python-ideas mailing list<br>
<a href="mailto:Python-ideas@python.org">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>
<br>
<br>
End of Python-ideas Digest, Vol 67, Issue 51<br>
********************************************<br>
</blockquote></div><br>