diff options
| author | Father Chrysostomos <sprout@cpan.org> | 2017-12-31 12:54:44 -0800 |
|---|---|---|
| committer | Father Chrysostomos <sprout@cpan.org> | 2017-12-31 16:22:51 -0800 |
| commit | 193789ac15b87b3f3a23dc38e9e19500c69dbf28 (patch) | |
| tree | b37ec2ab1c9897cf70558165b8564ff206e6b114 /lib | |
| parent | 401d2aaa50f74cc9e0d089bb6236d5960689c76c (diff) | |
| download | perl-193789ac15b87b3f3a23dc38e9e19500c69dbf28.tar.gz | |
Update docs wrt bitwise ops
Diffstat (limited to 'lib')
| -rw-r--r-- | lib/feature.pm | 12 | ||||
| -rw-r--r-- | lib/overload.pm | 4 |
2 files changed, 6 insertions, 10 deletions
diff --git a/lib/feature.pm b/lib/feature.pm index 1ea74eb8a0..97f789ad64 100644 --- a/lib/feature.pm +++ b/lib/feature.pm @@ -316,13 +316,6 @@ This feature is available from Perl 5.22 onwards. =head2 The 'bitwise' feature -B<WARNING>: This feature is still experimental and the implementation may -change 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::bitwise"; - This makes the four standard bitwise operators (C<& | ^ ~>) treat their operands consistently as numbers, and introduces four new dotted operators (C<&. |. ^. ~.>) that treat their operands consistently as strings. The @@ -330,7 +323,10 @@ same applies to the assignment variants (C<&= |= ^= &.= |.= ^.=>). See L<perlop/Bitwise String Operators> for details. -This feature is available from Perl 5.22 onwards. +This feature is available from Perl 5.22 onwards. Starting in Perl 5.28, +C<use v5.28> will enable the feature. Before 5.28, it was still +experimental and would emit a warning in the "experimental::bitwise" +category. =head2 The 'declared_refs' feature diff --git a/lib/overload.pm b/lib/overload.pm index b19c5a53cb..f7d5d0f7cf 100644 --- a/lib/overload.pm +++ b/lib/overload.pm @@ -310,7 +310,7 @@ An appropriate implementation of C<--> might look like # ... sub decr { --${$_[0]}; } -If the experimental "bitwise" feature is enabled (see L<feature>), a fifth +If the "bitwise" feature is enabled (see L<feature>), a fifth TRUE argument is passed to subroutines handling C<&>, C<|>, C<^> and C<~>. This indicates that the caller is expecting numeric behaviour. The fourth argument will be C<undef>, as that position (C<$_[3]>) is reserved for use @@ -693,7 +693,7 @@ The specified function will be passed four parameters. The first three arguments coincide with those that would have been passed to the corresponding method if it had been defined. The fourth argument is the C<use overload> key for that missing -method. If the experimental "bitwise" feature is enabled (see L<feature>), +method. If the "bitwise" feature is enabled (see L<feature>), a fifth TRUE argument is passed to subroutines handling C<&>, C<|>, C<^> and C<~> to indicate that the caller is expecting numeric behaviour. For example, if C<$a> is an object blessed into a package declaring |