In article <aanlktimm-hiuf86ev9ykytsvpucpj1le7hatxbxnq...@mail.gmail.com>, Chas. Owens <chas.ow...@gmail.com> wrote:
> No, you understood me, it is just that the FAQ doesn't do a good job > for those two questions. That is something we need to be doing > better. The FAQ doesn't do a good job of teaching you Perl because it's not the FAQs job to teach you Perl. The FAQ is not there to teach you syntax or programming. As for the particular comment that's started this long thread, the idea that we should add 'use XXX' to every snippet, I have two rule * The documentation for a particular version of perl assumes that perl is used for its examples. * Never use features that distract the reader. Using 'use 5.010' just to get say() is a distraction unless you are talking about say() specifically. * Only note the version when it really matters. For instance, you have to somehow pull in the Switch statement. * Note that since 5.10, 'use 5.xxx' now has side effects. Using that blindly may cause other things in a program to break, although the readers may not know why. * Ignore any Perl released more than 10 years ago.
