Docs for CMOP::Method::Wrapped
Dave Rolsky [Tue, 17 Mar 2009 16:30:31 +0000 (11:30 -0500)]
lib/Class/MOP/Method/Wrapped.pm

index 32f22ea..04bb760 100644 (file)
@@ -165,12 +165,12 @@ __END__
 
 =head1 NAME
 
-Class::MOP::Method::Wrapped - Method Meta Object to handle before/around/after modifiers
+Class::MOP::Method::Wrapped - Method Meta Object for methods with before/after/around modifiers
 
 =head1 DESCRIPTION
 
-This is a L<Class::MOP::Method> subclass which provides the funtionality 
-to wrap a given CODE reference with before, after and around method modifiers.
+This is a L<Class::MOP::Method> subclass which implements before,
+after, and around method modifiers.
 
 =head1 METHODS
 
@@ -178,44 +178,54 @@ to wrap a given CODE reference with before, after and around method modifiers.
 
 =over 4
 
-=item B<wrap ($code)>
+=item B<< Class::MOP::Method::Wrapped->wrap($metamethod, %options) >>
 
-This is the constructor, it will return a B<Class::MOP::Method::Wrapped>
-instance that can be used to add before, after and around modifiers to.
+This is the constructor. It accepts a L<Class::MOP::Method> object and
+a hash of options.
 
-=item B<get_original_method>
+The options are:
 
-This returns the original CODE reference that was provided to the 
-constructor.
-
-=back
+=over 8
 
-=head2 Modifiers
+=item * name
 
-These three methods will add the method modifiers to the wrapped 
-CODE reference. For more information on how method modifiers work, 
-see the section in L<Class::MOP::Class>.
+The method name (without a package name). This will be taken from the
+provided L<Class::MOP::Method> object if it is not provided.
 
-=over 4
+=item * package_name
 
-=item B<add_before_modifier ($code)>
+The package name for the method. This will be taken from the provided
+L<Class::MOP::Method> object if it is not provided.
 
-=item B<add_after_modifier ($code)>
+=item * associated_metaclass
 
-=item B<add_around_modifier ($code)>
+An optional L<Class::MOP::Class> object. This is the metaclass for the
+method's class.
 
 =back
 
-These three methods each returna list of method modifiers I<in the
-order in which they are run>.
+=item B<< $metamethod->get_original_method >>
 
-=over 4
+This returns the L<Class::MOP::Method> object that was passed to the
+constructor.
+
+=item B<< $metamethod->add_before_modifier($code) >>
+
+=item B<< $metamethod->add_after_modifier($code) >>
+
+=item B<< $metamethod->add_around_modifier($code) >>
+
+These methods all take a subroutine reference and apply it as a
+modifier to the original method.
+
+=item B<< $metamethod->before_modifiers >>
 
-=item B<before_modifiers>
+=item B<< $metamethod->after_modifiers >>
 
-=item B<after_modifiers>
+=item B<< $metamethod->around_modifiers >>
 
-=item B<around_modifiers>
+These methods all return a list of subroutine references which are
+acting as the specified type of modifier.
 
 =back