add documentation

diff --git a/Changes b/Changes
index 2ce1839..bce5ce1 100644 (file)
--- a/Changes
+++ b/Changes
@@ -7,6 +7,7 @@ for, noteworthy changes.
         associated methods, it will give a deprecation warning. (hdp)
       - Methods generated by delegation were not being added to
         associated_methods. (hdp)
+      - Move currying syntax for delegation in from AttributeHelpers. (hdp)
 
     * Moose::Util::TypeConstraints
     * Moose::Meta::TypeConstraint::DuckType

diff --git a/lib/Moose.pm b/lib/Moose.pm
index ea6b6c2..15cf38b 100644 (file)
--- a/lib/Moose.pm
+++ b/lib/Moose.pm
@@ -543,6 +543,18 @@ In this example, the Tree package gets C<parent_node> and C<siblings> methods,
 which delegate to the C<node> and C<children> methods (respectively) of the Tree
 instance stored in the C<parent> slot.
 
+You may also use an array reference to curry arguments to the original method.
+
+  has 'thing' => (
+      ...
+      handles => { set_foo => [ set => [ 'foo' ] ] },
+  );
+
+  # $self->set_foo(...) calls $self->thing->set('foo', ...)
+
+The first element of the array reference is the original method name, and the
+second is an array reference of curried arguments.
+
 =item C<REGEXP>
 
 The regexp option works very similar to the ARRAY option, except that it builds