[PATCH wayland-protocols 2/4 v2] xdg-shell: Clarify focus semantics for popup grabs

[Mike Blumenkrantz]

Reviewed-By: Mike Blumenkrantz <zmike at osg.samsung.com>

On Fri, Jul 29, 2016 at 12:06 AM Jonas Ådahl <jadahl at gmail.com> wrote:

> Make it clearer what the focus semantics are during a popup grab. In
> short, when a grabbing popup is mapped, the top most popup will always
> have keyboard focus, while pointer and touch focus works just as normal
> except that only surfaces from the grabbing client will receive pointer
> and touch focus.
>
> This patch doesn't really change any semantics but rather clarifies
> what was ambiguous before.
>
> Signed-off-by: Jonas Ådahl <jadahl at gmail.com>
> ---
>
> Changes since v1:
>
>   - Added back the "This is done so that ..." sentence.
>
>
>  unstable/xdg-shell/xdg-shell-unstable-v6.xml | 8 +++++---
>  1 file changed, 5 insertions(+), 3 deletions(-)
>
> diff --git a/unstable/xdg-shell/xdg-shell-unstable-v6.xml
> b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
> index 1d59a0e..2c8f636 100644
> --- a/unstable/xdg-shell/xdg-shell-unstable-v6.xml
> +++ b/unstable/xdg-shell/xdg-shell-unstable-v6.xml
> @@ -1012,9 +1012,11 @@
>         popup will be immediately dismissed. If the parent is a popup that
> did
>         not take an explicit grab, an error will be raised.
>
> -       Clients will receive events for all their surfaces during this grab
> -       (which is an "owner-events" grab in X11 parlance). This is done so
> that
> -       users can navigate through submenus and other "nested" popup
> windows
> +       During a popup grab, the client owning the grab will receive
> pointer
> +       and touch events for all their surfaces as normal (similar to an
> +       "owner-events" grab in X11 parlance), while the top most grabbing
> popup
> +       will always have keyboard focus. This is done so that users can
> +       navigate through submenus and other "nested" popup windows
>         without having to dismiss the topmost popup.
>        </description>
>
> --
> 2.7.4
>
> _______________________________________________
> wayland-devel mailing list
> wayland-devel at lists.freedesktop.org
> https://lists.freedesktop.org/mailman/listinfo/wayland-devel
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <https://lists.freedesktop.org/archives/wayland-devel/attachments/20160804/0f7f1718/attachment.html>