Enums, bitfields and wl_arrays in the .xml file

Bill Spitzak spitzak at gmail.com
Fri Sep 18 11:55:11 PDT 2015

On Fri, Sep 18, 2015 at 5:37 AM, Nils Chr. Brause <nilschrbrause at gmail.com>

> Hi,
> There are even earlier discussions about including 'bitfield' and
> 'enum' fields into the XML protocol file, e.g:
> http://lists.freedesktop.org/archives/wayland-devel/2014-September/017071.html
> But none of them led to any actual changes.
> I still would very much like to see the 'bitfield' and 'enum' fields
> to be included in the XML protocol file. This would greatly simplify
> the creation of Wayland bindings for most high level programming
> languages and thus increase the popularity of Wayland amongst
> programmers who don't wish to use toolkits.
> Without these information about bitfields and enumerations, language
> bindings would have to maintain their own version of the XML protocol
> file, like I am doing with my C++ bindings here:
> https://github.com/NilsBrause/waylandpp

Yes please get this in. I really expected this to be merged long ago.

This is almost a requirement for bindings for any language other than C.
And it greatly improves the automatically generated documentation of the C
api, too!

And it is absolutely 100% compatible with everything that exists right now
(except code reading the xml files, which might have to be modified to
ignore the new tags). It does not change the size or bit layout of any data
in the stream protocol and does not change the C api, and does not prevent
the sending or construction of any message or event that can be sent right
now. In particular it does not prevent bit patterns that are not in the
enumeration from being sent by the C api.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freedesktop.org/archives/wayland-devel/attachments/20150918/a573c387/attachment.html>

More information about the wayland-devel mailing list