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.9900~18
X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=commitdiff_plain;h=fda9aa505667d81ee0822e91764700cdf5e50dfd;p=gitmo%2FMoose.git

Doc note about explicit omission of each() in the native attr hash implementation.
---

diff --git a/lib/Moose/Meta/Attribute/Native/Trait/Hash.pm b/lib/Moose/Meta/Attribute/Native/Trait/Hash.pm
index 9a383c6..b5b0dc6 100644
--- a/lib/Moose/Meta/Attribute/Native/Trait/Hash.pm
+++ b/lib/Moose/Meta/Attribute/Native/Trait/Hash.pm
@@ -144,6 +144,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