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

[Dominic Hargreaves]

Control: forwarded -1 https://rt.perl.org/Ticket/Display.html?id=133746

On Fri, Dec 28, 2018 at 01:06:54PM -0500, Celejar wrote:
> 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.
> -----

Thanks, I've forwarded this upstream!

Best,
Dominic.