diff -r 20f864eaec94 -r 9de88d62d686 Integer.st
--- a/Integer.st	Mon Oct 29 11:25:12 2012 +0100
+++ b/Integer.st	Mon Oct 29 12:35:37 2012 +0100
@@ -1143,7 +1143,11 @@
 
 & aNumber
     "return the bitwise-and of the receiver and the argument, anInteger.
-     Same as bitAnd: - added for compatibility with Dolphin Smalltalk"
+     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."
 
     ^ self bitAnd:aNumber
 
@@ -1215,7 +1219,11 @@
 
 | aNumber
     "return the bitwise-or of the receiver and the argument, anInteger.
-     Same as bitOr: - added for compatibility with Dolphin Smalltalk"
+     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."
 
     ^ self bitOr:aNumber
 
@@ -4841,11 +4849,11 @@
 !Integer class methodsFor:'documentation'!
 
 version
-    ^ '$Header: /cvs/stx/stx/libbasic/Integer.st,v 1.269 2012-10-20 13:35:36 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic/Integer.st,v 1.270 2012-10-29 11:35:37 cg Exp $'
 !
 
 version_CVS
-    ^ '$Header: /cvs/stx/stx/libbasic/Integer.st,v 1.269 2012-10-20 13:35:36 cg Exp $'
+    ^ '$Header: /cvs/stx/stx/libbasic/Integer.st,v 1.270 2012-10-29 11:35:37 cg Exp $'
 ! !
 
 Integer initialize!