[PATCH wayland] protocol: Add deprecation note about wl_shell

Jonas Ådahl 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
--- a/protocol/wayland.xml
+++ b/protocol/wayland.xml
@@ -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.
     <enum name="error">

More information about the wayland-devel mailing list