From 70816878431fd934e4e0fb213a58b2239c970c52 Mon Sep 17 00:00:00 2001 From: Simon Ser Date: Wed, 14 Dec 2022 17:09:48 +0100 Subject: keyboard: improve documentation --- include/wlr/types/wlr_keyboard.h | 23 +++++++++++++++++++---- 1 file changed, 19 insertions(+), 4 deletions(-) (limited to 'include/wlr') diff --git a/include/wlr/types/wlr_keyboard.h b/include/wlr/types/wlr_keyboard.h index b1e01c4d..abc4edf6 100644 --- a/include/wlr/types/wlr_keyboard.h +++ b/include/wlr/types/wlr_keyboard.h @@ -116,12 +116,27 @@ bool wlr_keyboard_set_keymap(struct wlr_keyboard *kb, bool wlr_keyboard_keymaps_match(struct xkb_keymap *km1, struct xkb_keymap *km2); /** - * Sets the keyboard repeat info. `rate` is in key repeats/second and delay is - * in milliseconds. + * Set the keyboard repeat info. + * + * rate is in key repeats/second and delay is in milliseconds. + */ +void wlr_keyboard_set_repeat_info(struct wlr_keyboard *kb, int32_t rate_hz, + int32_t delay_ms); + +/** + * Update the LEDs on the device, if any. + * + * leds is a bitmask of enum wlr_keyboard_led. + * + * If the device doesn't have the provided LEDs, this function is a no-op. */ -void wlr_keyboard_set_repeat_info(struct wlr_keyboard *kb, int32_t rate, - int32_t delay); void wlr_keyboard_led_update(struct wlr_keyboard *keyboard, uint32_t leds); + +/** + * Get the set of currently depressed or latched modifiers. + * + * A bitmask of enum wlr_keyboard_modifier is returned. + */ uint32_t wlr_keyboard_get_modifiers(struct wlr_keyboard *keyboard); #endif -- cgit v1.2.3