diff options
author | Ben Chan <benchan@chromium.org> | 2018-08-27 12:55:24 -0700 |
---|---|---|
committer | Aleksander Morgado <aleksander@aleksander.es> | 2018-08-28 10:50:39 +0200 |
commit | c49f60db029624095b9b3d4f43399866211a5399 (patch) | |
tree | ca3e2c2f19af82fcbe61cb90a2d31b86f219ce60 | |
parent | 28c1acf2e134a395dfda28860db37e4bf9650e16 (diff) | |
download | ModemManager-c49f60db029624095b9b3d4f43399866211a5399.tar.gz |
libmm-glib,pco: add missing documentation for MMPco
-rw-r--r-- | libmm-glib/mm-modem-3gpp.c | 2 | ||||
-rw-r--r-- | libmm-glib/mm-pco.c | 25 |
2 files changed, 26 insertions, 1 deletions
diff --git a/libmm-glib/mm-modem-3gpp.c b/libmm-glib/mm-modem-3gpp.c index 360aaef60..80746f983 100644 --- a/libmm-glib/mm-modem-3gpp.c +++ b/libmm-glib/mm-modem-3gpp.c @@ -308,7 +308,7 @@ mm_modem_3gpp_get_eps_ue_mode_operation (MMModem3gpp *self) * The caller is responsible for freeing the returned #GList with * mm_pco_list_free(). * - * Returns: (transfer full): A list of #MMPco. + * Returns: (element-type ModemManager.Pco) (transfer full): A list of #MMPco. */ GList * mm_modem_3gpp_get_pco (MMModem3gpp *self) diff --git a/libmm-glib/mm-pco.c b/libmm-glib/mm-pco.c index 7ee347b02..0afa1b4bc 100644 --- a/libmm-glib/mm-pco.c +++ b/libmm-glib/mm-pco.c @@ -193,6 +193,14 @@ mm_pco_from_variant (GVariant *variant, /*****************************************************************************/ +/** + * mm_pco_to_variant: + * @self: a #MMPco. + * + * Gets a GVariant representation with signature "(ubay)" of @self. + * + * Returns: (transfer full): A #GVariant representation of the #MMPco object. The returned value should be freed with g_variant_unref(). + */ GVariant * mm_pco_to_variant (MMPco *self) { @@ -224,12 +232,29 @@ mm_pco_to_variant (MMPco *self) /*****************************************************************************/ +/** + * mm_pco_list_free: + * @pco_list (element-type ModemManager.Pco): a #GList of #MMPco. + * + * Frees all of the memory used by a #GList of #MMPco. + */ void mm_pco_list_free (GList *pco_list) { g_list_free_full (pco_list, g_object_unref); } +/** + * mm_pco_list_add: + * @pco_list (element-type ModemManager.Pco): a #GList of #MMPco. + * @pco:: 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. + */ GList * mm_pco_list_add (GList *pco_list, MMPco *pco) |