From 51a499ed70b5c8e2a889c0238c71b91fca4f87d1 Mon Sep 17 00:00:00 2001
From: ronso0 <ronso0@mixxx.org>
Date: Sun, 26 Jan 2025 22:48:19 +0100
Subject: [PATCH] document `loop_anchor` and reverse beatloop controls

---
 source/chapters/appendix/mixxx_controls.rst | 75 ++++++++++++++++++---
 1 file changed, 64 insertions(+), 11 deletions(-)

diff --git a/source/chapters/appendix/mixxx_controls.rst b/source/chapters/appendix/mixxx_controls.rst
index b260c60532..924a38f6f0 100644
--- a/source/chapters/appendix/mixxx_controls.rst
+++ b/source/chapters/appendix/mixxx_controls.rst
@@ -667,6 +667,36 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
    .. versionadded:: 2.0.0
 
 
+.. mixxx:control:: [ChannelN],beatloop_size
+                   [PreviewDeckN],beatloop_size
+                   [SamplerN],beatloop_size
+
+   Set the length of the loop in beats that will get set with
+   :mixxx:coref:`beatloop_activate <[ChannelN],beatloop_activate>` and
+   :mixxx:coref:`beatlooproll_activate <[ChannelN],beatlooproll_activate>`.
+   Changing this will resize an existing loop if the length of the loop matches
+   :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>`.
+
+   :range: positive real number
+   :feedback: Beatloop size spinbox and possibly loop section on waveform
+
+   .. versionadded:: 2.1.0
+
+
+.. mixxx:control:: [ChannelN],loop_anchor
+                   [PreviewDeckN],loop_anchor
+                   [SamplerN],loop_anchor
+
+   Adjusts whether loops created with :mixxx:coref:`[ChannelN],beatloop_X_activate`,
+   :mixxx:coref:`[ChannelN],beatloop_X_toggle` or :mixxx:coref:`[ChannelN],beatloop_rX_activate`
+   span forward or backward from the current play position.
+
+   :range: binary
+   :feedback: Loop anchor button
+
+   .. versionadded:: 2.5.0
+
+
 .. mixxx:control:: [ChannelN],beatloop_activate
                    [PreviewDeckN],beatloop_activate
                    [SamplerN],beatloop_activate
@@ -692,20 +722,17 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
    .. versionadded:: 1.10.0
 
 
-.. mixxx:control:: [ChannelN],beatloop_size
-                   [PreviewDeckN],beatloop_size
-                   [SamplerN],beatloop_size
+.. mixxx:control:: [ChannelN],beatloop_rX_activate
+                   [PreviewDeckN],beatloop_rX_activate
+                   [SamplerN],beatloop_rX_activate
 
-   Set the length of the loop in beats that will get set with
-   :mixxx:coref:`beatloop_activate <[ChannelN],beatloop_activate>` and
-   :mixxx:coref:`beatlooproll_activate <[ChannelN],beatlooproll_activate>`.
-   Changing this will resize an existing loop if the length of the loop matches
-   :mixxx:coref:`beatloop_size <[ChannelN],beatloop_size>`.
+   Like :mixxx:coref:`[ChannelN],beatloop_X_activate` except that the loop is created
+   backwards from the current play position.
 
-   :range: positive real number
-   :feedback: Beatloop size spinbox and possibly loop section on waveform
+   :range: binary
+   :feedback: A loop is shown over X beats.
 
-   .. versionadded:: 2.1.0
+   .. versionadded:: 2.5.0
 
 
 .. mixxx:control:: [ChannelN],beatloop_X_toggle
@@ -721,6 +748,19 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
    .. versionadded:: 1.10.0
 
 
+.. mixxx:control:: [ChannelN],beatloop_rX_toggle
+                   [PreviewDeckN],beatloop_rX_toggle
+                   [SamplerN],beatloop_rX_toggle
+
+   Like :mixxx:coref:`[ChannelN],beatloop_X_toggle` except that the loop is created
+   backwards from the current play position.
+
+   :range: binary
+   :feedback: A loop is shown over X beats.
+
+   .. versionadded:: 2.5.0
+
+
 .. mixxx:control:: [ChannelN],beatloop_X_enabled
                    [PreviewDeckN],beatloop_X_enabled
                    [SamplerN],beatloop_X_enabled
@@ -760,6 +800,19 @@ Any control listed above for :mixxx:cogroupref:`[ChannelN]` will work for a samp
    .. versionadded:: 1.11.0
 
 
+.. mixxx:control:: [ChannelN],beatlooproll_rX_activate
+                   [PreviewDeckN],beatlooproll_rX_activate
+                   [SamplerN],beatlooproll_rX_activate
+
+   Like :mixxx:coref:`[ChannelN],beatlooproll_X_activate` except that the loop is created
+   backwards from the current play position.
+
+   :range: binary
+   :feedback: Beatloop X button in skin is lit. A loop overlay is shown over X beats on waveform.
+
+   .. versionadded:: 2.5.0
+
+
 .. mixxx:control:: [ChannelN],beats_adjust_faster
                    [PreviewDeckN],beats_adjust_faster
                    [SamplerN],beats_adjust_faster