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