diff options
author | Philippe Bruhat (BooK) <book@cpan.org> | 2022-10-24 23:25:20 +0200 |
---|---|---|
committer | Yves Orton <demerphq@gmail.com> | 2023-02-25 00:49:18 +0800 |
commit | ac8ba642ae7dadc7f3491e13148b8d1c45b84649 (patch) | |
tree | a08dbb4067203b56ea30eab4cc45e6086ae1789c /pod | |
parent | d798806246348688ced6c193cc59369e89579170 (diff) | |
download | perl-ac8ba642ae7dadc7f3491e13148b8d1c45b84649.tar.gz |
Document that smartmatch is deprecated and will be removed in 5.42
Diffstat (limited to 'pod')
-rw-r--r-- | pod/perldiag.pod | 30 |
1 files changed, 14 insertions, 16 deletions
diff --git a/pod/perldiag.pod b/pod/perldiag.pod index d99f79c6e8..d774e3537c 100644 --- a/pod/perldiag.pod +++ b/pod/perldiag.pod @@ -2643,11 +2643,10 @@ C<getpwnam> operator returned an invalid UIC. forget to check the return value of your socket() call? See L<perlfunc/getsockopt>. -=item given is experimental +=item given is deprecated -(S experimental::smartmatch) C<given> depends on smartmatch, which -is experimental, so its behavior may change or even be removed -in any future release of perl. See the explanation under +(D deprecated) C<given> depends on smartmatch, which is deprecated. It +will be removed in Perl 5.42. See the explanation under L<perlsyn/Experimental Details on given and when>. =item Global symbol "%s" requires explicit package name (did you forget to @@ -6038,14 +6037,13 @@ so there can't be any left to fill later parameters. overload it: Perl refuses to use the object's underlying structure for the smart match. -=item Smartmatch is experimental +=item Smartmatch is deprecated -(S experimental::smartmatch) This warning is emitted if you -use the smartmatch (C<~~>) operator. This is currently an experimental -feature, and its details are subject to change in future releases of -Perl. Particularly, its current behavior is noticed for being -unnecessarily complex and unintuitive, and is very likely to be -overhauled. +(D deprecated) This warning is emitted if you +use the smartmatch (C<~~>) operator. This is a deprecated +feature. Particularly, its behavior is noticed for being +unnecessarily complex and unintuitive, and it will be removed +in Perl 5.42. =item Sorry, hash keys must be smaller than 2**31 bytes @@ -8025,12 +8023,12 @@ but in actual fact, you got So put in parentheses to say what you really mean. -=item when is experimental +=item when is deprecated -(S experimental::smartmatch) C<when> depends on smartmatch, which is -experimental. Additionally, it has several special cases that may -not be immediately obvious, and their behavior may change or -even be removed in any future release of perl. See the explanation +(D deprecated) C<when> depends on smartmatch, which is +deprecated. Additionally, it has several special cases that may +not be immediately obvious, and it will be removed in Perl 5.42. +See the explanation under L<perlsyn/Experimental Details on given and when>. =item Wide character in %s |