=head1 YOU You, of course, are fantastic, but not all of the developers you interact with will understand the code you produce. Sometimes your code is just too L for mortal colleagues to understand. For their benefit L can be enabled. =head1 MAGIC The purpose of the magic pragma is to indicate to the next developer, who may well be yourself, that the enclosed code is sufficiently advanced. For example: # Engage Thompson; # (ie. you are not expected to understand this) use magic; # use religion; or use science; also "work". not exp log srand xor s qq qx xor s x x length uc ord and print chr ord for qw q join use sub tied qx xor eval xor print qq q q xor int eval lc q m cos and print chr ord for qw y abs ne open tied hex exp ref y m xor scalar srand print qq q q xor int eval lc qq y sqrt cos and print chr ord for qw x printf each return local x y or print qq s s and eval q s undef or oct xor time xor ref print chr int ord lc foreach qw y hex alarm chdir kill exec return y s gt sin sort split no magic; QED. =head1 SCIENCE Magic, of course, is bullshit. People who know this and nevertheless want to know how the world works are recommended to use science because science works. Are you reading this? That's how you know. For example: use science; =head1 RELIGION Unfortunately some people B want to know how the world works even though they're too smart to believe in magic but too stupid to understand science. For these people there is religion. And may god help them. No examples. Read the good book. Books.