Fix a documentation about a future API change

perl-5.31.2-perlapi-5.30-promise-not-met-change-to-5.32.patch

@@ -0,0 +1,118 @@
+From 8b4b30c5d389983c3df51b7ff3b38e5608c7c2e2 Mon Sep 17 00:00:00 2001
+From: Karl Williamson <khw@cpan.org>
+Date: Sat, 3 Aug 2019 09:17:43 -0600
+Subject: [PATCH] perlapi: 5.30 promise not met; change to 5.32
+MIME-Version: 1.0
+Content-Type: text/plain; charset=UTF-8
+Content-Transfer-Encoding: 8bit
+
+We delayed this change, but I forgot to change this documentation
+
+Signed-off-by: Petr Písař <ppisar@redhat.com>
+---
+ handy.h | 24 ++++++++++++------------
+ 1 file changed, 12 insertions(+), 12 deletions(-)
+
+diff --git a/handy.h b/handy.h
+index 24c028a638..2dfbc86125 100644
+--- a/handy.h
++++ b/handy.h
+@@ -609,13 +609,13 @@ future releases.
+ Variant C<isI<FOO>_utf8> is like C<isI<FOO>_utf8_safe>, but takes just a single
+ parameter, C<p>, which has the same meaning as the corresponding parameter does
+ in C<isI<FOO>_utf8_safe>.  The function therefore can't check if it is reading
+-beyond the end of the string.  Starting in Perl v5.30, it will take a second
++beyond the end of the string.  Starting in Perl v5.32, it will take a second
+ parameter, becoming a synonym for C<isI<FOO>_utf8_safe>.  At that time every
+ program that uses it will have to be changed to successfully compile.  In the
+ meantime, the first runtime call to C<isI<FOO>_utf8> from each call point in the
+ program will raise a deprecation warning, enabled by default.  You can convert
+ your program now to use C<isI<FOO>_utf8_safe>, and avoid the warnings, and get an
+-extra measure of protection, or you can wait until v5.30, when you'll be forced
++extra measure of protection, or you can wait until v5.32, when you'll be forced
+ to add the C<e> parameter.
+ 
+ Variant C<isI<FOO>_LC> is like the C<isI<FOO>_A> and C<isI<FOO>_L1> variants, but the
+@@ -649,13 +649,13 @@ future releases.
+ Variant C<isI<FOO>_LC_utf8> is like C<isI<FOO>_LC_utf8_safe>, but takes just a single
+ parameter, C<p>, which has the same meaning as the corresponding parameter does
+ in C<isI<FOO>_LC_utf8_safe>.  The function therefore can't check if it is reading
+-beyond the end of the string.  Starting in Perl v5.30, it will take a second
++beyond the end of the string.  Starting in Perl v5.32, it will take a second
+ parameter, becoming a synonym for C<isI<FOO>_LC_utf8_safe>.  At that time every
+ program that uses it will have to be changed to successfully compile.  In the
+ meantime, the first runtime call to C<isI<FOO>_LC_utf8> from each call point in
+ the program will raise a deprecation warning, enabled by default.  You can
+ convert your program now to use C<isI<FOO>_LC_utf8_safe>, and avoid the warnings,
+-and get an extra measure of protection, or you can wait until v5.30, when
++and get an extra measure of protection, or you can wait until v5.32, when
+ you'll be forced to add the C<e> parameter.
+ 
+ =for apidoc Am|bool|isALPHA|char ch
+@@ -897,13 +897,13 @@ implementation, and subject to change in future releases.
+ =for apidoc Am|UV|toUPPER_utf8|U8* p|U8* s|STRLEN* lenp
+ This is like C<L</toUPPER_utf8_safe>>, but doesn't have the C<e>
+ parameter  The function therefore can't check if it is reading
+-beyond the end of the string.  Starting in Perl v5.30, it will take the C<e>
++beyond the end of the string.  Starting in Perl v5.32, it will take the C<e>
+ parameter, becoming a synonym for C<toUPPER_utf8_safe>.  At that time every
+ program that uses it will have to be changed to successfully compile.  In the
+ meantime, the first runtime call to C<toUPPER_utf8> from each call point in the
+ program will raise a deprecation warning, enabled by default.  You can convert
+ your program now to use C<toUPPER_utf8_safe>, and avoid the warnings, and get an
+-extra measure of protection, or you can wait until v5.30, when you'll be forced
++extra measure of protection, or you can wait until v5.32, when you'll be forced
+ to add the C<e> parameter.
+ 
+ =for apidoc Am|U8|toFOLD|U8 ch
+@@ -944,13 +944,13 @@ implementation, and subject to change in future releases.
+ =for apidoc Am|UV|toFOLD_utf8|U8* p|U8* s|STRLEN* lenp
+ This is like C<L</toFOLD_utf8_safe>>, but doesn't have the C<e>
+ parameter  The function therefore can't check if it is reading
+-beyond the end of the string.  Starting in Perl v5.30, it will take the C<e>
++beyond the end of the string.  Starting in Perl v5.32, it will take the C<e>
+ parameter, becoming a synonym for C<toFOLD_utf8_safe>.  At that time every
+ program that uses it will have to be changed to successfully compile.  In the
+ meantime, the first runtime call to C<toFOLD_utf8> from each call point in the
+ program will raise a deprecation warning, enabled by default.  You can convert
+ your program now to use C<toFOLD_utf8_safe>, and avoid the warnings, and get an
+-extra measure of protection, or you can wait until v5.30, when you'll be forced
++extra measure of protection, or you can wait until v5.32, when you'll be forced
+ to add the C<e> parameter.
+ 
+ =for apidoc Am|U8|toLOWER|U8 ch
+@@ -999,13 +999,13 @@ implementation, and subject to change in future releases.
+ =for apidoc Am|UV|toLOWER_utf8|U8* p|U8* s|STRLEN* lenp
+ This is like C<L</toLOWER_utf8_safe>>, but doesn't have the C<e>
+ parameter  The function therefore can't check if it is reading
+-beyond the end of the string.  Starting in Perl v5.30, it will take the C<e>
++beyond the end of the string.  Starting in Perl v5.32, it will take the C<e>
+ parameter, becoming a synonym for C<toLOWER_utf8_safe>.  At that time every
+ program that uses it will have to be changed to successfully compile.  In the
+ meantime, the first runtime call to C<toLOWER_utf8> from each call point in the
+ program will raise a deprecation warning, enabled by default.  You can convert
+ your program now to use C<toLOWER_utf8_safe>, and avoid the warnings, and get an
+-extra measure of protection, or you can wait until v5.30, when you'll be forced
++extra measure of protection, or you can wait until v5.32, when you'll be forced
+ to add the C<e> parameter.
+ 
+ =for apidoc Am|U8|toTITLE|U8 ch
+@@ -1047,13 +1047,13 @@ implementation, and subject to change in future releases.
+ =for apidoc Am|UV|toTITLE_utf8|U8* p|U8* s|STRLEN* lenp
+ This is like C<L</toLOWER_utf8_safe>>, but doesn't have the C<e>
+ parameter  The function therefore can't check if it is reading
+-beyond the end of the string.  Starting in Perl v5.30, it will take the C<e>
++beyond the end of the string.  Starting in Perl v5.32, it will take the C<e>
+ parameter, becoming a synonym for C<toTITLE_utf8_safe>.  At that time every
+ program that uses it will have to be changed to successfully compile.  In the
+ meantime, the first runtime call to C<toTITLE_utf8> from each call point in the
+ program will raise a deprecation warning, enabled by default.  You can convert
+ your program now to use C<toTITLE_utf8_safe>, and avoid the warnings, and get an
+-extra measure of protection, or you can wait until v5.30, when you'll be forced
++extra measure of protection, or you can wait until v5.32, when you'll be forced
+ to add the C<e> parameter.
+ 
+ =cut
+-- 
+2.21.0
+

