mention the -Minteger effect on modulus (from Nathan Torkington)

p4raw-id: //depot/perl@3690

1 files changed, 11 insertions, 0 deletions

diff --git a/lib/integer.pm b/lib/integer.pm
index 894931896f..f6be58a0eb 100644
--- a/lib/integer.pm
+++ b/lib/integer.pm
@@ -28,6 +28,17 @@ code
 you'll be left with C<$x == 1.5>, C<$y == 2> and C<$z == -1>.  The $z
 case happens because unary C<-> counts as an operation.
 
+Native integer arithmetic (as provided by your C compiler) is used.
+This means that Perl's own semantics for arithmetic operations may
+not be preserved.  One common source of trouble is the modulus of
+negative numbers, which Perl does one way, but your hardware may do
+another.
+
+  % perl -le 'print (4 % -3)'
+  -2
+  % perl -Minteger -le 'print (4 % -3)'
+  1
+
 See L<perlmod/Pragmatic Modules>.
 
 =cut