From 3ae46831adb734a265b3f38b9df01b41e01f4318 Mon Sep 17 00:00:00 2001 From: Mirsal Ennaime Date: Sun, 15 Apr 2012 17:56:57 +0200 Subject: Fix the unique instance identifier example The current recommendation to use a unix pid as a unique instance identifier and the bus name given as an example are misleading as they suggest that it begins with a digit, which violates the D-Bus specification. * Rephrase the suggestion to use a unix pid * Change the example so it complies with the D-Bus spec * Add a note quoting the relevant part of the D-Bus spec --- spec/all.xml | 19 ++++++++++++++++--- 1 file 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 org.mpris.MediaPlayer2.TrackList interface (since empty paths are not allowed by D-Bus). +
  • + The suggested unique instance identifier no longer violates the D-Bus + specification by begining with a digit. +
    • From 2.0 to 2.1:
    @@ -117,13 +121,22 @@

    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:

    + +

    + Note: According to the + D-Bus specification, the unique identifier "must only contain the + ASCII characters '[A-Z][a-z][0-9]_-'" and "must not begin with a digit". +

    + -- cgit v1.2.3