Skip to content

Commit eecf12e

Browse files
committed
perlexperiment: clarify/update status of switch and smartmatch
Fixes #23272
1 parent c8fd0ab commit eecf12e

File tree

1 file changed

+46
-16
lines changed

1 file changed

+46
-16
lines changed

pod/perlexperiment.pod

Lines changed: 46 additions & 16 deletions
Original file line numberDiff line numberDiff line change
@@ -18,22 +18,6 @@ their inception, versions, etc. There's a lot of speculation here.
1818

1919
=over 8
2020

21-
=item Smart match (C<~~>)
22-
23-
Introduced in Perl 5.10.0
24-
25-
Modified in Perl 5.10.1, 5.12.0
26-
27-
Deprecated in 5.38.0
28-
29-
Will be removed in 5.42.0
30-
31-
Using this feature triggers warnings in the category
32-
C<deprecated>.
33-
34-
The ticket for this experiment is
35-
L<[perl #13173]|https://github.com/Perl/perl5/issues/13173>.
36-
3721
=item Pluggable keywords
3822

3923
Introduced in Perl 5.11.2
@@ -469,6 +453,52 @@ Removed in Perl 5.36.0
469453

470454
=back
471455

456+
=head2 Features abandoned in place
457+
458+
These are experiments that are considered failures, but due to mass
459+
use have been left in place.
460+
461+
The switch and smartmatch features are likely to be the only ones
462+
which will ever fall into this category. They were introduced before
463+
we had a well-defined experimental feature process.
464+
465+
These are unlikely to be updated with behavioural changes.
466+
467+
=over
468+
469+
=item Smart match (C<~~>)
470+
471+
Introduced in Perl 5.10.0
472+
473+
Modified in Perl 5.10.1, 5.12.0
474+
475+
Deprecated in 5.38.0
476+
477+
Scheduled for removal in 5.42.0, but this was reversed.
478+
479+
Enabled by default, and in all feature bundles up to 5.40, disabled by
480+
default in feature bundle 5.42, but can be enabled with C<use feature
481+
"smartmatch">.
482+
483+
The ticket for this experiment is
484+
L<[perl #13173]|https://github.com/Perl/perl5/issues/13173>.
485+
486+
=item Switch (given/when)
487+
488+
Introduced in Perl 5.10.0
489+
490+
Deprecated in 5.38.0
491+
492+
Scheduled for removal in 5.42.0, but this was reversed.
493+
494+
Enabled by feature bundles 5.10 through 5.34, but can be enabled with
495+
C<use feature "switch">.
496+
497+
The ticket for this experiment is
498+
L<[perl #13173]|https://github.com/Perl/perl5/issues/13173>.
499+
500+
=back
501+
472502
=head1 SEE ALSO
473503

474504
For a complete list of features check L<feature>.

0 commit comments

Comments
 (0)