[PATCH wayland v3 0/4] Enum and bitfield XML attributes

Auke Booij auke at tulcod.com
Sat Oct 24 04:07:46 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).
   There is consensus that this should be added sooner rather than later.
   My proposal is to get these patches in first, and then look at that.

 - Open/closed enum specification. There is still too much debate on 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.

Changes since v2:
 - Incorporate new documentation drawn up during v2 discussion
 - Enable wl_shell_surface::transform bitfield

Changes since v1:
 - Split up documentation patches
 - Set enum="fullscreen_method" on
   wl_shell_surface::set_fullscreen::method

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    | 41 +++++++++++++++++----
 protocol/wayland.xml                 | 36 +++++++++----------
 src/scanner.c                        | 70 ++++++++++++++++++++++++++++++++++++
 4 files changed, 132 insertions(+), 24 deletions(-)

--
2.6.1


More information about the wayland-devel mailing list