diff options
author | Peter Harris <pharris@opentext.com> | 2013-04-11 09:52:57 -0400 |
---|---|---|
committer | Peter Harris <pharris@opentext.com> | 2013-04-16 14:37:05 -0400 |
commit | ee71d96c83ec86aeb0227f259c03ed3752cc04b3 (patch) | |
tree | 147e141d43687e8b6d165c5623de16458eb6b4e6 /doc/xml-xcb.txt | |
parent | 63fce1aa1a3df0683ddf09796fa1a744fb426e25 (diff) | |
download | xcb-proto-ee71d96c83ec86aeb0227f259c03ed3752cc04b3.tar.gz |
Allow multiple <enumref> in a <bitcase>
Signed-off-by: Peter Harris <pharris@opentext.com>
Diffstat (limited to 'doc/xml-xcb.txt')
-rw-r--r-- | doc/xml-xcb.txt | 13 |
1 files changed, 9 insertions, 4 deletions
diff --git a/doc/xml-xcb.txt b/doc/xml-xcb.txt index 7057727..cf6d14e 100644 --- a/doc/xml-xcb.txt +++ b/doc/xml-xcb.txt @@ -229,13 +229,18 @@ enum; the value is restricted to one of the constants named in the enum. <switch> instead for new protocol definitions. <switch name="identifier"> switch expression - <bitcase> bitcase expression, fields </bitcase> </switch> + <bitcase> bitcase expression(s), fields </bitcase> </switch> This element represents conditional inclusion of fields. It can be viewed as sequence of multiple ifs: if ( switch expression & bitcase expression ) - is equal to bitcase expression, bitcase fields are included in structure. - It can be used only as the last field of structure. New protocol definitions - should prefer to use this instead of <valueparam>. + is non-zero, bitcase fields are included in structure. It can be used only + as the last field of a structure. + + When a bitcase includes multiple <enumref> clauses, the contents of the + bitcase are only present once regardless of the number of bitcase expressions + that match. + + New protocol definitions should prefer to use this instead of <valueparam>. Expressions ----------- |