Docs for MM::Method::Overridden

diff --git a/lib/Moose/Meta/Method/Overridden.pm b/lib/Moose/Meta/Method/Overridden.pm
index 7499dab..4049243 100644 (file)
--- a/lib/Moose/Meta/Method/Overridden.pm
+++ b/lib/Moose/Meta/Method/Overridden.pm
@@ -59,16 +59,38 @@ Moose::Meta::Method::Overridden - A Moose Method metaclass for overridden method
 
 =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) >>
+
+This constructs a new object. It accepts the following options:
+
+=over 8
+
+=item * class
+
+The metaclass object for the class in which the override is being
+declared. This option is required.
+
+=item * name
+
+The name of the method which we are overriding. This method must exist
+in one of the class's superclasses. This option is required.
+
+=item * method
+
+The subroutine reference which implements the overriding. This option
+is required.
+
+=back
 
 =back