view release on metacpan or  search on metacpan

lib/Acme.pod  view on Meta::CPAN

=pod

=for comment
DO NOT EDIT. This Pod was generated by Swim.
See http://github.com/ingydotnet/swim-pm#readme

=encoding utf8

=head1 NAME

Acme - The Base of Perfection

=for html
<a href="https://travis-ci.org/ingydotnet/acme-pm"><img src="https://travis-ci.org/ingydotnet/acme-pm.png" alt="acme-pm"></a>

=head1 SYNOPSIS

    use Acme;
    print "Acme!" if acme->is_acme and acme->is_perfect;

or:

    print "Acme!" if MyModule->is_acme;
    print "Acme!" if MyModule->is_perfect;
    print "Acme!" if MyModule->is_the_highest_point_or_stage;
    print "Acme!"
      if MyModule->is_one_that_represents_perfection_of_the_thing_expressed;
    print "Acme!" if MyModule->is_the_bizzity_bomb;
    print "Acme!" if MyModule->is_teh_shiznit;

    print "Not!" unless YourModule->is_acme;

    package MyModule;
    use Acme '-base';

=head1 DESCRIPTION

Acme.pm is a base class for perfect modules. A subclass of this module is_acme
by definition!

In other words, if you use Acme as the B<base>, your class will be the
B<summit>.

=head1 IMPLEMENTATION

Acme is a subclass of Spiffy.pm. As a bonus, your perfect classes will be
I<spiffy> as well.

Acme also exports a function called C<acme> that returns a new Acme object.
(which is_perfect).

=head1 NOTE

The dictionary defines 'Spiffy':

I<Said of programs having a pretty, clever, or exceptionally well-designed
interface.>

How perfect!

=head1 BUGS

This module is_perfect.

=head1 AUTHOR

Ingy döt Net <ingy@cpan.org>