--- linuxsampler/trunk/Documentation/lscp.xml	2005/07/21 09:36:52	709
+++ linuxsampler/trunk/Documentation/lscp.xml	2005/09/23 06:58:26	778
@@ -31,7 +31,7 @@
                 <email>schoenebeck at software minus engineering dot org</email>
             </address>
         </author>
-        <date month="July" year="2005"/>
+        <date month="September" year="2005"/>
         <workgroup>LinuxSampler Developers</workgroup>
         <keyword>LSCP</keyword>
         <abstract>
@@ -3329,6 +3329,42 @@
             <section title="Global commands">
                 <t>The following commands have global impact on the sampler.</t>
 
+                <section title="Current number of active voices" anchor="GET TOTAL_VOICE_COUNT">
+                    <t>The front-end can ask for the current number of active voices on
+                    the sampler by sending the following command:</t>
+                    <t>
+                        <list>
+                            <t>GET TOTAL_VOICE_COUNT</t>
+                        </list>
+                    </t>
+
+                    <t>Possible Answers:</t>
+                    <t>
+                        <list>
+                            <t>LinuxSampler will answer by returning the number of all active
+                            voices on the sampler.</t>
+                        </list>
+                    </t>
+                </section>
+
+                <section title="Maximum amount of active voices" anchor="GET TOTAL_VOICE_COUNT_MAX">
+                    <t>The front-end can ask for the maximum number of active voices
+                    by sending the following command:</t>
+                    <t>
+                        <list>
+                            <t>GET TOTAL_VOICE_COUNT_MAX</t>
+                        </list>
+                    </t>
+
+                    <t>Possible Answers:</t>
+                    <t>
+                        <list>
+                            <t>LinuxSampler will answer by returning the maximum number
+                            of active voices.</t>
+                        </list>
+                    </t>
+                </section>
+
                 <section title="Reset sampler" anchor="RESET">
                     <t>The front-end can reset the whole sampler by sending the following command:</t>
                     <t>
@@ -3492,6 +3528,8 @@
 		</t>
 		<t>/ MISCELLANEOUS
 		</t>
+		<t>/ TOTAL_VOICE_COUNT
+		</t>
 	</list>
 </t>
 <t>unsubscribe_event =
@@ -3508,6 +3546,8 @@
 		</t>
 		<t>/ MISCELLANEOUS
 		</t>
+		<t>/ TOTAL_VOICE_COUNT
+		</t>
 	</list>
 </t>
 <t>get_instruction =
@@ -3560,6 +3600,10 @@
 		</t>
 		<t>/ SERVER SP INFO
 		</t>
+		<t>/ TOTAL_VOICE_COUNT
+		</t>
+		<t>/ TOTAL_VOICE_COUNT_MAX
+		</t>
 	</list>
 </t>
 <t>set_instruction =
@@ -3876,6 +3920,24 @@
                 message is sufficient here.</t>
             </section>
 
+            <section title="Total number of active voices changed" anchor="SUBSCRIBE TOTAL_VOICE_COUNT">
+                <t>Client may want to be notified when the total number of voices on the
+                back-end changes by issuing the following command:</t>
+                <t>
+                    <list>
+                        <t>SUBSCRIBE TOTAL_VOICE_COUNT</t>
+                    </list>
+                </t>
+                <t>Server will start sending the following notification messages:</t>
+                <t>
+                    <list>
+                        <t>"NOTIFY:TOTAL_VOICE_COUNT:&lt;voices&gt;</t>
+                    </list>
+                </t>
+                <t>where &lt;voices&gt; will be replaced by the new number of
+                all currently active voices.</t>
+            </section>
+
             <section title="Miscellaneous and debugging events" anchor="SUBSCRIBE MISCELLANEOUS">
                 <t>Client may want to be notified of miscellaneous and debugging events occurring at
                 the server by issuing the following command:</t>