http://qs1969.pair.com?node_id=11138974


in reply to Why Perl Docs examples do not use strict and warnings often

I was browsing through the Perl Data Structures documentation and noticed that though the document suggests using strict, it's not used in any examples.

Actually, it says "WHY YOU SHOULD ALWAYS use strict".

And what alternative do you suggest? Putting it in every example would make the examples longer and the document harder to read, which is why there's a whole separate section near the start of the document explaining it. Many of the examples also run fine in the absence of strict and warnings. <update> To clarify, obviously one should still always use strict and warnings. But the documentation does still cater to those who don't. Plus, not every code snippet is intended to be a full program. If a code example were to fail in the presence of use strict; use warnings;, I'd call that a documentation issue. But again, I still don't see any concrete suggestions in this thread. </update>

perlintro, the Camel, Modern Perl, and many other resources on learning Perl explain fairly early on why one should always Use strict and warnings. use v5.12; and up, which is required for many modern features to work, also turns on strict.

How's someone who's new to Perl supposed to know when some internally provided variable is being used vs when a user created variable is being used in the code?

From context and from trying out the examples.

So just in case this isn't a troll: Feel free to submit patches for cases that you think are unclear.