diff options
Diffstat (limited to 'spec/all.xml')
-rw-r--r-- | spec/all.xml | 19 |
1 files changed, 16 insertions, 3 deletions
diff --git a/spec/all.xml b/spec/all.xml index 9878b68..8549de4 100644 --- a/spec/all.xml +++ b/spec/all.xml @@ -68,6 +68,10 @@ "no track" where required in the <b>org.mpris.MediaPlayer2.TrackList</b> interface (since empty paths are not allowed by D-Bus). </li> + <li> + The suggested unique instance identifier no longer violates the D-Bus + specification by begining with a digit. + </li> </ul> </dd> <dt>From 2.0 to 2.1:</dt> @@ -117,13 +121,22 @@ <p> In the case where the media player allows multiple instances running simultaneously, each additional instance should request a unique bus - name, adding a dot and a unique identifier (such as a UNIX process - id) to its usual bus name. For example, this could be + name, adding a dot and a unique identifier to its usual bus name, such + as one based on a UNIX process id. + + For example, this could be: </p> <ul> - <li>org.mpris.MediaPlayer2.vlc.7389</li> + <li>org.mpris.MediaPlayer2.vlc.instance7389</li> </ul> + + <p> + Note: According to the <a href="http://dbus.freedesktop.org/doc/dbus-specification.html#message-protocol-names-bus"> + D-Bus specification</a>, the unique identifier "must only contain the + ASCII characters '[A-Z][a-z][0-9]_-'" and "must not begin with a digit". + </p> + </tp:docstring> </tp:section> |