From 06b7090283b20e22165ce8528480be4dacb575ab Mon Sep 17 00:00:00 2001
From: Mirsal Ennaime <mirsal@mirsal.fr>
Date: Thu, 27 Jan 2011 17:47:42 +0100
Subject: Add the PlaylistChange signal to the Playlists interface

Rationale:

  The mpris lacks a way for servers to notify clients of a change
  in a playlist attribute (its name or icon)
---
 spec/Playlists.xml | 16 ++++++++++------
 1 file changed, 10 insertions(+), 6 deletions(-)

diff --git a/spec/Playlists.xml b/spec/Playlists.xml
index 1447834..96c7aa8 100644
--- a/spec/Playlists.xml
+++ b/spec/Playlists.xml
@@ -226,19 +226,23 @@
     <signal name="PlaylistChanged" tp:name-for-bindings="Playlist_Changed">
       <arg name="Playlist" type="(oss)" tp:type="Playlist">
         <tp:docstring>
-          <p>The playlist whose details have changed.</p>
+          The playlist which details have changed.
         </tp:docstring>
       </arg>
       <tp:docstring xmlns="http://www.w3.org/1999/xhtml">
-        <p>
-          Indicates that the name or icon for a playlist has changed.
+        <p>Indicates that either the Name or Icon attribute of a
+           playlist has changed.
         </p>
-        <p>
-          Note that, for this signal to operate correctly, the id of the
-          playlist must not change when the name changes.
+        <p>Client implementations should be aware that this signal
+           may not be implemented.
         </p>
+        <tp:rationale>
+           Without this signal, media players have no way to notify clients
+           of a change in the attributes of a playlist other than the active one
+        </tp:rationale>
       </tp:docstring>
     </signal>
+
   </interface>
 </node>
 <!-- vim:set sw=2 sts=2 et ft=xml: -->
-- 
cgit v1.2.3