Index: trunk/FACT++/scripts/doc/dimctrl.js
===================================================================
--- trunk/FACT++/scripts/doc/dimctrl.js	(revision 16828)
+++ trunk/FACT++/scripts/doc/dimctrl.js	(revision 16829)
@@ -101,4 +101,9 @@
  * event (dim or command interface) will be processed.
  *
+ * If an interrupt was triggered by dimctrl (so not from within
+ * the script) and a number between 10 and 255 is returned,
+ * the state machine will change its state accordingly. Other returned
+ * ojects or returned values outside of this range are ignored.
+ *
  * @param {Function} [func]
  *    Function to be called when an interrupt is received. Null, undefined
@@ -117,4 +122,7 @@
  *         for (var key in args)
  *             console.out(" args["+key+"="+args[key]);
+ *
+ *         var newState = 10;
+ *         return newState;
  *     }
  *     dimctrl.setInterruptHandler(handleIrq);
@@ -134,4 +142,10 @@
  *     a new line.
  *
+ * @returns
+ *    the return of the interrupt handler which is called is returned
+ *
+ * @throws
+ *    if an argument contains a line break
+ *
  * @example
  *     dimctrl.triggerInterrupt();
@@ -140,6 +154,4 @@
  *     dimctrl.triggerInterrupt("arg1=x arg2 arg3");
  *
- * @throws
- *    if an argument contains a line break
  */
 dimctrl.triggerInterrupt = function() { /* [native code] */ }