--- a/Integer.st	Sat Jan 23 11:30:05 2016 +0100
+++ b/Integer.st	Sat Jan 23 11:31:16 2016 +0100
@@ -1134,9 +1134,10 @@
     "return the bitwise-and of the receiver and the argument, anInteger.
      Same as bitAnd: - added for compatibility with Dolphin Smalltalk.
      Notice:
-        please do not use ^ for integers in new code; it makes the code harder
-        to understand, as it may be not obvious, whether a boolean or a bitWise or is intended.
-        For integers, use bitAnd: to make the intention explicit."
+        PLEASE DO NOT USE & for integers in new code; it makes the code harder
+        to understand, as it may be not obvious, whether a boolean-and a bitWise-and is intended.
+        For integers, use bitAnd: to make the intention explicit.
+        Also, consider using and: for booleans, which is does not evaluate the right part if the left is false."
 
     ^ self bitAnd:aNumber
 
@@ -1231,7 +1232,7 @@
         PLEASE DO NOT USE | for integers in new code; it makes the code harder
         to understand, as it may be not obvious, whether a boolean-or a bitWise-or is intended.
         For integers, use bitOr: to make the intention explicit.
-        For booleans, consider using or:, which is does not evaluate the right part if the left is true."
+        Also, consider using or: for booleans, which is does not evaluate the right part if the left is true."
 
     ^ self bitOr:aNumber