[PATCH] update protocol specification to match wire protocol

[Daniel Stone]

Hi,

On 5 September 2014 13:51, Pekka Paalanen <ppaalanen at gmail.com> wrote:

> Essentially you are breaking the unwritten specification on how the XML
> files are processed into wire format and language bindings.
> Wayland-scanner is not the only generator, and wayland.xml is not the
> only XML file in existence.
>
> [...]
>
> If you look carefully, you see that there is absolutely no
> documentation on how to generate the wire protocol or C function
> signatures from the XML. It is all undocumented.
>
> The only authoritative definition we currently have is
> http://cgit.freedesktop.org/wayland/wayland/tree/src/scanner.c


None of which is to say it shouldn't be documented! We'd more than welcome
enhanced documentation here, although writing your own bindings/scanner
that bypass the traditional C bindings is quite fraught, in terms of
interoperability with things like EGL in particular.

Cheers,
Daniel
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.freedesktop.org/archives/wayland-devel/attachments/20140905/ea9833c3/attachment.html>