--- a/DeviceWorkstation.st	Thu Jan 18 17:17:05 2018 +0100
+++ b/DeviceWorkstation.st	Thu Jan 18 17:17:33 2018 +0100
@@ -7284,7 +7284,11 @@
 !
 
 beepInEditor
-    "output an audible beep or bell, if enabled"
+    "output an audible beep or bell, if enabled.
+
+     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"
 
     "{ Pragma: +optSpace }"