From 7ab789fbafe99489be62f27fea2cb24bf558f9bc Mon Sep 17 00:00:00 2001
From: Max Kellermann <max.kellermann@gmail.com>
Date: Mon, 29 Jul 2024 16:29:13 +0200
Subject: [PATCH] doc/user.rst: add clarification to the "always_on" option

---
 doc/user.rst | 8 +++++++-
 1 file changed, 7 insertions(+), 1 deletion(-)

diff --git a/doc/user.rst b/doc/user.rst
index c8e398b8e..9738182b1 100644
--- a/doc/user.rst
+++ b/doc/user.rst
@@ -529,7 +529,13 @@ The following table lists the audio_output options valid for all plugins:
    * - **tags yes|no**
      - If set to no, then :program:`MPD` will not send tags to this output. This is only useful for output plugins that can receive tags, for example the httpd output plugin.
    * - **always_on yes|no**
-     - If set to yes, then :program:`MPD` attempts to keep this audio output always open. This may be useful for streaming servers, when you don't want to disconnect all listeners even when playback is accidentally stopped.
+     - If set to yes, then :program:`MPD` attempts to keep this audio
+       output always open.  Instead of closing at the end
+       of playback, it puts the device in "pause" mode.  This works
+       only with output plugins that suport "pause" mode.
+       This may be useful for streaming servers, when you don't want
+       to disconnect all listeners even when playback is accidentally
+       stopped.
    * - **always_off yes|no**
      - If set to yes, then :program:`MPD` never uses this audio output for
        playback even if it's enabled. This can be used with the null output