From cf0c59864f8d1898278ef88530aaf89657214881 Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@musicpd.org>
Date: Fri, 21 Jul 2017 09:51:43 +0200
Subject: [PATCH] doc/protocol.xml: clarify that idle events do not get lost

---
 doc/protocol.xml | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/doc/protocol.xml b/doc/protocol.xml
index 7996abd94..dca8a75bb 100644
--- a/doc/protocol.xml
+++ b/doc/protocol.xml
@@ -403,6 +403,15 @@
                 </para>
               </listitem>
             </itemizedlist>
+
+            <para>
+              Change events accumulate, even while the connection is
+              not in "idle" mode; no events gets lost while the client
+              is doing something else with the connection.  If an
+              event had already occurred since the last call, the new
+              <command>idle</command> command will return immediately.
+            </para>
+
             <para>
               While a client is waiting for <command>idle</command>
               results, the server disables timeouts, allowing a client