perl.spec

@@ -257,6 +257,9 @@ Patch50:        perl-5.30.0-perl-134266-make-sure-is-writable-when-we-write-to-i
 # fixed after 5.31.2
 Patch51:        perl-5.31.2-regcomp.c-Don-t-read-off-the-end-of-buffer.patch
 
+# Fix a documentation about a future API change, fixed after 5.31.2
+Patch52:        perl-5.31.2-perlapi-5.30-promise-not-met-change-to-5.32.patch
+
 # Link XS modules to libperl.so with EU::CBuilder on Linux, bug #960048
 Patch200:       perl-5.16.3-Link-XS-modules-to-libperl.so-with-EU-CBuilder-on-Li.patch
 
@@ -2830,6 +2833,7 @@ Perl extension for Version Objects
 %patch49 -p1
 %patch50 -p1
 %patch51 -p1
+%patch52 -p1
 %patch200 -p1
 %patch201 -p1
 
@@ -2888,6 +2892,7 @@ perl -x patchlevel.h \
     'Fedora Patch49: Fix a NULL pointer dereference in PerlIOVia_pushed()' \
     'Fedora Patch50: Fix a crash when setting $@ on unwinding a call stack (RT#134266)' \
     'Fedora Patch51: Fix parsing a denominator when parsing a Unicode property name' \
+    'Fedora Patch52: Fix a documentation about a future API change' \
     'Fedora Patch200: Link XS modules to libperl.so with EU::CBuilder on Linux' \
     'Fedora Patch201: Link XS modules to libperl.so with EU::MM on Linux' \
     %{nil}
@@ -5137,6 +5142,7 @@ popd
 - Fix a NULL pointer dereference in PerlIOVia_pushed()
 - Fix a crash when setting $@ on unwinding a call stack (RT#134266)
 - Fix parsing a denominator when parsing a Unicode property name
+- Fix a documentation about a future API change
 
 * Wed Aug 07 2019 Petr Pisar <ppisar@redhat.com> - 4:5.30.0-443
 - Fix propagating non-string variables in an exception value (RT#134291)