Mention 7-zip as alternative to WinZip

[perl5.git] / pod / perltie.pod

diff --git a/pod/perltie.pod b/pod/perltie.pod
index 87a2126..2d433e8 100644 (file)
--- a/pod/perltie.pod
+++ b/pod/perltie.pod
@@ -171,7 +171,7 @@ X<UNTIE>
 
 This method will be triggered when the C<untie> occurs. This can be useful
 if the class needs to know when no further calls will be made. (Except DESTROY
-of course.) See L<The C<untie> Gotcha> below for more details.
+of course.) See L</The C<untie> Gotcha> below for more details.
 
 =item DESTROY this
 X<DESTROY>
@@ -482,7 +482,7 @@ In our example, we'll use a little shortcut if there is a I<LIST>:
 =item UNTIE this
 X<UNTIE>
 
-Will be called when C<untie> happens. (See L<The C<untie> Gotcha> below.)
+Will be called when C<untie> happens. (See L</The C<untie> Gotcha> below.)
 
 =item DESTROY this
 X<DESTROY>
@@ -504,8 +504,9 @@ reports whether a key is present in the hash, and DELETE deletes one.
 CLEAR empties the hash by deleting all the key and value pairs.  FIRSTKEY
 and NEXTKEY implement the keys() and each() functions to iterate over all
 the keys. SCALAR is triggered when the tied hash is evaluated in scalar 
-context. UNTIE is called when C<untie> happens, and DESTROY is called when
-the tied variable is garbage collected.
+context, and in 5.28 onwards, by C<keys> in boolean context. UNTIE is
+called when C<untie> happens, and DESTROY is called when the tied variable
+is garbage collected.
 
 If this seems like a lot, then feel free to inherit from merely the
 standard Tie::StdHash module for most of your methods, redefining only the
@@ -805,9 +806,10 @@ thing, but we'll have to go through the LIST field indirectly.
 =item SCALAR this
 X<SCALAR>
 
-This is called when the hash is evaluated in scalar context. In order
-to mimic the behaviour of untied hashes, this method should return a
-false value when the tied hash is considered empty. If this method does
+This is called when the hash is evaluated in scalar context, and in 5.28
+onwards, by C<keys> in boolean context. In order to mimic the behaviour of
+untied hashes, this method must return a value which when used as boolean,
+indicates whether the tied hash is considered empty. If this method does
 not exist, perl will make some educated guesses and return true when
 the hash is inside an iteration. If this isn't the case, FIRSTKEY is
 called, and the result will be a false value if FIRSTKEY returns the empty
@@ -836,7 +838,7 @@ L<Hash::Util/bucket_ratio> for a backwards compatibility path.
 =item UNTIE this
 X<UNTIE>
 
-This is called when C<untie> occurs.  See L<The C<untie> Gotcha> below.
+This is called when C<untie> occurs.  See L</The C<untie> Gotcha> below.
 
 =item DESTROY this
 X<DESTROY>
@@ -1015,7 +1017,7 @@ X<UNTIE>
 
 As with the other types of ties, this method will be called when C<untie> happens.
 It may be appropriate to "auto CLOSE" when this occurs.  See
-L<The C<untie> Gotcha> below.
+L</The C<untie> Gotcha> below.
 
 =item DESTROY this
 X<DESTROY>
@@ -1040,7 +1042,7 @@ Here's how to use our little example:
 X<UNTIE>
 
 You can define for all tie types an UNTIE method that will be called
-at untie().  See L<The C<untie> Gotcha> below.
+at untie().  See L</The C<untie> Gotcha> below.
 
 =head2 The C<untie> Gotcha
 X<untie>