summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAlex Merry <alex.merry@cs.ox.ac.uk>2011-11-04 13:23:29 +0000
committerAlex Merry <alex.merry@cs.ox.ac.uk>2011-11-04 13:23:29 +0000
commit64fc2f80b65e04811973c0bf6588808e06dbe631 (patch)
tree3833084b34546ae4b93b7fdeb8bdfd3734310aba
parentfdf126fc8bd3b75c2d9e1a6bc5288706e7481fc9 (diff)
Clarify the type of the mpris:trackid entry in Player.Metadata
-rw-r--r--spec/Player_Node.xml4
-rw-r--r--spec/TrackList_Node.xml8
-rw-r--r--spec/all.xml4
3 files changed, 11 insertions, 5 deletions
diff --git a/spec/Player_Node.xml b/spec/Player_Node.xml
index d554d60..62e9b03 100644
--- a/spec/Player_Node.xml
+++ b/spec/Player_Node.xml
@@ -394,8 +394,8 @@
<p>The metadata of the current element.</p>
<p>
If there is a current track, this must have a "mpris:trackid" entry
- at the very least, which contains a string that uniquely identifies
- this track.
+ (of D-Bus type "o") at the very least, which contains a D-Bus path that
+ uniquely identifies this track.
</p>
<p>
See the type documentation for more details.
diff --git a/spec/TrackList_Node.xml b/spec/TrackList_Node.xml
index 4663ae2..a0ce423 100644
--- a/spec/TrackList_Node.xml
+++ b/spec/TrackList_Node.xml
@@ -45,9 +45,11 @@
<tp:docstring xmlns="http://www.w3.org/1999/xhtml">
<p>A mapping from metadata attribute names to values.</p>
<p>
- The <b>mpris:trackid</b> attribute must always be present. This contains
- a string that uniquely identifies the track within the scope of the
- playlist.
+ The <b>mpris:trackid</b> attribute must always be present, and must be
+ of D-Bus type "o". This contains a D-Bus path that uniquely identifies
+ the track within the scope of the playlist. There may or may not be
+ an actual D-Bus object at that path; this specification says nothing
+ about what interfaces such an object may implement.
</p>
<p>
If the length of the track is known, it should be provided in the
diff --git a/spec/all.xml b/spec/all.xml
index 47ca0af..a10b676 100644
--- a/spec/all.xml
+++ b/spec/all.xml
@@ -144,6 +144,10 @@
<li>
2011-01-26: Added PlaylistChanged signal to the Playlists interface.
</li>
+ <li>
+ 2011-11-04: Clarified the type of the mpris:trackid entry in the
+ Metadata property of the Player interface.
+ </li>
</ul>
</tp:docstring>
</tp:section>