From ca13f7ed8f93cb3c5d227e77978dd78db16a1244 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Jonas=20=C3=85dahl?= Date: Tue, 5 May 2015 15:35:14 +0800 Subject: [PATCH] xdg-shell: Clarify the meaning of app ID and give example MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Jonas Ådahl --- protocol/xdg-shell.xml | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml index 1629bd00..07206627 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.