summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorAleksander Morgado <aleksander@aleksander.es>2018-08-28 10:50:18 +0200
committerAleksander Morgado <aleksander@aleksander.es>2018-08-28 10:50:44 +0200
commit8e98922880b54c2bad8e515be18cbc94c4544dc3 (patch)
tree996ecbe913d834ad41c6be65c29dde8c3cfc2e69
parentc49f60db029624095b9b3d4f43399866211a5399 (diff)
downloadModemManager-8e98922880b54c2bad8e515be18cbc94c4544dc3.tar.gz
libmm-glib,pco: add some more missing documentation for MMPco
-rw-r--r--libmm-glib/mm-pco.c18
1 files changed, 14 insertions, 4 deletions
diff --git a/libmm-glib/mm-pco.c b/libmm-glib/mm-pco.c
index 0afa1b4bc..4804541e0 100644
--- a/libmm-glib/mm-pco.c
+++ b/libmm-glib/mm-pco.c
@@ -158,6 +158,16 @@ mm_pco_set_data (MMPco *self,
/*****************************************************************************/
+/**
+ * mm_pco_from_variant:
+ * @variant: A variant with the PCO information.
+ * @error: Return location for error or %NULL.
+ *
+ * Creates a new #MMPco object with the values exposed in
+ * the variant.
+ *
+ * Returns: (transfer full): A #MMPco or %NULL if @error is set. The returned value should be freed with g_object_unref().
+ */
MMPco *
mm_pco_from_variant (GVariant *variant,
GError **error)
@@ -234,7 +244,7 @@ mm_pco_to_variant (MMPco *self)
/**
* mm_pco_list_free:
- * @pco_list (element-type ModemManager.Pco): a #GList of #MMPco.
+ * @pco_list: (transfer full)(element-type ModemManager.Pco): a #GList of #MMPco.
*
* Frees all of the memory used by a #GList of #MMPco.
*/
@@ -246,14 +256,14 @@ mm_pco_list_free (GList *pco_list)
/**
* mm_pco_list_add:
- * @pco_list (element-type ModemManager.Pco): a #GList of #MMPco.
- * @pco:: a #MMPco to add to the given list.
+ * @pco_list: (transfer full)(element-type ModemManager.Pco): a #GList of #MMPco.
+ * @pco: (transfer none): a #MMPco to add to the given list.
*
* Adds a #MMPco to a given PCO list. #MMPco objects stored in the order of
* their session ID. An existing PCO with the same session ID is overwritten
* with the new value.
*
- * Returns: (element-type ModemManager.Pco): the new start of an updated or newly allocated #GList of #MMPco.
+ * Returns: (transfer full)(element-type ModemManager.Pco): the new start of an updated or newly allocated #GList of #MMPco.
*/
GList *
mm_pco_list_add (GList *pco_list,