Author: larry
Date: Mon Aug  7 12:38:13 2006
New Revision: 10678

Modified:
   doc/trunk/design/syn/S02.pod

Log:
Gah, would help if I actually thought about these things before committing...


Modified: doc/trunk/design/syn/S02.pod
==============================================================================
--- doc/trunk/design/syn/S02.pod        (original)
+++ doc/trunk/design/syn/S02.pod        Mon Aug  7 12:38:13 2006
@@ -14,7 +14,7 @@
   Date: 10 Aug 2004
   Last Modified: 7 Aug 2006
   Number: 2
-  Version: 59
+  Version: 60
 
 This document summarizes Apocalypse 2, which covers small-scale
 lexical items and typological issues.  (These Synopses also contain
@@ -185,11 +185,28 @@
 the line in any situation where a newline might confuse the parser,
 regardless of the currently installed parser.  (Unless, of course,
 you override the unspace rule itself...)  Although we say that the
-unspace hides the whitespace from the parser, line numbers are still counted
-if the unspace contains one or more newlines.  Also, a C<#> in the first column
-is always an end-of-line comment, as described above.  All other line-oriented
-processing is suppressed, however--including pod directives and heredoc
-boundaries.
+unspace hides the whitespace from the parser, line numbers are still
+counted if the unspace contains one or more newlines.  A C<#> following
+such a newline is always an end-of-line comment, as described above.
+Since Pod chunks count as whitespace to the language, they are also
+swallowed up by unspace.  Heredoc boundaries are suppressed, however,
+so you can split excessively long heredoc intro lines like this:
+
+    ok(q:to'CODE', q:to'OUTPUT', \
+    "Here is a long description", \ # --more--
+    todo(:parrøt<0.42>, :dötnet<1.2>));
+       ...
+       CODE
+       ...
+       OUTPUT
+
+To the heredoc parser that just looks like:
+
+    ok(q:to'CODE', q:to'OUTPUT', "Here is a long description", 
todo(:parrøt<0.42>, :dötnet<1.2>));
+       ...
+       CODE
+       ...
+       OUTPUT
 
 =item *
 

Reply via email to