--- doc/docbase/instrument_scripts/nksp/reference/01_nksp_reference.html	2017/01/05 16:36:16	3075
+++ doc/docbase/instrument_scripts/nksp/reference/01_nksp_reference.html	2017/05/30 16:14:40	3256
@@ -28,6 +28,10 @@
         <th>Function</th> <th>Description</th>
       </tr>
       <tr>
+        <td><code lang="nksp">array_equal()</code></td>
+        <td>Check whether two arrays are equal.</td>
+      </tr>
+      <tr>
         <td><code lang="nksp">dec()</code></td>
         <td>Decrements the passed integer variable by one.</td>
       </tr>
@@ -36,10 +40,22 @@
         <td>Increments the passed integer variable by one.</td>
       </tr>
       <tr>
+        <td><code>in_range()</code></td>
+        <td>Checks whether a value is between two other values.</td>
+      </tr>
+      <tr>
         <td><code lang="nksp">message()</code></td>
         <td>Prints text to the sampler's terminal.</td>
       </tr>
       <tr>
+        <td><code>search()</code></td>
+        <td>Search for a certain value within an array.</td>
+      </tr>
+      <tr>
+        <td><code>sort()</code></td>
+        <td>Sort the given array.</td>
+      </tr>
+      <tr>
         <td><code>exit()</code></td>
         <td>Stops execution of the current event handler instance.</td>
       </tr>
@@ -95,18 +111,42 @@
         <td>Triggers a new note.</td>
       </tr>
       <tr>
+        <td><code>change_note()</code></td>
+        <td>Change MIDI note number of note.</td>
+      </tr>
+      <tr>
         <td><code>change_pan()</code></td>
         <td>Changes panning of voices (stereo balance).</td>
       </tr>
       <tr>
+        <td><code>change_play_pos()</code></td>
+        <td>Change the sample playback position.</td>
+      </tr>
+      <tr>
         <td><code>change_tune()</code></td>
         <td>Changes the tuning of voices.</td>
       </tr>
       <tr>
+        <td><code>change_tune_time()</code></td>
+        <td>Changes the duration of tuning changes.</td>
+      </tr>
+      <tr>
+        <td><code>change_tune_curve()</code></td>
+        <td>Changes the curve type of tuning changes.</td>
+      </tr>
+      <tr>
         <td><code>change_vol()</code></td>
         <td>Changes the volume of voices.</td>
       </tr>
       <tr>
+        <td><code>change_vol_time()</code></td>
+        <td>Changes the duration of volume changes.</td>
+      </tr>
+      <tr>
+        <td><code>change_vol_curve()</code></td>
+        <td>Changes the curve type of volume changes.</td>
+      </tr>
+      <tr>
         <td><code>change_cutoff()</code></td>
         <td>Changes filter cutoff frequency of voices.</td>
       </tr>
@@ -127,10 +167,46 @@
         <td>Modifies the release time of voices.</td>
       </tr>
       <tr>
+        <td><code>change_amp_lfo_depth()</code></td>
+        <td>Modifies the amplitude LFO depth.</td>
+      </tr>
+      <tr>
+        <td><code>change_amp_lfo_freq()</code></td>
+        <td>Modifies the amplitude LFO frequency.</td>
+      </tr>
+      <tr>
+        <td><code>change_pitch_lfo_depth()</code></td>
+        <td>Modifies the pitch LFO depth.</td>
+      </tr>
+      <tr>
+        <td><code>change_pitch_lfo_freq()</code></td>
+        <td>Modifies the pitch LFO frequency.</td>
+      </tr>
+      <tr>
+        <td><code>change_velo()</code></td>
+        <td>Change MIDI velocity of note.</td>
+      </tr>
+      <tr>
         <td><code>event_status()</code></td>
         <td>Checks and returns whether a particular note is still alive.</td>
       </tr>
       <tr>
