[PATCH weston 05/17] xdg-shell: Document responsibilities regarding ping events

[Bryce Harrington]

On Tue, Apr 07, 2015 at 05:01:20PM +0800, Jonas Ådahl wrote:
> Document that a compositor is free to ping in any way it wants, but a
> client must always respond to any xdg_shell object it created.
> 
> Signed-off-by: Jonas Ådahl <jadahl at gmail.com>
> ---
>  protocol/xdg-shell.xml | 4 ++++
>  1 file changed, 4 insertions(+)
> 
> diff --git a/protocol/xdg-shell.xml b/protocol/xdg-shell.xml
> index 866bd85..0b6c999 100644
> --- a/protocol/xdg-shell.xml
> +++ b/protocol/xdg-shell.xml
> @@ -124,6 +124,10 @@
>          alive. It's unspecified what will happen if the client doesn't
>          respond to the ping request, or in what timeframe. Clients should
>          try to respond in a reasonable amount of time.
> +
> +        A client must be ready to respond to any bound xdg_shell objects ping
> +        event. It is up to the compositor to decide when and to what xdg_shell
> +        objects to ping.

Fwiw, I think what you wrote for the changelog is clearer.

>        </description>
>        <arg name="serial" type="uint" summary="pass this to the pong request"/>
>      </event>
> -- 
> 2.1.4
> 
> _______________________________________________
> wayland-devel mailing list
> wayland-devel at lists.freedesktop.org
> http://lists.freedesktop.org/mailman/listinfo/wayland-devel