From: Mike Guy <mjtg@cam.ac.uk>
Date: Mon, 7 Aug 2000 14:02:09 +0000 (+0100)
Subject: Document here-doc better.
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=8bd33e3ebedead5d895aa1c866818d49eb50a164;p=p5sagit%2Fp5-mst-13.2.git

Document here-doc better.

Subject: Re: [ID 20000804.003] heredoc in s///e replacement
Message-Id: <E13LmXh-0006rM-00@libra.cus.cam.ac.uk>

p4raw-id: //depot/perl@6548
---

diff --git a/pod/perldata.pod b/pod/perldata.pod
index 70ab161..65689a6 100644
--- a/pod/perldata.pod
+++ b/pod/perldata.pod
@@ -462,6 +462,22 @@ from each line manually:
 	down from the door where it began.
     FINIS
 
+If you use a here-doc within a delimited construct, such as in C<s///eg>,
+the quoted material must come on the lines following the final delimiter.
+So instead of
+
+    s/this/<<E . 'that'
+    the other
+    E
+     . 'more '/eg;
+
+you have to write
+
+    s/this/<<E . 'that' 
+     . 'more '/eg; 
+    the other 
+    E 
+
 =head2 List value constructors
 
 List values are denoted by separating individual values by commas