--- doc/docbase/instrument_scripts/nksp/reference/functions/nksp_change_note_function.html	2017/05/25 21:49:40	3219
+++ doc/docbase/instrument_scripts/nksp/reference/functions/nksp_change_note_function.html	2017/05/26 11:06:18	3220
@@ -20,6 +20,25 @@
       event processing chain and thus the note's note number can no longer be
       changed.
     </p>
+    <p>
+      Note that the new note number set by this function only affects the
+      resulting new voices, it does not modify the actual MIDI event.
+      That means the new voices behave as if the MIDI event itself was
+      modified, that is for the new voices the instrument's region,
+      synthesis parameter case and sample is selected based upon the
+      new note number.
+    </p>
+    <p>
+      However outside the scope of new voices the old MIDI note number is
+      retained. That means for example the newly triggered voices will only
+      be released later on if a MIDI note-off event was received equal to
+      the old MIDI note number (not the new note number), and also other
+      MIDI processing tasks of the sampler like
+      <i title="A set of regions where always only one of them is played at a time and thus a newly triggered region automatically releases the previous region (of the same exclusive group).">
+        exclusive groups
+      </i> (a.k.a. key groups), key based round robin and all other common
+      MIDI processing tasks are not affected by this function at all.
+    </p>
 
     <h3>Function Prototype</h3>
     <p/>