Deprecate current user-defined case mapping

[perl5.git] / pod / perldiag.pod

diff --git a/pod/perldiag.pod b/pod/perldiag.pod
index 087f906..ee1b694 100644 (file)
--- a/pod/perldiag.pod
+++ b/pod/perldiag.pod
@@ -3906,8 +3906,12 @@ which is why it's currently left out of your copy.
 believes it found an infinite loop in the C<@ISA> hierarchy.  This is a
 crude check that bails out after 100 levels of C<@ISA> depth.
 
+=item refcnt_dec: fd %d%s
+
 =item refcnt: fd %d%s
 
+=item refcnt_inc: fd %d%s
+
 (P) Perl's I/O implementation failed an internal consistency check. If
 you see this message, something is very wrong.
 
@@ -5258,6 +5262,15 @@ currently reserved for future use, as the exact behaviour has not
 been decided. (Simply returning the boolean opposite of the
 modified string is usually not particularly useful.)
 
+=item User-defined case-mapping '%s' is deprecated
+
+(W deprecated) You defined a function, such as C<ToLower> that overrides
+the standard case mapping, such as C<lc()> gives.  This feature is being
+deprecated due to its many issues, as documented in
+L<perlunicode/User-Defined Case Mappings (for serious hackers only)>.
+It is planned to remove this feature in Perl 5.16.  A CPAN module
+providing improved functionality is being prepared.
+
 =item UTF-16 surrogate U+%X
 
 (W utf8) You had a UTF-16 surrogate in a context where they are