[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