--- doc/docbase/instrument_scripts/nksp/reference/functions/nksp_change_vol_function.html	2016/07/09 14:41:00	2932
+++ doc/docbase/instrument_scripts/nksp/reference/functions/nksp_change_vol_function.html	2017/05/19 14:26:05	3189
@@ -16,7 +16,16 @@
       all layers.
     </p>
     <p>
-      The volume changes set by calling function are always applied relatively to
+      Internally the sampler always fades the volume from its current value to
+      the new volume as requested, however that volume fade by default is so fast
+      that it sounds like its value jumps directly from its old to the new value,
+      it is yet slow enough though to avoid undesired click sounds. You may also
+      override that automated fade time explicitly by calling
+      <code lang="nksp">change_vol_time()</code> before calling the
+      <code lang="nksp">change_vol()</code> function.
+    </p>
+    <p>
+      The volume changes set by calling this function are always applied relatively to
       the volume calculated by the synthesis model and sampler format. That means
       the various sources of volume factors like MIDI CC #7, Amplitute Envelopes,
       Amplitutude LFOs and other volume factors that may be defined by the
@@ -50,7 +59,7 @@
       </tr>
       <tr>
         <td><code>??note??</code></td>
-        <td>Note ID Number</td>
+        <td>Note ID Number or Note ID Array</td>
         <td>All voices of this note will be modified.<br>
             [required]</td>
       </tr>
@@ -59,7 +68,8 @@
         <td>Integer Number</td>
         <td>Volume change in Milli dB.
             A positive value increases the volume,
-            a negative value decreases the volume.</td>
+            a negative value decreases the volume.<br>
+            [required]</td>
       </tr>
       <tr>
         <td><code>??relative??</code></td>
@@ -79,9 +89,18 @@
 
     <h3>Examples</h3>
     <p>None yet.<p>
+    
+    <h3>See also</h3>
+    <p><code>change_vol_time()</code>, <code>fade_in()</code>, <code>fade_out()</code><p>
 
     <h3>Availabilty</h3>
     <p>Since LinuxSampler 2.0.0.svn11.<p>
 
+    <note>
+      The third argument of this function <code>??relative??</code> is only
+      optional with NKSP. If you want to keep compatibility with KSP, then you
+      should always pass a value for that third argument of this function.
+    </note>
+
   </body>
 </html>