also mention native trait 'elements' in reference to auto_deref

diff --git a/lib/Moose.pm b/lib/Moose.pm
index e5af2af..bf5e996 100644 (file)
--- a/lib/Moose.pm
+++ b/lib/Moose.pm
@@ -467,8 +467,11 @@ If an attribute is marked as lazy it B<must> have a default supplied.
 
 This tells the accessor to automatically dereference the value of this
 attribute when called in list context.  The accessor will still return a
-reference when called in scalar context.  This is only legal if your C<isa>
-option is either C<ArrayRef> or C<HashRef>.
+reference when called in scalar context.  If this behavior isn't desirable,
+L<Moose::Meta::Attribute::Native::Trait::Array/elements> or
+L<Moose::Meta::Attribute::Native::Trait::Hash/elements> may be a better
+choice.  The I<auto_deref> option is only legal if your I<isa> option is
+either C<ArrayRef> or C<HashRef>.
 
 =item I<trigger =E<gt> $code>