--- a/ApplicationModel.st	Thu Jan 18 17:01:22 2018 +0100
+++ b/ApplicationModel.st	Thu Jan 18 17:17:40 2018 +0100
@@ -4083,7 +4083,12 @@
 !
 
 beepInEditor
-    "output an audible beep or bell on my screen device"
+    "output an audible beep or bell on my screen device.
+
+     beep to wakeup the user after some error/not found condition in an editor.
+     Use this ONLY to beep in response to a bad user operation (not system failure beeps).
+     Can be disabled via the settings if too annoying"
+
 
     device notNil ifTrue:[
         device beepInEditor.