diff options
author | Daniel Stone <daniel@fooishbar.org> | 2012-04-03 12:48:05 +0100 |
---|---|---|
committer | Daniel Stone <daniel@fooishbar.org> | 2012-04-03 12:48:05 +0100 |
commit | 69111405b0ca02d79238f05979f11cf5f0e02686 (patch) | |
tree | 3345fabfa1071bb086170069f3e96273e40a2d8f /include | |
parent | aeaa623d27b18339cab42aa52e4c10acb8ff87a8 (diff) | |
download | xorg-lib-libxkbcommon-69111405b0ca02d79238f05979f11cf5f0e02686.tar.gz |
Properly document xkb_key_get_syms
Signed-off-by: Daniel Stone <daniel@fooishbar.org>
Diffstat (limited to 'include')
-rw-r--r-- | include/xkbcommon/xkbcommon.h | 17 |
1 files changed, 13 insertions, 4 deletions
diff --git a/include/xkbcommon/xkbcommon.h b/include/xkbcommon/xkbcommon.h index d5d009f..4955cd7 100644 --- a/include/xkbcommon/xkbcommon.h +++ b/include/xkbcommon/xkbcommon.h @@ -186,10 +186,6 @@ xkb_keysym_to_string(xkb_keysym_t ks, char *buffer, size_t size); _X_EXPORT extern xkb_keysym_t xkb_string_to_keysym(const char *s); -_X_EXPORT unsigned int -xkb_key_get_syms(struct xkb_state *state, xkb_keycode_t key, - xkb_keysym_t **syms_out); - /** * @defgroup ctx XKB contexts * Every keymap compilation request must have an XKB context associated with @@ -441,6 +437,19 @@ xkb_state_update_key(struct xkb_state *state, xkb_keycode_t key, enum xkb_key_direction direction); /** + * Gives the symbols obtained from pressing a particular key with the given + * state. *syms_out will be set to point to an array of keysyms, with the + * return value being the number of symbols in *syms_out. If the return + * value is 0, *syms_out will be set to NULL, as there are no symbols produced + * by this event. + * + * This should be called before xkb_state_update_key. + */ +_X_EXPORT unsigned int +xkb_key_get_syms(struct xkb_state *state, xkb_keycode_t key, + xkb_keysym_t **syms_out); + +/** * Modifier and group types for state objects. This enum is bitmaskable, * e.g. (XKB_STATE_DEPRESSED | XKB_STATE_LATCHED) is valid to exclude * locked modifiers. |