[PATCH v2 0/4] Enum and bitfield XML attributes

Auke Booij auke at tulcod.com
Mon Oct 19 15:21:22 PDT 2015


There has been plenty of discussion regarding the introduction of new XML
attributes. This series of patches improves on my earlier attempt to find
common ground in this.

Major exclusions from these patches are:

- Support for cross-interface enum referencing (e.g.
wl_shm_pool::create_buffer::format to wl_shm::format, and
wl_surface::set_buffer_transform::transform to wl_output::transform).

- Open/closed enum specification. There is still too much debate in this.
Until there is any firm specification of open/closed enums, every enum 
should be considered open, and although some legal values might be listed,
others might not be, and some might only be legal sometimes. New values
may be added (but not changed or removed) to protocol specifications
without introducing any compatibility issues.

Auke Booij (4):
  doc: document the enum and bitfield attributes
  protocol: specify enum and bitfield attributes
  scanner: enforce correct argument type for enums
  doc: output enum and bitfield attributes in the documentation

 doc/publican/protocol-to-docbook.xsl |  9 +++++
 doc/publican/sources/Protocol.xml    | 35 ++++++++++++++----
 protocol/wayland.xml                 | 34 +++++++++---------
 src/scanner.c                        | 70 ++++++++++++++++++++++++++++++++++++
 4 files changed, 125 insertions(+), 23 deletions(-)

-- 
2.6.1



More information about the wayland-devel mailing list