+        <td><code>fade_in()</code></td>
+        <td>Fade the requested note in.</td>
+      </tr>
+      <tr>
+        <td><code>fade_out()</code></td>
+        <td>Fade the requested note out.</td>
+      </tr>
+      <tr>
+        <td><code>get_event_par()</code></td>
+        <td>Get the current value of a specific note parameter.</td>
+      </tr>
+      <tr>
+        <td><code>set_event_par()</code></td>
+        <td>Change the value of a specific note parameter.</td>
+      </tr>
+      <tr>
         <td><code>set_controller()</code></td>
         <td>Creates a MIDI control change event.</td>
       </tr>
@@ -173,6 +249,10 @@
         <td><code>gig_set_dim_zone()</code></td>
         <td>Changes the currently active dimension zone.</td>
       </tr>
+      <tr>
+        <td><code>same_region()</code></td>
+        <td>Check whether two keys are mapped to the same region.</td>
+      </tr>
     </table>
 
     <h2>Built-In Variables</h2>
@@ -319,6 +399,9 @@
         <td>
           Note IDs of all currently active notes of the current sampler part (a.k.a. sampler channel).
           This may be passed to many built-in functions like <code>note_off()</code>.
+          This array variable only contains IDs of notes which were launched due
+          to MIDI note-on events. This variable does not contain IDs of child notes
+          (i.e. notes which were launched programmatically by calling <code>play_note()</code>).
           <note>
             In contrast to KSP this variable is an integer array type, whereas KSP's
             pendent of this built-in variable is an integer constant (scalar) called
@@ -373,12 +456,51 @@
             note is still "alive".</td>
       </tr>
       <tr>
+        <td><code>$EVENT_PAR_NOTE</code></td>
+        <td>Constant value symbolizing the "note number" parameter. See 
+            <code>get_event_par()</code> and <code>set_event_par()</code>
+            for details.</td>
+      </tr>
+      <tr>
+        <td><code>$EVENT_PAR_TUNE</code></td>
+        <td>Constant value symbolizing the "tune" parameter. See 
+            <code>get_event_par()</code> and <code>set_event_par()</code>
+            for details.</td>
+      </tr>
+      <tr>
+        <td><code>$EVENT_PAR_VELOCITY</code></td>
+        <td>Constant value symbolizing the "note velocity" parameter. See 
+            <code>get_event_par()</code> and <code>set_event_par()</code>
+            for details.</td>
+      </tr>
+      <tr>
+        <td><code>$EVENT_PAR_VOLUME</code></td>
+        <td>Constant value symbolizing the "volume" parameter. See 
+            <code>get_event_par()</code> and <code>set_event_par()</code>
+            for details.</td>
+      </tr>
+      <tr>
+        <td><code>$EVENT_PAR_0</code> to <code>$EVENT_PAR_3</code></td>
+        <td>Four constant values symbolizing the 4 possible user specific
+            parameters, which i.e. might be used to pass data from one script
+            (slot) to another script (slot). See  <code>get_event_par()</code>
+            and <code>set_event_par()</code> for details.</td>
+      </tr>
+      <tr>
         <td><code>%KEY_DOWN[]</code></td>
         <td>This can be used in any context to check whether a certain MIDI
             key is currently pressed down. Use the respective MIDI note number
             as index to this array variable (see also <code>event_status()</code>).</td>
       </tr>
       <tr>
+        <td><code>$NKSP_EASE_IN_EASE_OUT</code></td>
+        <td>Used to select a fade curve with "ease in and ease out" shape.</td>
+      </tr>
+      <tr>
+        <td><code>$NKSP_LINEAR</code></td>
+        <td>Used to select a fade curve with linear shape.</td>
+      </tr>
+      <tr>
         <td><code>$VCC_MONO_AT</code></td>
         <td>Constant identifying the MIDI monophonic aftertouch controller (also
             called <i title="Amount of force on held-down key.">
@@ -452,7 +574,7 @@
         <td>Constant that identifies the <i>keyboard position dimension</i>.</td>
       </tr>
       <tr>
-        <td><code>$GIG_DIM_ROUNDROBIN"</code></td>
+        <td><code>$GIG_DIM_ROUNDROBIN</code></td>
         <td>Constant that identifies the <i>round robin dimension</i>.</td>
       </tr>
       <tr>