protocol: make it clear wl_surface.enter/leave are not for frame throttling
authorSimon Ser <contact@emersion.fr>
Wed, 15 Jul 2020 07:39:25 +0000 (09:39 +0200)
committerSimon Ser <contact@emersion.fr>
Thu, 29 Oct 2020 13:02:50 +0000 (13:02 +0000)
commitd42b39ccab5baff33eb6a0d38d6d46ef0c442e89
treee8751dc03c7bb20ee82cf66dd1ec83c74fb4ee62
parent1ea08d748cfa86d7395315ca3e52085b0e1c8155
protocol: make it clear wl_surface.enter/leave are not for frame throttling

Some clients rely on wl_surface.enter/leave to start/stop their rendering
loop.

There are cases where this doesn't work:

- Some compositors don't send wl_surface.leave when a toplevel is hidden.
  For instance Sway doesn't send this event when a toplevel is on an inactive
  workspace (but doesn't send wl_surface.frame events).
- Some compositors might still want applications to continue to render even if
  away from outputs. For instance a compositor that allows to screen record
  individual toplevels might not send a wl_surface.enter event for hidden
  toplevels.

Signed-off-by: Simon Ser <contact@emersion.fr>
protocol/wayland.xml