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 (file)
--- 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