doc: add @since annotations for API added since 0.3.0

And also add release dates to the NEWS.

We're adding API freely, so this can make life easier for anyone who
wants to stay compatible with an older version.

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

diff --git a/NEWS b/NEWS
index 07ebdd9..0f230f1 100644 (file)
--- a/NEWS
+++ b/NEWS
@@ -1,4 +1,4 @@
-libxkbcommon 0.4.1
+libxkbcommon 0.4.1 - 2014-03-27
 ==================
 
 - Converted README to markdown and added a Quick Guide to the
@@ -41,7 +41,7 @@ libxkbcommon 0.4.1
 
 - Bug fixes.
 
-libxkbcommon 0.4.0
+libxkbcommon 0.4.0 - 2014-02-02
 ==================
 
 - Add a new add-on library, xkbcommon-x11, to support creating keymaps
@@ -68,7 +68,7 @@ libxkbcommon 0.4.0
   xkb_x11_* types and functions, XKB_X11_* constants.
 
 
-libxkbcommon 0.3.2
+libxkbcommon 0.3.2 - 2013-11-22
 ==================
 
 - Log messages from the library now look like "xkbcommon: ERROR" by
@@ -90,7 +90,7 @@ libxkbcommon 0.3.2
 - Bug fixes.
 
 
-libxkbcommon 0.3.1
+libxkbcommon 0.3.1 - 2013-06-03
 ==================
 
 - Replace the flex scanner with a hand-written one. flex is no longer
@@ -102,7 +102,7 @@ libxkbcommon 0.3.1
   xkb_keymap_key_for_each()
 
 
-libxkbcommon 0.3.0
+libxkbcommon 0.3.0 - 2013-04-01
 ==================
 
 - Allow passing NULL to *_unref() functions; do nothing instead of

diff --git a/xkbcommon/xkbcommon-x11.h b/xkbcommon/xkbcommon-x11.h
index d9e2a4f..e1c41ee 100644 (file)
--- a/xkbcommon/xkbcommon-x11.h
+++ b/xkbcommon/xkbcommon-x11.h
@@ -39,6 +39,7 @@ extern "C" {
 /**
  * @defgroup x11 X11 support
  * Additional X11 support for xkbcommon.
+ * @since 0.4.0
  *
  * @{
  */

diff --git a/xkbcommon/xkbcommon.h b/xkbcommon/xkbcommon.h
index 36251db..2cc4e60 100644 (file)
--- a/xkbcommon/xkbcommon.h
+++ b/xkbcommon/xkbcommon.h
@@ -475,8 +475,11 @@ enum xkb_context_flags {
     XKB_CONTEXT_NO_FLAGS = 0,
     /** Create this context with an empty include path. */
     XKB_CONTEXT_NO_DEFAULT_INCLUDES = (1 << 0),
-    /** Don't take RMLVO names from the environment. */
-    XKB_CONTEXT_NO_ENVIRONMENT_NAMES = (1 << 1),
+    /**
+     * Don't take RMLVO names from the environment.
+     * @since 0.3.0
+     */
+    XKB_CONTEXT_NO_ENVIRONMENT_NAMES = (1 << 1)
 };
 
 /**
@@ -800,6 +803,7 @@ xkb_keymap_new_from_string(struct xkb_context *context, const char *string,
  *
  * @see xkb_keymap_new_from_string()
  * @memberof xkb_keymap
+ * @since 0.3.0
  */
 struct xkb_keymap *
 xkb_keymap_new_from_buffer(struct xkb_context *context, const char *buffer,
@@ -868,6 +872,7 @@ xkb_keymap_get_as_string(struct xkb_keymap *keymap,
  *
  * @sa xkb_keycode_t
  * @memberof xkb_keymap
+ * @since 0.3.1
  */
 xkb_keycode_t
 xkb_keymap_min_keycode(struct xkb_keymap *keymap);
@@ -877,6 +882,7 @@ xkb_keymap_min_keycode(struct xkb_keymap *keymap);
  *
  * @sa xkb_keycode_t
  * @memberof xkb_keymap
+ * @since 0.3.1
  */
 xkb_keycode_t
 xkb_keymap_max_keycode(struct xkb_keymap *keymap);
@@ -886,6 +892,7 @@ xkb_keymap_max_keycode(struct xkb_keymap *keymap);
  *
  * @sa xkb_keymap_key_for_each
  * @memberof xkb_keymap
+ * @since 0.3.1
  */
 typedef void
 (*xkb_keymap_key_iter_t)(struct xkb_keymap *keymap, xkb_keycode_t key,
@@ -898,6 +905,7 @@ typedef void
  *
  * @sa xkb_keymap_min_keycode() xkb_keymap_max_keycode() xkb_keycode_t
  * @memberof xkb_keymap
+ * @since 0.3.1
  */
 void
 xkb_keymap_key_for_each(struct xkb_keymap *keymap, xkb_keymap_key_iter_t iter,
@@ -1299,6 +1307,7 @@ xkb_state_key_get_syms(struct xkb_state *state, xkb_keycode_t key,
  * required size (without the NUL-byte).
  *
  * @memberof xkb_state
+ * @since 0.4.1
  */
 int
 xkb_state_key_get_utf8(struct xkb_state *state, xkb_keycode_t key,
@@ -1312,6 +1321,7 @@ xkb_state_key_get_utf8(struct xkb_state *state, xkb_keycode_t key,
  * a single codepoint.  Otherwise, returns 0.
  *
  * @memberof xkb_state
+ * @since 0.4.1
  */
 uint32_t
 xkb_state_key_get_utf32(struct xkb_state *state, xkb_keycode_t key);
@@ -1594,6 +1604,7 @@ xkb_state_mod_mask_remove_consumed(struct xkb_state *state, xkb_keycode_t key,
  *
  * @sa xkb_state_mod_index_is_consumed()
  * @memberof xkb_state
+ * @since 0.4.1
  */
 xkb_mod_mask_t
 xkb_state_key_get_consumed_mods(struct xkb_state *state, xkb_keycode_t key);