Kevin J. Rice

NAME

Acme::Buckaroo - Buckaroo Banzai Characters Infest Your Code!

SYNOPSIS

Before Buckaroo-ing:

use Acme::Buckaroo;

print "Watch 'Buckaroo Banzai Across the 8th Dimension' Today!";

After Bucaroo-ing:

use Acme::Buckaroo; Buckaroo Banzai Across The Eigth Dimension Buckaroo Banzai Across The Eigth Dimension Bari Dreiband-Burman General Catburd George Stokes Frank James Sparks Gary Hellerstein Glenn Campbell Buckaroo Banzai Penny Priddy Damon Hines New Jersey Glenn Campbell Doreen A. Dixon Francine Lembi Buckaroo Banzai Girl Named John Scooter Lindley Gordon Ecker Jr. Doreen A. Dixon Fred J. Koenekamp New Jersey George Stokes Gary Hymes Gary Hymes Buckaroo Banzai Scooter Lindley New Jersey Gary Hellerstein Grovers Mills New Jersey Frank James Sparks Buckaroo Banzai Sandra Banzai Doreen A. Dixon George Stokes Gary Hymes Gerald Peterson Gerald Peterson Buckaroo Banzai Glenn Campbell Francine Lembi Edward Morey Buckaroo Banzai Perfect Tommy Glenn Campbell Francine Lembi Buckaroo Banzai Smolensk USSR Frank James Sparks Gary Daigler Edward Morey Gary Hellerstein Gerald Peterson Frank James Sparks Gary Hymes Gary Hellerstein Girl Named John Buckaroo Banzai Colette Emanuel Gary Hymes Eddie Marks New Jersey Gregory Jein Defense Sec. McKinley Penny Priddy Planet 10 Bari Dreiband-Burman

DESCRIPTION

The first time you run this program, the entire text of the program after the 'use Acme::Buckaroo;' is converted (character by character) into characters from the movie "Buckaroo Banzai Across the Eigth Dimension" (and some other phrases, too).

The program will work (or not!) exactly as it did before it was converted, but the code will be a somewhat endearing tribute to a movie, instead of a clean, complete, clearly commented set of lines of Perl code.

if you want to convert your program BACK into Perl, you must edit the Acme::Buckaroo.pm module and turn on debugging (change the line, "my $debug_mode = 0;" to the line, "my $debug_mode = 1;" and then run the script again. As it executes, it will translate the program back. Capture the output of this and you have your program back.

Acme::Buckaroo came about because the modules Acme::Buffy, Acme::Morse, Acme::Pony, and Acme::Bleach were somewhat cryptically written. This author believes that CODE SHOULD BE SIMPLE and CLEAR to read and understand. Code that isn't clear is far less value. And, since these modules are for learning or FUN anyway, I might as well start here.

As someone who has taught beginners to use Perl, I've seen the problems caused by using Perl idioms where typing a few more characters can make maintenance possible and even quite easy.

DEDICATION

I'd like to dedicate this module to Mr. Damian Conway, who has bettered Perl and the lives of those in the Perl-using community by vast amounts, and continues to do good work. Someday I'd like to buy him a beer. Good book, dude!

The book, by the way, is "Object Oriented Perl", by Damian Conway and Randall L. Schwartz, published by Manning Publications Company; ISBN: 1884777791; (August 1999).

Also thanks to Jesse who reported a bug in this documentation and introduced me to the CPAN bug tracking database, available to everyone to report bugs in CPAN modules or scripts. The address for this is http://rt.cpan.org. If you know of a bug in a CPAN module, report it there!

EXPORT

None by default.

SEE ALSO

Acme::Buffy, Acme::Morse, Acme::Pony, Acme::Bleach, and perl.

DIAGNOSTICS

Cannot Buckaroo '%s'

Acme::Buckaroo could not modify the source file. Are the file permissions set?

Cannot Buckaroo again on '%s'

Acme::Buckaroo couldn't read the source file to execute it. Are the file permissions set?

AUTHOR

Kevin J. Rice, http://www.JustAnyone.com, <KevinRice@cpan.org>

COPYRIGHT

Copyright (c) 2002, Kevin J. Rice. All Rights Reserved. This module is free software. It may be used, redistributed and/or modified under the terms of the Perl Artistic License. (see http://www.perl.com/perl/misc/Artistic.html for details)