--- doc/docbase/instrument_scripts/nksp/reference/01_nksp_reference.html	2017/06/27 23:29:31	3294
+++ doc/docbase/instrument_scripts/nksp/reference/01_nksp_reference.html	2017/12/06 18:53:32	3396
@@ -11,6 +11,8 @@
     <p>
       This document gives you an overview of all built-in functions and built-in
       variables provided by the NKSP real-time instrument script language.
+      If you are new to NKSP, then you may want to read the
+      <a href="01_nksp.html">NKSP language tour</a> first.
     </p>
 
     <h2>Built-In Functions</h2>
@@ -37,7 +39,11 @@
       </tr>
       <tr>
         <td><code>fork()</code></td>
-        <td>Creates new execution instances.</td>
+        <td>Creates new execution instances (threads).</td>
+      </tr>
+      <tr>
+        <td><code>callback_status()</code></td>
+        <td>Returns the current status of a callback (thread).</td>
       </tr>
       <tr>
         <td><code lang="nksp">dec()</code></td>
@@ -127,6 +133,14 @@
         <td>Changes panning of voices (stereo balance).</td>
       </tr>
       <tr>
+        <td><code>change_pan_time()</code></td>
+        <td>Changes the duration of panning (stereo balance) changes.</td>
+      </tr>
+      <tr>
+        <td><code>change_pan_curve()</code></td>
+        <td>Changes the curve type of panning (stereo balance) changes.</td>
+      </tr>
+      <tr>
         <td><code>change_play_pos()</code></td>
         <td>Change the sample playback position.</td>
       </tr>
@@ -164,17 +178,39 @@
       </tr>
       <tr>
         <td><code>change_attack()</code></td>
-        <td>Modifies the attack time of voices.</td>
+        <td>Modifies the amplitude attack time of voices.</td>
       </tr>
       <tr>
         <td><code>change_decay()</code></td>
-        <td>Modifies the decay time of voices.</td>
+        <td>Modifies the amplitude decay time of voices.</td>
+      </tr>
+      <tr>
+        <td><code>change_sustain()</code></td>
+        <td>Modifies the amplitude sustain level of voices.</td>
       </tr>
       <tr>
         <td><code>change_release()</code></td>
-        <td>Modifies the release time of voices.</td>
+        <td>Modifies the amplitude release time of voices.</td>
+      </tr>
+
+      <tr>
+        <td><code>change_cutoff_attack()</code></td>
+        <td>Modifies the filter cutoff attack time of voices.</td>
       </tr>
       <tr>
+        <td><code>change_cutoff_decay()</code></td>
+        <td>Modifies the filter cutoff decay time of voices.</td>
+      </tr>
+      <tr>
+        <td><code>change_cutoff_sustain()</code></td>
+        <td>Modifies the filter cutoff sustain level of voices.</td>
+      </tr>
+      <tr>
+        <td><code>change_cutoff_release()</code></td>
+        <td>Modifies the filter cutoff release time of voices.</td>
+      </tr>
+
+      <tr>
         <td><code>change_amp_lfo_depth()</code></td>
         <td>Modifies the amplitude LFO depth.</td>
       </tr>
@@ -182,6 +218,16 @@
         <td><code>change_amp_lfo_freq()</code></td>
         <td>Modifies the amplitude LFO frequency.</td>
       </tr>
+
+      <tr>
+        <td><code>change_cutoff_lfo_depth()</code></td>
+        <td>Modifies the filter cutoff LFO depth.</td>
+      </tr>
+      <tr>
+        <td><code>change_cutoff_lfo_freq()</code></td>
+        <td>Modifies the filter cutoff LFO frequency.</td>
+      </tr>
+
       <tr>
         <td><code>change_pitch_lfo_depth()</code></td>
         <td>Modifies the pitch LFO depth.</td>
@@ -279,6 +325,22 @@
         <th>Variable</th> <th>Description</th>
       </tr>
       <tr>
+        <td><code>$CALLBACK_STATUS_QUEUE</code></td>
+        <td>Built-in constant reflecting the status of a callback to be
+            alive but suspended. See <code>callback_status()</code> for details.</td>
+      </tr>
+      <tr>
+        <td><code>$CALLBACK_STATUS_RUNNING</code></td>
+        <td>Built-in constant reflecting the status of a callback to be
+            alive and currently executing. See <code>callback_status()</code>
+            for details.</td>
+      </tr>
+      <tr>
+        <td><code>$CALLBACK_STATUS_TERMINATED</code></td>
+        <td>Built-in constant reflecting the status of a callback to be
+            not alive. See <code>callback_status()</code> for details.</td>
+      </tr>
+      <tr>
         <td><code>$KSP_TIMER</code></td>
         <td>Preserved for compatiblity reasons with KSP, returns the same value
            as <code>$NKSP_REAL_TIMER</code> (refer to the latter for details).
@@ -326,7 +388,7 @@
         <td><code>%NKSP_CALLBACK_CHILD_ID[]</code></td>
         <td>
           Reflects the callback IDs of all child threads which the current
-          script callback instance spawned by calling function <code>fork()</code>.
+          script callback instance spawned by having called <code>fork()</code> before.
           See the latter function for details about this array variable.
         </td>
       </tr>
@@ -335,8 +397,8 @@
         <td>
           If the current execution thread is a child thread spawned by a <code>fork()</code>
           call before, then this variable reflects the callback ID of the parent
-          thread which created this child thread. Otherwise this variable is zero.
-          See function <code>fork()</code> for more details about this variable.
+          thread which created this child thread. Otherwise this variable is <code>0</code>.
+          See <code>fork()</code> for more details about this variable.
         </td>
       </tr>
       <tr>
@@ -707,6 +769,33 @@
         <td>Constant that identifies the <i>general purpose 8 MIDI controller dimension</i>.</td>
       </tr>
     </table>
+
+	<h2>Built-In Preprocessor Conditions</h2>
+    <p>
+      These are the built-in preprocessor conditions available with the NKSP realt-time
+      instrument script language.
+    </p>
     
+    <h3>Core Language Preprocessor Conditions</h3>
+    <p>
+      Most fundamental NKSP built-in preprocessor conditions, independent from
+      any purpose of being used in a sampler.
+    </p>
+    <table>
+      <tr>
+        <th>Condition</th> <th>Description</th>
+      </tr>
+      <tr>
+        <td><code>NKSP_NO_MESSAGE</code></td>
+        <td>
+          By default this condition is not set. By explicitly enabling this
+          condition with <code>SET_CONDITION(NKSP_NO_MESSAGE)</code> it
+          causes all subsequent <code>message()</code> calls to be ignored
+          and filtered out on preprocessor level. See function <code>message()</code>
+          for details.
+        </td>
+      </tr>
+    </table>
+
   </body>
 </html>