--- a/Integer.st	Sat Jan 23 01:10:49 2016 +0100
+++ b/Integer.st	Sat Jan 23 11:30:05 2016 +0100
@@ -1228,9 +1228,10 @@
     "return the bitwise-or of the receiver and the argument, anInteger.
      Same as bitOr: - 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 bitOr: 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-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."
 
     ^ self bitOr:aNumber