Branch: refs/heads/blead
  Home:   https://github.com/Perl/perl5
  Commit: f4c1f0c4e6d927dfe0986bbf9f7d20135e7322e1
      
https://github.com/Perl/perl5/commit/f4c1f0c4e6d927dfe0986bbf9f7d20135e7322e1
  Author: Yves Orton <[email protected]>
  Date:   2022-03-10 (Thu, 10 Mar 2022)

  Changed paths:
    M pod/perldata.pod

  Log Message:
  -----------
  pod/perldata.pod - document demarcated var form (curly braces) better

Perl supports using curly braces for demarcated variable notation, both
in normal code but especially for interpolation. Some variables, such
as a multi-character caret variables must use this form at all times,
and must use this form to achieve interpolation of a variable subscript.

Prior to this patch we only documented the simple forms of this feature,
for example "${who}'s this then", but we did not document that it also
includes more complex variable access like array subscripts
"@{array[1,5]}" nor the cases where this form is outright required such
as when interpolating multi char caret variables like "${^CAPTURE[10]}".

This patch provides explanation for the full range of cases and also
documents how backslash can used as another form of disambiguation.

See GH Issue #19497 and GH Issue #18800 for examples of people being
confused by this notation.


  Commit: 6b2c6bdb3918b84aa6d4f9c274ea95d4be4a8211
      
https://github.com/Perl/perl5/commit/6b2c6bdb3918b84aa6d4f9c274ea95d4be4a8211
  Author: Yves Orton <[email protected]>
  Date:   2022-03-10 (Thu, 10 Mar 2022)

  Changed paths:
    M pod/perlre.pod

  Log Message:
  -----------
  pod/perlre.pod - document @{^CAPTURE} magic variable

This variable is documented in perlvar but we really should also mention
it in perlre since its reason for existence is to provide array access
to the capture variables in a pattern.


  Commit: 2cfe7629cc2857784d7eaa86b2594c4607ab7204
      
https://github.com/Perl/perl5/commit/2cfe7629cc2857784d7eaa86b2594c4607ab7204
  Author: Yves Orton <[email protected]>
  Date:   2022-03-10 (Thu, 10 Mar 2022)

  Changed paths:
    M pod/perlvar.pod

  Log Message:
  -----------
  perlvar.pod - add more info about demarcated variable form


Compare: https://github.com/Perl/perl5/compare/a5931453352a...2cfe7629cc28

Reply via email to