NAME
   Acme::BadExample - Perl document, yes. Perl code, no damn way!

 DESCRIPTION
   One of the key principles behind the PPI perl document parser is that
   any given piece of Perl source exists in a pseudo-quantum-like state, in
   that it demonstrates both duality and indeterminism. Bear with me for a
   second here.

   Any string of bytes that we consider to be "Perl" can be treated both a
   Perl "document", and as Perl "code". When treated as a document, it
   merely has to "look right", having the normal context and syntax. This
   means that anything "cleaned" with Acme::Bleach is not a valid Perl
   "document".

   When treated as Perl code, there is no way to absolutely know whether it
   is valid or not, until you look at it (i.e. until you actually execute
   it). In fact, because every single perl installation is slightly (or
   dramatically) different, you can never truly know that something is
   valid perl code until after its been fully parsed.

   Unit test frameworks in most CPAN distributions resolve 99.99% of any
   problems, but it is theoretically possible that a module will have a
   time-related issue or some other issue that causes it to fail to load.
   For example, modules related to DateTime that were somehow accidentally
   using time values that exists in the non-existant period when daylight
   savings changes over.

   So any string of Perl source can be seen as valid Perl document, as
   valid Perl code, or both (or neither). Most of the time, thank god, it's
   both.

   Acme::BadExample is intended to serve as an example of a file that is a
   valid Perl document and follows all the normal Perl syntax, but is most
   definately not valid perl code. In fact, while it should not be possible
   to run this on any installation of perl, it will happily be loaded by
   PPI as a Perl document.

SUPPORT
   You're kidding right? I tell you what. If you can find some way to make
   this module run, I shall happily stump up a $100 reward, payable in your
   choice of American dollars, Australian dollars, or as a vertical metre
   of beer (cartons). Beer must be picked up in person :)

   Write a script capable of loading the file and post it to the CPAN bug
   tracker at:

   <http://rt.cpan.org/NoAuth/ReportBug.html?Queue=Acme-BadExample>

   Because you can play all sorts of games with source filters (hell, I
   could write a source filter rewrite script), in order for the reward to
   be paid, the script must be accompanied by a patch to Acme::BadExample
   capable of repelling the same exploit.

AUTHOR
   Adam Kennedy <[email protected]>, <http://ali.as/>

SEE ALSO
   PPI, PPI::Manual

COPYRIGHT
   Copyright 2004 - 2009 Adam Kennedy.

   This program is free software; you can redistribute it and/or modify it
   under the same terms as Perl itself.

   The full text of the license can be found in the LICENSE file included
   with this module.