From b4db28fed2a2cf2ee23a239d7180718fcbde8671 Mon Sep 17 00:00:00 2001
From: Max Kellermann <max@duempel.org>
Date: Thu, 24 Apr 2014 08:08:52 +0200
Subject: doc/protocol.xml: update and fix command "list"

---
 doc/protocol.xml | 15 ++++++++++-----
 1 file changed, 10 insertions(+), 5 deletions(-)

(limited to 'doc/protocol.xml')

diff --git a/doc/protocol.xml b/doc/protocol.xml
index 1c7e928b1..fd20f9751 100644
--- a/doc/protocol.xml
+++ b/doc/protocol.xml
@@ -1550,27 +1550,32 @@ OK
             </para>
           </listitem>
         </varlistentry>
+
         <varlistentry id="command_list">
           <term>
             <cmdsynopsis>
               <command>list</command>
               <arg choice="req"><replaceable>TYPE</replaceable></arg>
-              <arg><replaceable>ARTIST</replaceable></arg>
+              <arg choice="opt"><replaceable>FILTERTYPE</replaceable></arg>
+              <arg choice="opt"><replaceable>FILTERWHAT</replaceable></arg>
+              <arg choice="opt"><replaceable>...</replaceable></arg>
             </cmdsynopsis>
           </term>
           <listitem>
             <para>
-              Lists all tags of the specified type.
+              Lists unique tags values of the specified type.
               <varname>TYPE</varname> can be any tag supported by MPD or
               <parameter>file</parameter>.
             </para>
             <para>
-              <varname>ARTIST</varname> is an optional parameter when
-              type is album, this specifies to list albums by an
-              artist.
+              Additional arguments may specify a filter like the one
+              in the <link
+              linkend="command_find"><command>find</command>
+              command</link>.
             </para>
           </listitem>
         </varlistentry>
+
         <varlistentry id="command_listall">
           <term>
             <cmdsynopsis>
-- 
cgit v1.2.3