diff --git a/pod/perldelta.pod b/pod/perldelta.pod index ee4f3ffb9e5c3..2104e203049b5 100644 --- a/pod/perldelta.pod +++ b/pod/perldelta.pod @@ -45,6 +45,34 @@ XXX For a release on a stable branch, this section aspires to be: [ List each incompatible change as a =head2 entry ] +=head2 Apostrophe is again recognized as a global name separator + +This was deprecated in Perl 5.38 and removed as scheduled in perl +5.41.3, but after some discussion has been reinstated by default. + +This can be controlled with the C +feature which is enabled by default, but is disabled from the 5.41 +feature bundle onwards. + +If you want to disable use within your own code you can explicitly +disable the feature: + + no feature "apostrophe_as_package_separator"; + +Note that disabling this feature only prevents use of apostrophe as a +package separator within code, symbolic references still treat C<'> as +C<::> with the feature disabled: + + my $symref = "My'Module'Var"; + # default features + my $x = $My'Module'Var; # fine + no feature "apostrophe_as_package_separator"; + no strict "refs"; + my $y = $$symref; # like $My::Module::Var + my $z = $My'Module'Var; # syntax error + +[L] + =head1 Deprecations XXX Any deprecated features, syntax, modules etc. should be listed here.