summaryrefslogtreecommitdiff
path: root/Master/tlpkg/tlperl/lib/pods/perlintro.pod
diff options
context:
space:
mode:
Diffstat (limited to 'Master/tlpkg/tlperl/lib/pods/perlintro.pod')
-rw-r--r--Master/tlpkg/tlperl/lib/pods/perlintro.pod19
1 files changed, 19 insertions, 0 deletions
diff --git a/Master/tlpkg/tlperl/lib/pods/perlintro.pod b/Master/tlpkg/tlperl/lib/pods/perlintro.pod
index c47274bc646..2d0076a029d 100644
--- a/Master/tlpkg/tlperl/lib/pods/perlintro.pod
+++ b/Master/tlpkg/tlperl/lib/pods/perlintro.pod
@@ -22,6 +22,25 @@ Throughout this document you'll see references to other parts of the
Perl documentation. You can read that documentation using the C<perldoc>
command or whatever method you're using to read this document.
+Throughout Perl's documentation, you'll find numerous examples intended
+to help explain the discussed features. Please keep in mind that many
+of them are code fragments rather than complete programs.
+
+These examples often reflect the style and preference of the author of
+that piece of the documentation, and may be briefer than a corresponding
+line of code in a real program. Except where otherwise noted, you
+should assume that C<use strict> and C<use warnings> statements
+appear earlier in the "program", and that any variables used have
+already been declared, even if those declarations have been omitted
+to make the example easier to read.
+
+Do note that the examples have been written by many different authors over
+a period of several decades. Styles and techniques will therefore differ,
+although some effort has been made to not vary styles too widely in the
+same sections. Do not consider one style to be better than others - "There
+Is More Than One Way Of Doing It" is one Perl's mottos. After all, in your
+journey as a programmer, you are likely to encounter different styles.
+
=head2 What is Perl?
Perl is a general-purpose programming language originally developed for