From a3d1b107f44c71b6fad32a43cbc2bed5c10ce041 Mon Sep 17 00:00:00 2001
From: Damien Cassou <damien@cassou.me>
Date: Wed, 7 Mar 2018 09:59:21 +0100
Subject: [PATCH] doc/protocol.xml: Add examples to the description of 'count'

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

diff --git a/doc/protocol.xml b/doc/protocol.xml
index bc54c8d53..77c767847 100644
--- a/doc/protocol.xml
+++ b/doc/protocol.xml
@@ -1626,14 +1626,20 @@ OK
           <listitem>
             <para>
               Counts the number of songs and their total playtime in
-              the db matching <varname>TAG</varname> exactly.
+              the db matching <varname>TAG</varname> exactly. The
+              following prints the number of songs whose title matches
+              "Echoes":
             </para>
+            <programlisting>count title Echoes</programlisting>
             <para>
               The <parameter>group</parameter> keyword may be used to
-              group the results by a tag.  The following prints
-              per-artist counts:
+              group the results by a tag.  The first following example
+              prints per-artist counts while the next prints the
+              number of songs whose title matches "Echoes" grouped by
+              artist:
             </para>
             <programlisting>count group artist</programlisting>
+            <programlisting>count title Echoes group artist</programlisting>
           </listitem>
         </varlistentry>