diff options
Diffstat (limited to 'libmm-glib/mm-firmware-properties.c')
| -rw-r--r-- | libmm-glib/mm-firmware-properties.c | 70 |
1 files changed, 33 insertions, 37 deletions
diff --git a/libmm-glib/mm-firmware-properties.c b/libmm-glib/mm-firmware-properties.c index b9d95721..d8bbfaaf 100644 --- a/libmm-glib/mm-firmware-properties.c +++ b/libmm-glib/mm-firmware-properties.c @@ -31,7 +31,7 @@ * or mm_modem_firmware_list_sync(). */ -G_DEFINE_TYPE (MMFirmwareProperties, mm_firmware_properties, G_TYPE_OBJECT); +G_DEFINE_TYPE (MMFirmwareProperties, mm_firmware_properties, G_TYPE_OBJECT) #define PROPERTY_UNIQUE_ID "unique-id" #define PROPERTY_IMAGE_TYPE "image-type" @@ -64,7 +64,10 @@ static MMFirmwareProperties *firmware_properties_new_empty (void); * * Gets the unique ID of the firmare image. * - * Returns: (transfer none): The ID of the image. Do not free the returned value, it is owned by @self. + * Returns: (transfer none): The ID of the image. Do not free the returned + * value, it is owned by @self. + * + * Since: 1.0 */ const gchar * mm_firmware_properties_get_unique_id (MMFirmwareProperties *self) @@ -83,6 +86,8 @@ mm_firmware_properties_get_unique_id (MMFirmwareProperties *self) * Gets the type of the firmare image. * * Returns: A #MMFirmwareImageType specifying The type of the image. + * + * Since: 1.0 */ MMFirmwareImageType mm_firmware_properties_get_image_type (MMFirmwareProperties *self) @@ -100,7 +105,10 @@ mm_firmware_properties_get_image_type (MMFirmwareProperties *self) * * Gets the PRI version of a firmware image of type %MM_FIRMWARE_IMAGE_TYPE_GOBI. * - * Returns: The PRI version, or %NULL if unknown. Do not free the returned value, it is owned by @self. + * Returns: The PRI version, or %NULL if unknown. Do not free the returned value, + * it is owned by @self. + * + * Since: 1.0 */ const gchar * mm_firmware_properties_get_gobi_pri_version (MMFirmwareProperties *self) @@ -130,7 +138,10 @@ mm_firmware_properties_set_gobi_pri_version (MMFirmwareProperties *self, * * Gets the PRI info of a firmware image of type %MM_FIRMWARE_IMAGE_TYPE_GOBI. * - * Returns: The PRI info, or %NULL if unknown. Do not free the returned value, it is owned by @self. + * Returns: The PRI info, or %NULL if unknown. Do not free the returned value, + * it is owned by @self. + * + * Since: 1.0 */ const gchar * mm_firmware_properties_get_gobi_pri_info (MMFirmwareProperties *self) @@ -156,9 +167,13 @@ mm_firmware_properties_set_gobi_pri_info (MMFirmwareProperties *self, * mm_firmware_properties_get_gobi_boot_version: * @self: a #MMFirmwareProperties. * - * Gets the boot version of a firmware image of type %MM_FIRMWARE_IMAGE_TYPE_GOBI. + * Gets the boot version of a firmware image of type + * %MM_FIRMWARE_IMAGE_TYPE_GOBI. + * + * Returns: The boot version, or %NULL if unknown. Do not free the returned + * value, it is owned by @self. * - * Returns: The boot version, or %NULL if unknown. Do not free the returned value, it is owned by @self. + * Since: 1.0 */ const gchar * mm_firmware_properties_get_gobi_boot_version (MMFirmwareProperties *self) @@ -186,9 +201,13 @@ mm_firmware_properties_set_gobi_boot_version (MMFirmwareProperties *self, * mm_firmware_properties_get_gobi_pri_unique_id: * @self: a #MMFirmwareProperties. * - * Gets the PRI unique ID of a firmware image of type %MM_FIRMWARE_IMAGE_TYPE_GOBI. + * Gets the PRI unique ID of a firmware image of type + * %MM_FIRMWARE_IMAGE_TYPE_GOBI. * - * Returns: The PRI unique ID, or %NULL if unknown. Do not free the returned value, it is owned by @self. + * Returns: The PRI unique ID, or %NULL if unknown. Do not free the returned + * value, it is owned by @self. + * + * Since: 1.0 */ const gchar * mm_firmware_properties_get_gobi_pri_unique_id (MMFirmwareProperties *self) @@ -216,9 +235,13 @@ mm_firmware_properties_set_gobi_pri_unique_id (MMFirmwareProperties *self, * mm_firmware_properties_get_gobi_modem_unique_id: * @self: a #MMFirmwareProperties. * - * Gets the MODEM unique ID of a firmware image of type %MM_FIRMWARE_IMAGE_TYPE_GOBI. + * Gets the MODEM unique ID of a firmware image of type + * %MM_FIRMWARE_IMAGE_TYPE_GOBI. + * + * Returns: The PRI unique ID, or %NULL if unknown. Do not free the returned + * value, it is owned by @self. * - * Returns: The PRI unique ID, or %NULL if unknown. Do not free the returned value, it is owned by @self. + * Since: 1.0 */ const gchar * mm_firmware_properties_get_gobi_modem_unique_id (MMFirmwareProperties *self) @@ -242,14 +265,6 @@ mm_firmware_properties_set_gobi_modem_unique_id (MMFirmwareProperties *self, /*****************************************************************************/ -/** - * mm_firmware_properties_get_dictionary: - * @self: A #MMFirmwareProperties. - * - * Gets a variant dictionary with the contents of @self. - * - * Returns: (transfer full): A dictionary with the image properties. The returned value should be freed with g_variant_unref(). - */ GVariant * mm_firmware_properties_get_dictionary (MMFirmwareProperties *self) { @@ -346,16 +361,6 @@ consume_variant (MMFirmwareProperties *self, return TRUE; } -/** - * mm_firmware_properties_new_from_dictionary: - * @dictionary: A variant dictionary with the properties of the image. - * @error: Return location for error or %NULL. - * - * Creates a new #MMFirmwareProperties object with the properties exposed in - * the dictionary. - * - * Returns: (transfer full): A #MMFirmwareProperties or %NULL if @error is set. The returned value should be freed with g_object_unref(). - */ MMFirmwareProperties * mm_firmware_properties_new_from_dictionary (GVariant *dictionary, GError **error) @@ -420,15 +425,6 @@ mm_firmware_properties_new_from_dictionary (GVariant *dictionary, /*****************************************************************************/ -/** - * mm_firmware_properties_new: - * @image_type: A #MMFirmwareImageType specifying the type of the image. - * @unique_id: The unique ID of the image. - * - * Creates a new #MMFirmwareProperties object with the properties specified. - * - * Returns: (transfer full): A #MMFirmwareProperties or %NULL if @error is set. The returned value should be freed with g_object_unref(). - */ MMFirmwareProperties * mm_firmware_properties_new (MMFirmwareImageType image_type, const gchar *unique_id) |