feature.pm: Document the bitwise feature

1 files changed, 18 insertions, 0 deletions

diff --git a/lib/feature.pm b/lib/feature.pm
index 81fb295ec4..70d8ada2b4 100644
--- a/lib/feature.pm
+++ b/lib/feature.pm
@@ -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