Branch: refs/heads/blead
  Home:   https://github.com/Perl/perl5
  Commit: 69144239fba351a44069a6d49befe62270395f6a
      
https://github.com/Perl/perl5/commit/69144239fba351a44069a6d49befe62270395f6a
  Author: Nicholas Clark <n...@ccl4.org>
  Date:   2021-07-17 (Sat, 17 Jul 2021)

  Changed paths:
    M pod/perlintro.pod

  Log Message:
  -----------
  Three small changes to perlintro.pod

Simplify the text about declaring variables with my. The previous text said
both that "you don't have to pre-declare" and "you have to declare them",
where it wasn't clear that the former was about types, and the latter about
variables. The new phrasing tries to be clearer.

Note that special variables can also be "all capitals", not just
"punctuation". Remove the in joke about "line noise" because it adds little,
but many people use it as a negative trope about Perl.

Remove mention of given/when. We should not be promoting something we
intend to change. We should have done this years ago when we made it
experimental.


  Commit: 3ccfac5d0b3697001c98d81e3d367041cdf6f63a
      
https://github.com/Perl/perl5/commit/3ccfac5d0b3697001c98d81e3d367041cdf6f63a
  Author: Nicholas Clark <n...@ccl4.org>
  Date:   2021-07-17 (Sat, 17 Jul 2021)

  Changed paths:
    M pod/perlintro.pod

  Log Message:
  -----------
  Refine the changes to perlintro.pod after feedback and discussion.

Following useful feedback and suggestions from Neil Bowers, Jason McIntosh
and Dan Book, try to make the sentances shorter and clearer. Hopefully also
avoid some potential abmiguities about "special variables" not just being
all-punctuation or scalars.


Compare: https://github.com/Perl/perl5/compare/88df3495ef35...3ccfac5d0b36

Reply via email to