perldelta for overload caching bug fixes

[perl5.git] / pod / perldelta.pod

diff --git a/pod/perldelta.pod b/pod/perldelta.pod
index 93d638a..9444f0b 100644 (file)
--- a/pod/perldelta.pod
+++ b/pod/perldelta.pod
@@ -103,6 +103,8 @@ C<File::stat> ignores the L<filetest> pragma, and warns when used in
 combination therewith.  But it was not warning for C<-r>.  This has been
 fixed [perl #111640].
 
+C<-p> now works, and does not return false for pipes [perl #111638].
+
 =item *
 
 L<Hash::Util> has been upgraded from version 0.11 to 0.12.
@@ -333,7 +335,25 @@ be noted as well.
 
 =item *
 
-XXX
+The C<SVf_AMAGIC> flag to indicate overloading is now on the stash, not the
+object.  It is now set automatically whenever a method or @ISA changes, so
+its meaning has changed, too.  It now means "potentially overloaded".  When
+the overload table is calculated, the flag is automatically turned off if
+there is no overloading, so there should be no noticeable slowdown.
+
+The staleness of the overload tables is now checked when overload methods
+are invoked, rather than during C<bless>.
+
+"A" magic is gone.  The changes to the handling of the C<SVf_AMAGIC> flag
+eliminate the need for it.
+
+The core no longer increments C<PL_amagic_generation> (it doesn't need to).
+But an XS module can still increment it to mark all overload tables as
+stale.  (It is still not part of the API, though.)  Do not rely on this.
+It may be deleted in the next release.
+
+The fallback overload setting is now stored in its own stash entry, called
+"(fallback".
 
 =back
 
@@ -398,6 +418,17 @@ Now it produces an error.
 
 C<vec> now works with extremely large offsets (>2 GB) [perl #111730].
 
+=item *
+
+Changes to overload settings now take effect immediately, as do changes to
+inheritance that affect overloading.  They used to take effect only after
+C<bless>.
+
+Objects that were created before a class had any overloading used to remain
+non-overloaded even if the class gained overloading through C<use overload>
+or @ISA changes, and even after C<bless>.  This has been fixed
+[perl #112708].
+
 =back
 
 =head1 Known Problems