[PATCH] xdg-shell: Clarify the meaning of app ID and give example

[Bryce Harrington]

On Tue, May 05, 2015 at 03:35:14PM +0800, Jonas Ådahl wrote:
> Signed-off-by: Jonas Ådahl <jadahl at gmail.com>
> ---
> 
> Hi,
> 
> I updated the text as to what you suggested as it sounded less confusing.

Looks good now, pushed:
   a7e1991..ca13f7e  master -> master

 
> Jonas
> 
>  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
> --- a/protocol/xdg-shell.xml
> +++ b/protocol/xdg-shell.xml
> @@ -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
> +	"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.
> -- 
> 2.1.4
> 
> _______________________________________________
> wayland-devel mailing list
> wayland-devel at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/wayland-devel