From 12768babdfcc99642a343e58af08beb223e2929f Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@duempel.org>
Date: Tue, 29 Apr 2014 10:31:14 +0200
Subject: doc/protocol.xml: add warning to "listall" and "listallinfo"

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

diff --git a/doc/protocol.xml b/doc/protocol.xml
index e9c28995b..360d2d22a 100644
--- a/doc/protocol.xml
+++ b/doc/protocol.xml
@@ -1608,6 +1608,12 @@ OK
               Lists all songs and directories in
               <varname>URI</varname>.
             </para>
+            <para>
+              Do not use this command.  Do not manage a client-side
+              copy of MPD's database.  That is fragile and adds huge
+              overhead.  It will break with large databases.  Instead,
+              query MPD whenever you need something.
+            </para>
           </listitem>
         </varlistentry>
         <varlistentry id="command_listallinfo">
@@ -1623,6 +1629,12 @@ OK
               returns metadata info in the same format as
               <command>lsinfo</command>.
             </para>
+            <para>
+              Do not use this command.  Do not manage a client-side
+              copy of MPD's database.  That is fragile and adds huge
+              overhead.  It will break with large databases.  Instead,
+              query MPD whenever you need something.
+            </para>
           </listitem>
         </varlistentry>
         <varlistentry id="command_listfiles">
-- 
cgit v1.2.3