Merge pull request #841 from xARSENICx/stem-vu-meter-docs

docs: Add Stem VU Meter controls to appendix

Author: ronso0

source/chapters/appendix/mixxx_controls.rst

@@ -552,6 +552,10 @@ Decks, Preview Decks and Samplers
 
 Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samplers and preview decks, just replace :mixxx:cogroupref:`[ChannelN]` with :mixxx:cogroupref:`[PreviewDeckN]` or :mixxx:cogroupref:`[SamplerN]`.
 
+The :mixxx:cogroupref:`[ChannelN_StemM]` group allows you to interact with specific stems of a deck when a stem file is loaded.
+M ranges from 1 to 4.
+Some controls (like volume, mute, and VU meters) are shared between decks and stems, while others (like color) are stem-specific.
+
 .. seealso:: There are some :ref:`additional global controls for samplers <appendix-mixxxcontrols-samplers>`.
 
 .. mixxx:control:: [ChannelN],back
@@ -3139,8 +3143,9 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
 .. mixxx:control:: [ChannelN],vu_meter
                    [PreviewDeckN],vu_meter
                    [SamplerN],vu_meter
+                   [ChannelN_StemM],vu_meter
 
-   Outputs the current instantaneous deck volume
+   Outputs the current instantaneous deck volume (or stem volume for :mixxx:cogroupref:`[ChannelN_StemM]`)
 
    :range: default
    :feedback: Deck VU meter
@@ -3149,13 +3154,16 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
       Replaces the deprecated :mixxx:coref:`[ChannelN],VuMeter`,
       :mixxx:coref:`[PreviewDeckN],VuMeter` and
       :mixxx:coref:`[SamplerN],VuMeter` controls.
+   .. versionchanged:: 2.6.0
+      Added :mixxx:coref:`[ChannelN_StemM],vu_meter`.
 
 
 .. mixxx:control:: [ChannelN],vu_meter_left
                    [PreviewDeckN],vu_meter_left
                    [SamplerN],vu_meter_left
+                   [ChannelN_StemM],vu_meter_left
 
-   Outputs the current instantaneous deck volume for the left channel
+   Outputs the current instantaneous deck volume for the left channel (or stem volume for :mixxx:cogroupref:`[ChannelN_StemM]`)
 
    :range: default
    :feedback: Deck VU meter L
@@ -3164,13 +3172,16 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
       Replaces the deprecated :mixxx:coref:`[ChannelN],VuMeterL`,
       :mixxx:coref:`[PreviewDeckN],VuMeterL` and
       :mixxx:coref:`[SamplerN],VuMeterL` controls.
+   .. versionchanged:: 2.6.0
+      Added :mixxx:coref:`[ChannelN_StemM],vu_meter_left`.
 
 
 .. mixxx:control:: [ChannelN],vu_meter_right
                    [PreviewDeckN],vu_meter_right
                    [SamplerN],vu_meter_right
+                   [ChannelN_StemM],vu_meter_right
 
-   Outputs the current instantaneous deck volume for the right channel
+   Outputs the current instantaneous deck volume for the right channel (or stem volume for :mixxx:cogroupref:`[ChannelN_StemM]`)
 
    :range: default
    :feedback: Deck VU meter R
@@ -3179,6 +3190,8 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
       Replaces the deprecated :mixxx:coref:`[ChannelN],VuMeterR`,
       :mixxx:coref:`[PreviewDeckN],VuMeterR` and
       :mixxx:coref:`[SamplerN],VuMeterR` controls.
+   .. versionchanged:: 2.6.0
+      Added :mixxx:coref:`[ChannelN_StemM],vu_meter_right`.
 
 
 .. mixxx:control:: [ChannelN],waveform_zoom