[PATCH] xdg-shell: Clarify the meaning of app ID and give example
jadahl at gmail.com
Tue May 5 00:35:14 PDT 2015
Signed-off-by: Jonas Ådahl <jadahl at gmail.com>
I updated the text as to what you suggested as it sounded less confusing.
protocol/xdg-shell.xml | 9 +++++++++
1 file changed, 9 insertions(+)
diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml
index ab86922..7257036 100644
@@ -204,6 +204,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
See the desktop-entry specification  for more details on
application identifiers and how they relate to well-known D-Bus
names and .desktop files.
More information about the wayland-devel