From 5a694dc1b28f249ef879038e53343ec3119c486c Mon Sep 17 00:00:00 2001
From: Ricardo Signes <rjbs@cpan.org>
Date: Mon, 4 Mar 2013 16:36:27 -0500
Subject: [PATCH] warn in docs about ->SET($ref)

---
 lib/Data/Hive.pm | 6 +++++-
 1 file changed, 5 insertions(+), 1 deletion(-)

diff --git a/lib/Data/Hive.pm b/lib/Data/Hive.pm
index 57bda34..ce19dbf 100644
--- a/lib/Data/Hive.pm
+++ b/lib/Data/Hive.pm
@@ -213,7 +213,11 @@ sub GET {
 
 This method sets (replacing, if necessary) the hive value.
 
-Its return value is not defined.
+Data::Hive was built to store simple scalars as values.  Although it
+I<probably> works just fine with references in the hive, it has not been
+tested for such use, and there may be bugs lurking in there.
+
+C<SET>'s return value is not defined.
 
 =cut