NAME

Acme::Rant - Extends Perl's Ability to Let You Rant

SYNOPSIS

use Acme::Rant;

my (@#%@-ing @list) = qw[foo];

print the $#@%-ing @list, "\n";

if ( $list[0] eq 'foo' ) {
    !*%^-you() and @#%-me ;
}

if ( @list < 2 ) {
    die what the @#$%, RANT {
        What the heck do you think you're doing?!
    };
}

DESCRIPTION

Acme::Rant implements an infinite (well, max(N) for very large values of N) number of functions that are exported by default. Each of these functions give you a unique ability to vent Acme::Rant over your code.

Parameters

If the function is called with parameters, those parameters will be returned in a list. If your function was called with zero parameters, it will return true. Remember that these are functions and may require parenthesis to disambiguate meaning and context.

Context

Context is a bit different for these venting functions. Void context refers to an instance when your frustrations should not do anything, most often when venting just after keywords like my, use, sub, and so on. Other contexts work as described in "Parameters".

Syntax

The core functions are named with the following list of characters.

!@#\$%^&*_?

The core function name may have a suffix of any alpha characters, denoted by a leading dash (-).

#@$%-it

There are a number of possibilities for prefixing the core function name. First is the word the which may itself be prefixed by one of the six questions who, what, when, why, how, and where.

the #@$%?
what the %@#$
why the &^%@-ing $dog

The possible combinations are most certainly not endless, but it will take a while to get there.

Ranting

You may go futher off the deep end by ranting at will. It is an excellent form of documentation.

RANT {
    So, you decided it would be a good idea to return undef
    from your method call and make me lookup a package
    variable to get the data?!  You so stupid!
}

THANKS

Like so many modules, this has been inspired by Damian Conway. Not only inspired, but concieved, thunk up, all but written by Damian Conway.

what the #!@$, RANT {
    SO THANKS A LOT DAMIAN!
};

AUTHOR

Casey West, <casey@geeknest.com>

COPYRIGHT

Copyright (c) 2003 Casey West <casey@geeknest.com>. All rights reserved. This program is free software; you can redistribute it and/or modify it under the same terms as Perl itself.