Author: larry
Date: Wed Jun 13 12:11:02 2007
New Revision: 14420
Modified:
doc/trunk/design/syn/S02.pod
Log:
more block comment tweakage
Modified: doc/trunk/design/syn/S02.pod
==============================================================================
--- doc/trunk/design/syn/S02.pod (original)
+++ doc/trunk/design/syn/S02.pod Wed Jun 13 12:11:02 2007
@@ -12,7 +12,7 @@
Maintainer: Larry Wall <[EMAIL PROTECTED]>
Date: 10 Aug 2004
- Last Modified: 12 Jun 2007
+ Last Modified: 13 Jun 2007
Number: 2
Version: 111
@@ -176,6 +176,14 @@
must report mismatched openers or closers to prevent, for example,
unwitting use of bare C<}> as a closer for an opening C<#{>.
+However, an unexpected closer is treated as a line-end comment, on the
+assumption that the opening bracket was at the end of its comment line
+in the K&R style:
+
+ #for @foo {
+ # ...
+ #}
+
In addition to supporting the practice of commenting out code with
line comments, an additional motivation for this is to promote human
recognition of the end of the comment when the opener could be quite
