Heredocs

Author: moritz

lib/Language/quoting.pod

@@ -212,7 +212,49 @@ execute external commands.
 
 =head2 Heredocs: :to
 
-TODO
+A convenient way to write multi-line string literals are I<heredocs>, which
+lets you chose the delimiter yourself:
+
+=begin code
+say q:to/END/;
+Here is
+some multi line
+string
+END
+=end code
+
+The contents of the heredoc only begin on the next line, so you can (and
+should finish the line).
+
+=begin code
+my $escaped = escaque(q:to/TERMINATOR/, language => 'html');
+Here are the contents of the heredoc.
+Potentially multiple lines.
+TERMINATOR
+=end code
+
+If the terminator is indented, that amount of indention is removed from the
+string literals.
+
+=begin code
+say q:to/END/;
+    Here is
+    some multi line
+        string
+    END
+=end code
+
+which produces
+
+=begin code
+Here is
+some multi line
+    string
+
+
+=end code
+
+Heredocs include the newline from before the terminator.
 
 =head1 Regexes