X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=pod%2Fperlref.pod;h=df850133477372932f360979cbd6d8cf674f7010;hb=d99ad34e868efb22d6a17d96d58fcee12530fb7f;hp=66b1a7d7c1f8e600207c2b3ac370aa5051039a2e;hpb=49399b3f940d44418e30fbc3c7271b5d4ee63620;p=p5sagit%2Fp5-mst-13.2.git

diff --git a/pod/perlref.pod b/pod/perlref.pod
index 66b1a7d..df85013 100644
--- a/pod/perlref.pod
+++ b/pod/perlref.pod
@@ -2,6 +2,12 @@
 
 perlref - Perl references and nested data structures
 
+=head1 NOTE
+
+This is complete documentation about all aspects of references.
+For a shorter, tutorial introduction to just the essential features,
+see L<perlreftut>.
+
 =head1 DESCRIPTION
 
 Before release 5 of Perl it was difficult to represent complex data
@@ -89,7 +95,9 @@ a list of references!
     @list = \($a, @b, %c);	# same thing!
 
 As a special case, C<\(@foo)> returns a list of references to the contents
-of C<@foo>, not a reference to C<@foo> itself.  Likewise for C<%foo>.
+of C<@foo>, not a reference to C<@foo> itself.  Likewise for C<%foo>,
+except that the key references are to copies (since the keys are just
+strings rather than full-fledged scalars).
 
 =item 3.
 
@@ -551,7 +559,7 @@ access to those variables even though it doesn't get run until later,
 such as in a signal handler or a Tk callback.
 
 Using a closure as a function template allows us to generate many functions
-that act similarly.  Suppopose you wanted functions named after the colors
+that act similarly.  Suppose you wanted functions named after the colors
 that generated HTML font changes for the various colors:
 
     print "Be ", red("careful"), "with that ", green("light");