--- doc/docbase/instrument_scripts/nksp/reference/functions/nksp_wait_function.html	2016/07/15 15:33:43	2949
+++ doc/docbase/instrument_scripts/nksp/reference/functions/nksp_wait_function.html	2019/09/16 16:03:36	3601
@@ -9,11 +9,17 @@
     <p>
       Suspends / pauses execution of the current event handler instance for the requested
       amount of microseconds. The paused event handler instance can also be resumed before
-      the requested amount times elapsed by calling <code>stop_wait()</code> from another
+      the requested amount times elapsed by calling <code lang="nksp">stop_wait()</code> from another
       event handler instance.
     </p>
+    <p>
+      The <code>??duration-us??</code> argument must neither
+      be negative nor zero, otherwise script execution will be aborted, because this
+      is a common indication of bugs in scripts which could potentially lead to
+      real-time instability or worse scenarios otherwise.
+    </p>
     <note>
-      If the even handler instance's built-in variable <code>$NKSP_IGNORE_WAIT</code>
+      If the event handler instance's built-in variable <code>$NKSP_IGNORE_WAIT</code>
       reflects <code>1</code> then all calls to <code>wait()</code> will be ignored.
       This might for example be the case when <code>stop_wait()</code> with
       <code>1</code> being passed to the 2nd argument of that function.
@@ -32,17 +38,29 @@
       </tr>
       <tr>
         <td><code>??duration-us??</code></td>
-        <td>Integer Number</td>
-        <td>Amount of microseconds to pause execution.<br>
+        <td>Integer&nbsp;Number&nbsp;or<br>
+            Real&nbsp;Number</td>
+        <td>Positive (non zero) amount of microseconds to pause execution.<br>
             [required]</td>
       </tr>
     </table>
-    
+
     <h3>Return Value</h3>
     <p>None.</p>
-    
+
+    <h3>Remarks</h3>
+    <p>
+      This functions optionally accepts <code>s</code> as standard unit
+      for its argument <code>??duration-us??</code>.
+    </p>
+
     <h3>Examples</h3>
-    <p/>
+    <p>
+      The following example resembles a simple delay effect. For each note
+      being triggered by the musician, the script launches additional notes,
+      each one of such additional successive notes with a more and more reduced
+      volume.
+    </p>
     <code>
 on init
   { The amount of notes to play }
@@ -94,5 +112,8 @@
       miliseconds, no matter which function argument you provided.
     </note>
 
+    <h3>See also</h3>
+    <p><code>stop_wait()</code><p>
+
   </body>
 </html>