[doc] 'switch' feature still documented as removed in 5.42

[mauke]

Where
feature.pm

Description
perldoc feature says about the switch feature:

It will be removed in Perl 5.42.

But that can't be true because ./perl -Ilib -e 'use feature "switch";' still runs fine (and we're about to release 5.42).

[jkeenan]

lib/feature.pm is a generated file. We'll need to take a look at this documentation found starting at around line 711 of regen/feature.pl.:

=head2 The 'smartmatch' feature

C<use feature 'smartmatch'> tells the compiler to enable the
smartmatch operator C<~~>.  It is enabled by default, but can be
turned off to disallow the C<~~> operator.

This feature is disabled by default in the 5.42 feature bundle
onwards:

  $x ~~ $y; # fine
  use v5.42;
  $x ~~ $y; # error

This has no effect on the implicit smartmatches done by C<when>.

See L<perlop/"Smartmatch Operator"> for details.

=head2 The 'switch' feature

B<WARNING>: This feature is still experimental and the implementation may
change or be removed in future versions of Perl.  For this reason, Perl will
warn when you use the feature, unless you have explicitly disabled the warning:

    no warnings "experimental::smartmatch";

C<use feature 'switch'> tells the compiler to enable the Raku
given/when construct.

See L<perlsyn/"Switch Statements"> for details.

This feature is available starting with Perl 5.10.
It is deprecated starting with Perl 5.38, and using
C<given>, C<when> or smartmatch will throw a warning.
It will be removed in Perl 5.42.

Suggestions?