summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorNicholas Clark <nick@ccl4.org>2021-06-27 16:22:46 +0000
committerKarl Williamson <khw@cpan.org>2021-07-17 06:42:19 -0700
commit69144239fba351a44069a6d49befe62270395f6a (patch)
treeb8cbd5a76ec467bd51a49e25f3c365e16ac3b827
parent88df3495ef351e796cea9d92bdd8da77bace0ef2 (diff)
downloadperl-69144239fba351a44069a6d49befe62270395f6a.tar.gz
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.
-rw-r--r--pod/perlintro.pod11
1 files changed, 5 insertions, 6 deletions
diff --git a/pod/perlintro.pod b/pod/perlintro.pod
index 5c733b5fcf..0693ab6f2a 100644
--- a/pod/perlintro.pod
+++ b/pod/perlintro.pod
@@ -162,7 +162,7 @@ A scalar represents a single value:
Scalar values can be strings, integers or floating point numbers, and Perl
will automatically convert between them as required. There is no need
-to pre-declare your variable types, but you have to declare them using
+to pre-declare your variable types - just declare their names using
the C<my> keyword the first time you use them. (This is one of the
requirements of C<use strict;>.)
@@ -172,8 +172,9 @@ Scalar values can be used in various ways:
print "The animal is $animal\n";
print "The square of $answer is ", $answer * $answer, "\n";
-There are a number of "magic" scalars with names that look like
-punctuation or line noise. These special variables are used for all
+There are a number of "magic" scalars with names that use punctuation symbols,
+and a few that are all uppercase letters.
+These special variables are used for all
kinds of purposes, and are documented in L<perlvar>. The only one you
need to know about for now is C<$_> which is the "default variable".
It's used as the default argument to a number of functions in Perl, and
@@ -326,9 +327,7 @@ running the program. Using C<strict> is highly recommended.
=head2 Conditional and looping constructs
-Perl has most of the usual conditional and looping constructs. As of Perl
-5.10, it even has a case/switch statement (spelled C<given>/C<when>). See
-L<perlsyn/"Switch Statements"> for more details.
+Perl has most of the usual conditional and looping constructs.
The conditions can be any Perl expression. See the list of operators in
the next section for information on comparison and boolean logic operators,