Problem Statement

A   here document   (or "heredoc")   is a way of specifying a text block, preserving the line breaks, indentation and other whitespace within the text. Depending on the language being used, a   here document   is constructed using a command followed by "<<" (or some other symbol) followed by a token string. The text block will then start on the next line, and will be followed by the chosen token at the beginning of the following line, which is used to mark the end of the text block.

Demonstrate the use of   here documents   within the language.

Let's start with the solution:

def s:
"x
y
z";

s

$ jq -n s.jq
"x\ny\nz"


def specifier(a):
"x
\(a)
z";

specifier("y")

"a
tab:    end
parens:()
single quotation mark:'
double quotation mark must be escaped:\"
b
d"

"a\ntab:\tend\nparens:()\nsingle quotation mark:'\ndouble quotation mark must be escaped:\"\nb\nd"