[PATCH wayland] protocol: Add deprecation note about wl_shell
jadahl at gmail.com
Sat Dec 2 02:57:45 UTC 2017
Now that xdg_shell is stable and much better defined than wl_shell we
can finally deprecate wl_shell and guide users towards xdg_shell
Signed-off-by: Jonas Ådahl <jadahl at gmail.com>
Eventually we can consider adding deprecation attributes the
<interface> XML nodes that'll turn into compiler warnings, but this is
at least a start moving away from wl_shell. I imagine the wl_shell users
today (SDL, GLFW at least) to hopefully migrate soon, but keep the
wl_shell as a fallback for the time being while compositors add support
for xdg_shell. So we probably don't want to add compiler warnings for
them just yet.
protocol/wayland.xml | 3 +++
1 file changed, 3 insertions(+)
diff --git a/protocol/wayland.xml b/protocol/wayland.xml
index aabc7ae..77d991e 100644
@@ -976,6 +976,9 @@
It allows clients to associate a wl_shell_surface with
a basic surface.
+ Note! This protocol is deprecated and not intended for production use.
+ For desktop-style user interfaces, use xdg_shell.
More information about the wayland-devel