=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<clever|http://duck.com/?q=stupid> for mortal
colleagues to understand. For their benefit L<magic> 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;
    <anything>

=head1 RELIGION

Unfortunately some people B<still> 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.
