X-Git-Url: http://review.tizen.org/git/?a=blobdiff_plain;f=xkbcommon%2Fxkbcommon.h;h=6d196aaf192b08d91015dba7421dec576ae6cda5;hb=bbf388ec1f632f648b0e1323fe90c251c0425bf7;hp=a6b0fa816b6e9b1b3543bce18fb2b151c216de62;hpb=b6ddd105686aaa7accb63d5fe9c228cc4d7b1db0;p=platform%2Fupstream%2Flibxkbcommon.git

diff --git a/xkbcommon/xkbcommon.h b/xkbcommon/xkbcommon.h
index a6b0fa8..6d196aa 100644
--- a/xkbcommon/xkbcommon.h
+++ b/xkbcommon/xkbcommon.h
@@ -641,6 +641,10 @@ xkb_keymap_num_levels_for_key(struct xkb_keymap *keymap, xkb_keycode_t key,
 
 /**
  * Returns the number of LEDs in the given map.
+ * Note that LED indexes are not necessarily consecutive in the keymap.
+ * This means that some LEDs in the range between 0 and the return value
+ * might not be valid.  Given such an index, xkb_keymap_led_get_name()
+ * will return NULL, and xkb_state_led_index_is_active() will return -1.
  */
 xkb_led_index_t
 xkb_keymap_num_leds(struct xkb_keymap *keymap);