From 8bd33e3ebedead5d895aa1c866818d49eb50a164 Mon Sep 17 00:00:00 2001
From: Mike Guy <mjtg@cam.ac.uk>
Date: Mon, 7 Aug 2000 15:02:09 +0100
Subject: [PATCH] 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
---
 pod/perldata.pod | 16 ++++++++++++++++
 1 file changed, 16 insertions(+)

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
-- 
2.7.4