Bug#915366: perlfaq4: the section on indented here documents should mention the ~ modifier

[Celejar]

On Thu, 6 Dec 2018 23:04:50 +0000
Dominic Hargreaves <dom at earth.li> wrote:

> On Sun, Dec 02, 2018 at 11:17:47PM -0500, Celejar wrote:
> > perlfaq4 has a question "Why don't my <<HERE documents work?", and much
> > of the answer deals with ways to write indented here documents. These
> > are largely kludges, however, and the faq should really mention the ~
> > modifier (desribed in perlop), which was introduced precisely in order
> > to provide a clean way to do this.
> 
> Hi,
> 
> Thanks for pointing this out. Would you be able to contribute
> a suggested text (either as a diff, or otherwise) for this that
> we can forward upstream?

Sorry for the delay - Gmail has been leaving some of my Debian mail in
the spam folder lately.

I'm not sure that I feel comfortable making significant revisions to
the whole FAQ answer - I'm not much of a Perl guru - so I'm just going
to supply a paragraph that can be added to the end of "Why don't my
<<HERE documents work?" in perlfaq4 to note the new way of doing this
in recent Perl:

------
Beginning with Perl version 5.26, a much simpler and cleaner way to
write indented here documents has been added to the language: the tilde
(~) modifier. See "Indented Here-docs" in perlop for details.
-----

> Cheers,
> Dominic.

Thanks,
Celejar