This is a live mirror of the Perl 5 development currently hosted at https://github.com/perl/perl5
feature.pm: Document the bitwise feature
authorFather Chrysostomos <sprout@cpan.org>
Mon, 5 Jan 2015 01:45:19 +0000 (17:45 -0800)
committerFather Chrysostomos <sprout@cpan.org>
Sun, 1 Feb 2015 06:03:53 +0000 (22:03 -0800)
lib/feature.pm
regen/feature.pl

index 81fb295..70d8ada 100644 (file)
@@ -320,6 +320,24 @@ See L<perlref/Assigning to References> for details.
 
 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
+same applies to the assignment variants (C<&= |= ^= &.= |.= ^.=>).
+
+See L<perlop/Bitwise String Operators> for details.
+
+This feature is available from Perl 5.22 onwards.
+
 =head1 FEATURE BUNDLES
 
 It's possible to load multiple features together, using
index 61f7ac2..6733e3c 100755 (executable)
@@ -635,6 +635,24 @@ See L<perlref/Assigning to References> for details.
 
 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
+same applies to the assignment variants (C<&= |= ^= &.= |.= ^.=>).
+
+See L<perlop/Bitwise String Operators> for details.
+
+This feature is available from Perl 5.22 onwards.
+
 =head1 FEATURE BUNDLES
 
 It's possible to load multiple features together, using