summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorMirsal Ennaime <mirsal@mirsal.fr>2011-01-27 17:47:42 +0100
committerMirsal Ennaime <mirsal@mirsal.fr>2011-08-11 16:18:15 +0200
commit06b7090283b20e22165ce8528480be4dacb575ab (patch)
tree0c4c7ec9d38ca09a621ac61bd0477513f36bf8c2
parentaf962003cb45c965d50c88bc80a06c723e58b5d6 (diff)
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)
-rw-r--r--spec/Playlists.xml16
1 files 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: -->