Commit 471e112208e9d828f90c37cfa9608fd1aa20fcb3

Daniel Stone 2012-05-09T20:52:33

Document that xkb_state_get_map doesn't take a ref Signed-off-by: Daniel Stone <daniel@fooishbar.org>

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
diff --git a/include/xkbcommon/xkbcommon.h b/include/xkbcommon/xkbcommon.h
index 541b571..ce226f7 100644
--- a/include/xkbcommon/xkbcommon.h
+++ b/include/xkbcommon/xkbcommon.h
@@ -390,7 +390,9 @@ void
 xkb_state_unref(struct xkb_state *state);
 
 /**
- * Get the keymap from which the state object was created.
+ * Get the keymap from which the state object was created.  Does not take
+ * a new reference on the map; you must explicitly reference it yourself
+ * if you plan to use it beyond the lifetime of the state.
  */
 struct xkb_keymap *
 xkb_state_get_map(struct xkb_state *state);