@@ -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
3923Introduced 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
474504For a complete list of features check L<feature>.
0 commit comments