From: Karen Etheridge <ether@cpan.org>
Date: Wed, 24 Nov 2010 17:52:12 +0000 (-0800)
Subject: Doc note about explicit omission of each() in the native attr hash implementation.
X-Git-Tag: 1.21~7
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=9663691d0ada2c3bafedb42ff19876dd8b169ec8;p=gitmo%2FMoose.git

Doc note about explicit omission of each() in the native attr hash implementation.
(cherry picked from commit fda9aa505667d81ee0822e91764700cdf5e50dfd)
---

diff --git a/lib/Moose/Meta/Attribute/Native/Trait/Hash.pm b/lib/Moose/Meta/Attribute/Native/Trait/Hash.pm
index ab67f17..5db5b80 100644
--- a/lib/Moose/Meta/Attribute/Native/Trait/Hash.pm
+++ b/lib/Moose/Meta/Attribute/Native/Trait/Hash.pm
@@ -158,6 +158,9 @@ When called as a setter, this method returns the value that was set.
 
 =back
 
+Note that C<each> is deliberately omitted, due to its stateful interaction
+with the hash iterator. C<keys> or C<kv> are much safer.
+
 =head1 METHODS
 
 =over 4