From: Jonas Ådahl Date: Tue, 5 May 2015 07:35:14 +0000 (+0800) Subject: xdg-shell: Clarify the meaning of app ID and give example X-Git-Tag: 1.7.93~13 X-Git-Url: http://review.tizen.org/git/?a=commitdiff_plain;h=ca13f7ed8f93cb3c5d227e77978dd78db16a1244;p=platform%2Fupstream%2Fweston.git xdg-shell: Clarify the meaning of app ID and give example Signed-off-by: Jonas Ådahl --- diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml index 1629bd0..0720662 100644 --- a/protocol/xdg-shell.xml +++ b/protocol/xdg-shell.xml @@ -189,6 +189,15 @@ the surface belongs. The compositor can use this to group multiple surfaces together, or to determine how to launch a new application. + For D-Bus activatable applications, the app ID is used as the D-Bus + service name. + + The compositor shell will try to group application surfaces together + by their app ID. As a best practice, it is suggested to select app + ID's that match the basename of the application's .desktop file. + For example, "org.freedesktop.FooViewer" where the .desktop file is + "org.freedesktop.FooViewer.desktop". + See the desktop-entry specification [0] for more details on application identifiers and how they relate to well-known D-Bus names and .desktop files.