From 8e98922880b54c2bad8e515be18cbc94c4544dc3 Mon Sep 17 00:00:00 2001 From: Aleksander Morgado Date: Tue, 28 Aug 2018 10:50:18 +0200 Subject: [PATCH] libmm-glib,pco: add some more missing documentation for MMPco --- libmm-glib/mm-pco.c | 18 ++++++++++++++---- 1 file changed, 14 insertions(+), 4 deletions(-) diff --git a/libmm-glib/mm-pco.c b/libmm-glib/mm-pco.c index 0afa1b4b..4804541e 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,