doc: try to clarify some subtle points
authorRan Benita <ran234@gmail.com>
Wed, 31 Jul 2013 07:38:30 +0000 (10:38 +0300)
committerRan Benita <ran234@gmail.com>
Wed, 31 Jul 2013 07:55:20 +0000 (10:55 +0300)
commit3a0adc0f5c1e79c333477e81efe77134a84f473d
treef0f8822dd21b451da14ffd6f4971c7e0b70e0ecb
parent7f1b7a1c360929a1351ed254055f702bac5ee61b
doc: try to clarify some subtle points

Which to choose: xkb_state_update_key() / xkb_state_update_mask(). If you
use update_mask(), you don't (and shouldn't) use update_key().
If you use update_key(), be careful not to have unmatched UP/DOWN
calls; this can bring about stuck modifiers etc.

Probably want to use XKB_STATE_{MODS,LAYOUT}_EFFECTIVE. The others are
only useful in very special cases.

Signed-off-by: Ran Benita <ran234@gmail.com>
xkbcommon/xkbcommon.h