[json-glib] docs: Add missing annotations



commit cd0fee83bfde8ccdf4602094e9f14bcd749a12b0
Author: Emmanuele Bassi <ebassi gnome org>
Date:   Fri Mar 13 13:40:27 2015 +0000

    docs: Add missing annotations

 json-glib/json-serializable.c |   28 ++++++++++++++++++++++++++--
 1 files changed, 26 insertions(+), 2 deletions(-)
---
diff --git a/json-glib/json-serializable.c b/json-glib/json-serializable.c
index 08327a9..471225e 100644
--- a/json-glib/json-serializable.c
+++ b/json-glib/json-serializable.c
@@ -273,7 +273,8 @@ json_serializable_default_deserialize_property (JsonSerializable *serializable,
  * @serializable: a #JsonSerializable
  * @name: the name of the property
  *
- * FIXME
+ * Calls the #JsonSerializableIface.find_property() implementation on
+ * the @serializable instance. *
  *
  * Return value: (transfer none): the #GParamSpec for the property
  *   or %NULL if no property was found
@@ -296,7 +297,8 @@ json_serializable_find_property (JsonSerializable *serializable,
  * @n_pspecs: (out): return location for the length of the array
  *   of #GParamSpec returned by the function
  *
- * FIXME
+ * Calls the #JsonSerializableIface.list_properties() implementation on
+ * the @serializable instance.
  *
  * Return value: (array length=n_pspecs) (transfer container): an array
  *   of #GParamSpec. Use g_free() to free the array when done.
@@ -312,6 +314,17 @@ json_serializable_list_properties (JsonSerializable *serializable,
   return JSON_SERIALIZABLE_GET_IFACE (serializable)->list_properties (serializable, n_pspecs);
 }
 
+/**
+ * json_serializable_set_property:
+ * @serializable: a #JsonSerializable
+ * @pspec: a #GParamSpec
+ * @value: the property value to set
+ *
+ * Calls the #JsonSerializableIface.set_property() implementation
+ * on the @serializable instance.
+ *
+ * Since: 0.14
+ */
 void
 json_serializable_set_property (JsonSerializable *serializable,
                                 GParamSpec       *pspec,
@@ -326,6 +339,17 @@ json_serializable_set_property (JsonSerializable *serializable,
                                                             value);
 }
 
+/**
+ * json_serializable_get_property:
+ * @serializable: a #JsonSerializable
+ * @pspec: a #GParamSpec
+ * @value: (out): return location for the property value
+ *
+ * Calls the #JsonSerializableIface.get_property() implementation
+ * on the @serializable instance.
+ *
+ * Since: 0.14
+ */
 void
 json_serializable_get_property (JsonSerializable *serializable,
                                 GParamSpec       *pspec,


[Date Prev][Date Next]   [Thread Prev][Thread Next]   [Thread Index] [Date Index] [Author Index]