From 97b07798b0158080b2e335df841fcdfc49ef09f0 Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Mon, 9 May 2022 22:50:56 +0200
Subject: [PATCH] doc/protocol.rst: clarify repeat/single/random side effects

---
 doc/protocol.rst | 7 +++++++
 1 file changed, 7 insertions(+)

diff --git a/doc/protocol.rst b/doc/protocol.rst
index aa62e3afb..f8eec58e8 100644
--- a/doc/protocol.rst
+++ b/doc/protocol.rst
@@ -545,6 +545,13 @@ Playback options
     Sets repeat state to ``STATE``,
     ``STATE`` should be 0 or 1.
 
+    If enabled, MPD keeps repeating the whole queue (:ref:`single mode
+    <command_single>` disabled) or the current song (:ref:`single mode
+    <command_single>` enabled).
+
+    If :ref:`random mode <command_random>` is also enabled, the
+    playback order will be shuffled each time the queue gets repeated.
+
 .. _command_setvol:
 
 :command:`setvol {VOL}`