Beginning of dzilization

[gitmo/Moose.git] / lib / Moose / Meta / Method / Overridden.pm

diff --git a/lib/Moose/Meta/Method/Overridden.pm b/lib/Moose/Meta/Method/Overridden.pm
index 7727a05..02580b4 100644 (file)
--- a/lib/Moose/Meta/Method/Overridden.pm
+++ b/lib/Moose/Meta/Method/Overridden.pm
@@ -3,8 +3,6 @@ package Moose::Meta::Method::Overridden;
 use strict;
 use warnings;
 
-our $VERSION   = '0.71_01';
-$VERSION = eval $VERSION;
 our $AUTHORITY = 'cpan:STEVAN';
 
 use base 'Moose::Meta::Method';
@@ -49,46 +47,51 @@ sub new {
 
 1;
 
+# ABSTRACT: A Moose Method metaclass for overridden methods
+
 __END__
 
 =pod
 
-=head1 NAME
-
-Moose::Meta::Method::Overridden - A Moose Method metaclass for overridden methods
-
 =head1 DESCRIPTION
 
-This class implements method overriding logic for the L<Moose> C<override> keyword.
+This class implements method overriding logic for the L<Moose>
+C<override> keyword.
 
-This involves setting up C<super> for the overriding body, and dispatching to
-the correct parent method upon its invocation.
+The overriding subroutine's parent will be invoked explicitly using
+the C<super> keyword from the parent class's method definition.
 
 =head1 METHODS
 
 =over 4
 
-=item B<new>
+=item B<< Moose::Meta::Method::Overridden->new(%options) >>
 
-=back
+This constructs a new object. It accepts the following options:
 
-=head1 BUGS
+=over 8
+
+=item * class
 
-All complex software has bugs lurking in it, and this module is no 
-exception. If you find a bug please either email me, or add the bug
-to cpan-RT.
+The metaclass object for the class in which the override is being
+declared. This option is required.
 
-=head1 AUTHOR
+=item * name
 
-Yuval Kogman E<lt>nothingmuch@cpan.orgE<gt>
+The name of the method which we are overriding. This method must exist
+in one of the class's superclasses. This option is required.
 
-=head1 COPYRIGHT AND LICENSE
+=item * method
 
-Copyright 2006-2009 by Infinity Interactive, Inc.
+The subroutine reference which implements the overriding. This option
+is required.
 
-L<http://www.iinteractive.com>
+=back
+
+=back
+
+=head1 BUGS
 
-This library is free software; you can redistribute it and/or modify
-it under the same terms as Perl itself.
+See L<Moose/BUGS> for details on reporting bugs.
 
 =cut