--- Devel-FindRef/FindRef.pm	2012/04/05 05:11:14	1.27
+++ Devel-FindRef/FindRef.pm	2013/04/13 06:29:39	1.28
@@ -199,10 +199,12 @@
 
 =item $ref = Devel::FindRef::ptr2ref $integer
 
-Sometimes you know (from debugging output) the address of a perl scalar
-you are interested in (e.g. C<HASH(0x176ff70)>). This function can be used
-to turn the address into a reference to that scalar. It is quite safe to
-call on valid addresses, but extremely dangerous to call on invalid ones.
+Sometimes you know (from debugging output) the address of a perl value you
+are interested in (e.g. C<HASH(0x176ff70)>). This function can be used to
+turn the address into a reference to that value. It is quite safe to call
+on valid addresses, but extremely dangerous to call on invalid ones.  I<No
+checks whatsoever will be done>, so don't use this unless you really know
+the value is the address of a valid perl value.
 
    # we know that HASH(0x176ff70) exists, so turn it into a hashref:
    my $ref_to_hash = Devel::FindRef::ptr2ref 0x176ff70;
@@ -210,8 +212,9 @@
 =item $ptr = Devel::FindRef::ref2ptr $reference
 
 The opposite of C<ptr2ref>, above: returns the internal address of the
-value pointed to by the passed reference. I<No checks whatsoever will be
-done>, so don't use this.
+value pointed to by the passed reference. This function is safe to call on
+anything, and returns the same value taht a normal reference would if used
+in a numeric context.
 
 =back