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