From 4f7b12953fa23d3b88826a080aeb30262d2e7886 Mon Sep 17 00:00:00 2001 From: Abigail Date: Thu, 9 Dec 2010 14:48:25 -0500 Subject: [PATCH] Added a statement about the examples in perl's documentation --- pod/perlintro.pod | 18 ++++++++++++++++++ 1 file changed, 18 insertions(+) diff --git a/pod/perlintro.pod b/pod/perlintro.pod index c47274b..4472d9f 100644 --- a/pod/perlintro.pod +++ b/pod/perlintro.pod @@ -22,6 +22,24 @@ Throughout this document you'll see references to other parts of the Perl documentation. You can read that documentation using the C command or whatever method you're using to read this document. +Many of the examples in the documentation are code fragments, +not complete programs, intended to help understand the discussed +features. They may reflect the style and preference of the author of +that piece of the documentation, and may be brever than a corresponding +line of code in a real program. It's usually taken for granted that +strict and warnings have been enabled, and that used variables have +been declared without explicitely stating this in each fragment. + +Do note that the examples have been written over a period of more than a +dozen years, and that a large range of authors have contributed. 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 of Perls 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 -- 2.7.4