aboutsummaryrefslogtreecommitdiff
path: root/libmm-glib/mm-modem-3gpp.c
diff options
context:
space:
mode:
authorAleksander Morgado <aleksander@aleksander.es>2019-10-24 22:58:42 +0200
committerAleksander Morgado <aleksander@aleksander.es>2019-10-28 10:28:31 +0100
commit08d23dd64d4566423579d8fbe609ec6145eae861 (patch)
treea89c7e51adba9ea1670a0d35b28e9aa138fda831 /libmm-glib/mm-modem-3gpp.c
parent53a7dc2f63ac26edb1a3a8db8368b52cf0417de7 (diff)
docs,libmm-glib: provide per-version indices
Diffstat (limited to 'libmm-glib/mm-modem-3gpp.c')
-rw-r--r--libmm-glib/mm-modem-3gpp.c258
1 files changed, 191 insertions, 67 deletions
diff --git a/libmm-glib/mm-modem-3gpp.c b/libmm-glib/mm-modem-3gpp.c
index 8f1c0252..f8e6787a 100644
--- a/libmm-glib/mm-modem-3gpp.c
+++ b/libmm-glib/mm-modem-3gpp.c
@@ -59,6 +59,8 @@ struct _MMModem3gppPrivate {
* Gets the DBus path of the #MMObject which implements this interface.
*
* Returns: (transfer none): The DBus path of the #MMObject object.
+ *
+ * Since: 1.0
*/
const gchar *
mm_modem_3gpp_get_path (MMModem3gpp *self)
@@ -73,9 +75,13 @@ mm_modem_3gpp_get_path (MMModem3gpp *self)
* mm_modem_3gpp_dup_path:
* @self: A #MMModem3gpp.
*
- * Gets a copy of the DBus path of the #MMObject object which implements this interface.
+ * Gets a copy of the DBus path of the #MMObject object which implements this
+ * interface.
+ *
+ * Returns: (transfer full): The DBus path of the #MMObject. The returned value
+ * should be freed with g_free().
*
- * Returns: (transfer full): The DBus path of the #MMObject. The returned value should be freed with g_free().
+ * Since: 1.0
*/
gchar *
mm_modem_3gpp_dup_path (MMModem3gpp *self)
@@ -105,6 +111,8 @@ mm_modem_3gpp_dup_path (MMModem3gpp *self)
* thread.</warning>
*
* Returns: (transfer none): The IMEI, or %NULL if none available.
+ *
+ * Since: 1.0
*/
const gchar *
mm_modem_3gpp_get_imei (MMModem3gpp *self)
@@ -122,7 +130,10 @@ mm_modem_3gpp_get_imei (MMModem3gpp *self)
* Gets a copy of the <ulink url="http://en.wikipedia.org/wiki/Imei">IMEI</ulink>,
* as reported by this #MMModem3gpp.
*
- * Returns: (transfer full): The IMEI, or %NULL if none available. The returned value should be freed with g_free().
+ * Returns: (transfer full): The IMEI, or %NULL if none available. The returned
+ * value should be freed with g_free().
+ *
+ * Since: 1.0
*/
gchar *
mm_modem_3gpp_dup_imei (MMModem3gpp *self)
@@ -139,8 +150,7 @@ mm_modem_3gpp_dup_imei (MMModem3gpp *self)
* mm_modem_3gpp_get_operator_code:
* @self: A #MMModem3gpp.
*
- * Gets the code of the operator to which the mobile is
- * currently registered.
+ * Gets the code of the operator to which the mobile is currently registered.
*
* Returned in the format <literal>"MCCMNC"</literal>, where
* <literal>MCC</literal> is the three-digit ITU E.212 Mobile Country Code
@@ -157,6 +167,8 @@ mm_modem_3gpp_dup_imei (MMModem3gpp *self)
* thread.</warning>
*
* Returns: (transfer none): The operator code, or %NULL if none available.
+ *
+ * Since: 1.0
*/
const gchar *
mm_modem_3gpp_get_operator_code (MMModem3gpp *self)
@@ -171,15 +183,18 @@ mm_modem_3gpp_get_operator_code (MMModem3gpp *self)
* mm_modem_3gpp_dup_operator_code:
* @self: A #MMModem3gpp.
*
- * Gets a copy of the code of the operator to which the mobile is
- * currently registered.
+ * Gets a copy of the code of the operator to which the mobile is currently
+ * registered.
*
* Returned in the format <literal>"MCCMNC"</literal>, where
* <literal>MCC</literal> is the three-digit ITU E.212 Mobile Country Code
* and <literal>MNC</literal> is the two- or three-digit GSM Mobile Network
* Code. e.g. e<literal>"31026"</literal> or <literal>"310260"</literal>.
*
- * Returns: (transfer full): The operator code, or %NULL if none available. The returned value should be freed with g_free().
+ * Returns: (transfer full): The operator code, or %NULL if none available.
+ * The returned value should be freed with g_free().
+ *
+ * Since: 1.0
*/
gchar *
mm_modem_3gpp_dup_operator_code (MMModem3gpp *self)
@@ -205,6 +220,8 @@ mm_modem_3gpp_dup_operator_code (MMModem3gpp *self)
* thread.</warning>
*
* Returns: (transfer none): The operator name, or %NULL if none available.
+ *
+ * Since: 1.0
*/
const gchar *
mm_modem_3gpp_get_operator_name (MMModem3gpp *self)
@@ -222,7 +239,10 @@ mm_modem_3gpp_get_operator_name (MMModem3gpp *self)
* Gets a copy of the name of the operator to which the mobile is
* currently registered.
*
- * Returns: (transfer full): The operator name, or %NULL if none available. The returned value should be freed with g_free().
+ * Returns: (transfer full): The operator name, or %NULL if none available.
+ * The returned value should be freed with g_free().
+ *
+ * Since: 1.0
*/
gchar *
mm_modem_3gpp_dup_operator_name (MMModem3gpp *self)
@@ -242,7 +262,10 @@ mm_modem_3gpp_dup_operator_name (MMModem3gpp *self)
* Get the the mobile registration status as defined in 3GPP TS 27.007
* section 10.1.19.
*
- * Returns: A #MMModem3gppRegistrationState value, specifying the current registration state.
+ * Returns: A #MMModem3gppRegistrationState value, specifying the current
+ * registration state.
+ *
+ * Since: 1.0
*/
MMModem3gppRegistrationState
mm_modem_3gpp_get_registration_state (MMModem3gpp *self)
@@ -263,15 +286,17 @@ mm_modem_3gpp_get_registration_state (MMModem3gpp *self)
* Get the current subscription status of the account. This value is only
* available after the modem attempts to register with the network.
*
- * The value of this property can only be obtained with operator specific logic (e.g.
- * processing specific PCO info), and therefore it doesn't make sense to expose it in
- * the ModemManager interface.
+ * The value of this property can only be obtained with operator specific logic
+ * (e.g. processing specific PCO info), and therefore it doesn't make sense to
+ * expose it in the ModemManager interface.
*
- * Returns: A #MMModem3gppSubscriptionState value, specifying the current subscription state.
+ * Returns: A #MMModem3gppSubscriptionState value, specifying the current
+ * subscription state.
*
- * Deprecated: 1.10.0. The value of this property can only be obtained with operator
- * specific logic (e.g. processing specific PCO info), and therefore it doesn't make sense
- * to expose it in the ModemManager interface.
+ * Since: 1.0
+ * Deprecated: 1.10.0. The value of this property can only be obtained with
+ * operator specific logic (e.g. processing specific PCO info), and therefore
+ * it doesn't make sense to expose it in the ModemManager interface.
*/
MMModem3gppSubscriptionState
mm_modem_3gpp_get_subscription_state (MMModem3gpp *self)
@@ -289,7 +314,10 @@ mm_modem_3gpp_get_subscription_state (MMModem3gpp *self)
*
* Get the list of facilities for which PIN locking is enabled.
*
- * Returns: A bitmask of #MMModem3gppFacility flags, specifying which facilities have locks enabled.
+ * Returns: A bitmask of #MMModem3gppFacility flags, specifying which facilities
+ * have locks enabled.
+ *
+ * Since: 1.0
*/
MMModem3gppFacility
mm_modem_3gpp_get_enabled_facility_locks (MMModem3gpp *self)
@@ -306,6 +334,8 @@ mm_modem_3gpp_get_enabled_facility_locks (MMModem3gpp *self)
* Get the UE mode of operation for EPS.
*
* Returns: A #MMModem3gppEpsUeModeOperation.
+ *
+ * Since: 1.8
*/
MMModem3gppEpsUeModeOperation
mm_modem_3gpp_get_eps_ue_mode_operation (MMModem3gpp *self)
@@ -327,6 +357,8 @@ mm_modem_3gpp_get_eps_ue_mode_operation (MMModem3gpp *self)
* mm_pco_list_free().
*
* Returns: (element-type ModemManager.Pco) (transfer full): A list of #MMPco.
+ *
+ * Since: 1.10
*/
GList *
mm_modem_3gpp_get_pco (MMModem3gpp *self)
@@ -364,10 +396,13 @@ mm_modem_3gpp_get_pco (MMModem3gpp *self)
*
* <warning>The returned value is only valid until the property changes so
* it is only safe to use this function on the thread where
- * @self was constructed. Use mm_modem_3gpp_dup_initial_eps_bearer_path() if on another
- * thread.</warning>
+ * @self was constructed. Use mm_modem_3gpp_dup_initial_eps_bearer_path() if on
+ * another thread.</warning>
+ *
+ * Returns: (transfer none): The DBus path of the #MMBearer, or %NULL if none
+ * available. Do not free the returned value, it belongs to @self.
*
- * Returns: (transfer none): The DBus path of the #MMBearer, or %NULL if none available. Do not free the returned value, it belongs to @self.
+ * Since: 1.10
*/
const gchar *
mm_modem_3gpp_get_initial_eps_bearer_path (MMModem3gpp *self)
@@ -381,9 +416,13 @@ mm_modem_3gpp_get_initial_eps_bearer_path (MMModem3gpp *self)
* mm_modem_3gpp_dup_initial_eps_bearer_path:
* @self: A #MMModem3gpp.
*
- * Gets a copy of the DBus path of the initial EPS #MMBearer exposed in this #MMModem3gpp.
+ * Gets a copy of the DBus path of the initial EPS #MMBearer exposed in this
+ * #MMModem3gpp.
*
- * Returns: (transfer full): The DBus path of the #MMBearer, or %NULL if none available. The returned value should be freed with g_free().
+ * Returns: (transfer full): The DBus path of the #MMBearer, or %NULL if none
+ * available. The returned value should be freed with g_free().
+ *
+ * Since: 1.10
*/
gchar *
mm_modem_3gpp_dup_initial_eps_bearer_path (MMModem3gpp *self)
@@ -399,12 +438,15 @@ mm_modem_3gpp_dup_initial_eps_bearer_path (MMModem3gpp *self)
/**
* mm_modem_3gpp_register_finish:
* @self: A #MMModem3gpp.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_3gpp_register().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_3gpp_register().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_3gpp_register().
*
* Returns: %TRUE if the modem was registered, %FALSE if @error is set.
+ *
+ * Since: 1.0
*/
gboolean
mm_modem_3gpp_register_finish (MMModem3gpp *self,
@@ -419,17 +461,24 @@ mm_modem_3gpp_register_finish (MMModem3gpp *self,
/**
* mm_modem_3gpp_register:
* @self: A #MMModem3gpp.
- * @network_id: The operator ID to register. An empty string can be used to register to the home network.
+ * @network_id: The operator ID to register. An empty string can be used to
+ * register to the home network.
* @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+ * @callback: A #GAsyncReadyCallback to call when the request is satisfied or
+ * %NULL.
* @user_data: User data to pass to @callback.
*
* Asynchronously requests registration with a given mobile network.
*
- * When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
- * You can then call mm_modem_3gpp_register_finish() to get the result of the operation.
+ * When the operation is finished, @callback will be invoked in the
+ * <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+ * of the thread you are calling this method from. You can then call
+ * mm_modem_3gpp_register_finish() to get the result of the operation.
*
- * See mm_modem_3gpp_register_sync() for the synchronous, blocking version of this method.
+ * See mm_modem_3gpp_register_sync() for the synchronous, blocking version of
+ * this method.
+ *
+ * Since: 1.0
*/
void
mm_modem_3gpp_register (MMModem3gpp *self,
@@ -446,16 +495,19 @@ mm_modem_3gpp_register (MMModem3gpp *self,
/**
* mm_modem_3gpp_register_sync:
* @self: A #MMModem3gpp.
- * @network_id: The operator ID to register. An empty string can be used to register to the home network.
+ * @network_id: The operator ID to register. An empty string can be used to
+ * register to the home network.
* @cancellable: (allow-none): A #GCancellable or %NULL.
* @error: Return location for error or %NULL.
*
* Synchronously requests registration with a given mobile network.
*
- * The calling thread is blocked until a reply is received. See mm_modem_3gpp_register()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_3gpp_register() for the asynchronous version of this method.
*
* Returns: %TRUE if the modem was registered, %FALSE if @error is set.
+ *
+ * Since: 1.0
*/
gboolean
mm_modem_3gpp_register_sync (MMModem3gpp *self,
@@ -483,6 +535,8 @@ struct _MMModem3gppNetwork {
* @network: A #MMModem3gppNetwork.
*
* Frees a #MMModem3gppNetwork.
+ *
+ * Since: 1.0
*/
void
mm_modem_3gpp_network_free (MMModem3gppNetwork *network)
@@ -503,6 +557,8 @@ mm_modem_3gpp_network_free (MMModem3gppNetwork *network)
* Get availability of the 3GPP network.
*
* Returns: A #MMModem3gppNetworkAvailability.
+ *
+ * Since: 1.0
*/
MMModem3gppNetworkAvailability
mm_modem_3gpp_network_get_availability (const MMModem3gppNetwork *network)
@@ -519,6 +575,8 @@ mm_modem_3gpp_network_get_availability (const MMModem3gppNetwork *network)
* Get the long operator name of the 3GPP network.
*
* Returns: (transfer none): The long operator name, or %NULL if none available.
+ *
+ * Since: 1.0
*/
const gchar *
mm_modem_3gpp_network_get_operator_long (const MMModem3gppNetwork *network)
@@ -535,6 +593,8 @@ mm_modem_3gpp_network_get_operator_long (const MMModem3gppNetwork *network)
* Get the short operator name of the 3GPP network.
*
* Returns: (transfer none): The long operator name, or %NULL if none available.
+ *
+ * Since: 1.0
*/
const gchar *
mm_modem_3gpp_network_get_operator_short (const MMModem3gppNetwork *network)
@@ -551,6 +611,8 @@ mm_modem_3gpp_network_get_operator_short (const MMModem3gppNetwork *network)
* Get the operator code (MCCMNC) of the 3GPP network.
*
* Returns: (transfer none): The operator code, or %NULL if none available.
+ *
+ * Since: 1.0
*/
const gchar *
mm_modem_3gpp_network_get_operator_code (const MMModem3gppNetwork *network)
@@ -567,6 +629,8 @@ mm_modem_3gpp_network_get_operator_code (const MMModem3gppNetwork *network)
* Get the technology used to access the 3GPP network.
*
* Returns: A #MMModemAccessTechnology.
+ *
+ * Since: 1.0
*/
MMModemAccessTechnology
mm_modem_3gpp_network_get_access_technology (const MMModem3gppNetwork *network)
@@ -648,10 +712,13 @@ ensure_internal_initial_eps_bearer_settings (MMModem3gpp *self,
*
* <warning>The values reported by @self are not updated when the values in the
* interface change. Instead, the client is expected to call
- * mm_modem_3gpp_get_initial_eps_bearer_settings() again to get a new #MMBearerProperties with the
- * new values.</warning>
+ * mm_modem_3gpp_get_initial_eps_bearer_settings() again to get a new
+ * #MMBearerProperties with the new values.</warning>
+ *
+ * Returns: (transfer full): A #MMBearerProperties that must be freed with
+ * g_object_unref() or %NULL if unknown.
*
- * Returns: (transfer full): A #MMBearerProperties that must be freed with g_object_unref() or %NULL if unknown.
+ * Since: 1.10
*/
MMBearerProperties *
mm_modem_3gpp_get_initial_eps_bearer_settings (MMModem3gpp *self)
@@ -673,10 +740,13 @@ mm_modem_3gpp_get_initial_eps_bearer_settings (MMModem3gpp *self)
*
* <warning>The returned value is only valid until the property changes so
* it is only safe to use this function on the thread where
- * @self was constructed. Use mm_modem_3gpp_get_initial_eps_bearer_settings() if on another
- * thread.</warning>
+ * @self was constructed. Use mm_modem_3gpp_get_initial_eps_bearer_settings()
+ * if on another thread.</warning>
+ *
+ * Returns: (transfer none): A #MMBearerProperties. Do not free the returned
+ * value, it belongs to @self.
*
- * Returns: (transfer none): A #MMBearerProperties. Do not free the returned value, it belongs to @self.
+ * Since: 1.10
*/
MMBearerProperties *
mm_modem_3gpp_peek_initial_eps_bearer_settings (MMModem3gpp *self)
@@ -738,12 +808,18 @@ create_networks_list (GVariant *variant)
/**
* mm_modem_3gpp_scan_finish:
* @self: A #MMModem3gpp.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_3gpp_scan().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_3gpp_scan().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_3gpp_scan().
*
- * Returns: (transfer full) (element-type ModemManager.Modem3gppNetwork): a list of #MMModem3gppNetwork structs, or #NULL if @error is set. The returned value should be freed with g_list_free_full() using mm_modem_3gpp_network_free() as #GDestroyNotify function.
+ * Returns: (transfer full) (element-type ModemManager.Modem3gppNetwork): a list
+ * of #MMModem3gppNetwork structs, or #NULL if @error is set. The returned value
+ * should be freed with g_list_free_full() using mm_modem_3gpp_network_free() as
+ * #GDestroyNotify function.
+ *
+ * Since: 1.0
*/
GList *
mm_modem_3gpp_scan_finish (MMModem3gpp *self,
@@ -764,15 +840,21 @@ mm_modem_3gpp_scan_finish (MMModem3gpp *self,
* mm_modem_3gpp_scan:
* @self: A #MMModem3gpp.
* @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+ * @callback: A #GAsyncReadyCallback to call when the request is satisfied or
+ * %NULL.
* @user_data: User data to pass to @callback.
*
* Asynchronously requests to scan available 3GPP networks.
*
- * When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
- * You can then call mm_modem_3gpp_scan_finish() to get the result of the operation.
+ * When the operation is finished, @callback will be invoked in the
+ * <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+ * of the thread you are calling this method from. You can then call
+ * mm_modem_3gpp_scan_finish() to get the result of the operation.
+ *
+ * See mm_modem_3gpp_scan_sync() for the synchronous, blocking version of this
+ * method.
*
- * See mm_modem_3gpp_scan_sync() for the synchronous, blocking version of this method.
+ * Since: 1.0
*/
void
mm_modem_3gpp_scan (MMModem3gpp *self,
@@ -793,10 +875,15 @@ mm_modem_3gpp_scan (MMModem3gpp *self,
*
* Synchronously requests to scan available 3GPP networks.
*
- * The calling thread is blocked until a reply is received. See mm_modem_3gpp_scan()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_3gpp_scan() for the asynchronous version of this method.
+ *
+ * Returns: (transfer full) (element-type ModemManager.Modem3gppNetwork): a list
+ * of #MMModem3gppNetwork structs, or #NULL if @error is set. The returned value
+ * should be freed with g_list_free_full() using mm_modem_3gpp_network_free() as
+ * #GDestroyNotify function.
*
- * Returns: (transfer full) (element-type ModemManager.Modem3gppNetwork): a list of #MMModem3gppNetwork structs, or #NULL if @error is set. The returned value should be freed with g_list_free_full() using mm_modem_3gpp_network_free() as #GDestroyNotify function.
+ * Since: 1.0
*/
GList *
mm_modem_3gpp_scan_sync (MMModem3gpp *self,
@@ -818,12 +905,15 @@ mm_modem_3gpp_scan_sync (MMModem3gpp *self,
/**
* mm_modem_3gpp_set_eps_ue_mode_operation_finish:
* @self: A #MMModem3gpp.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_3gpp_set_eps_ue_mode_operation().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_3gpp_set_eps_ue_mode_operation().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_3gpp_set_eps_ue_mode_operation().
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
+ * Since: 1.8
*/
gboolean
mm_modem_3gpp_set_eps_ue_mode_operation_finish (MMModem3gpp *self,
@@ -840,7 +930,8 @@ mm_modem_3gpp_set_eps_ue_mode_operation_finish (MMModem3gpp *self,
* @self: A #MMModem3gpp.
* @mode: A #MMModem3gppEpsUeModeOperation.
* @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+ * @callback: A #GAsyncReadyCallback to call when the request is satisfied or
+ * %NULL.
* @user_data: User data to pass to @callback.
*
* Asynchronously requests to update the EPS UE mode of operation.
@@ -848,10 +939,14 @@ mm_modem_3gpp_set_eps_ue_mode_operation_finish (MMModem3gpp *self,
* When the operation is finished, @callback will be invoked in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
* of the thread you are calling this method from. You can then call
- * mm_modem_3gpp_set_eps_ue_mode_operation_finish() to get the result of the operation.
+ * mm_modem_3gpp_set_eps_ue_mode_operation_finish() to get the result of the
+ * operation.
*
- * See mm_modem_3gpp_set_eps_ue_mode_operation_sync() for the synchronous, blocking
- * version of this method. The calling thread is blocked until a reply is received.
+ * See mm_modem_3gpp_set_eps_ue_mode_operation_sync() for the synchronous,
+ * blocking version of this method. The calling thread is blocked until a reply
+ * is received.
+ *
+ * Since: 1.8
*/
void
mm_modem_3gpp_set_eps_ue_mode_operation (MMModem3gpp *self,
@@ -880,6 +975,8 @@ mm_modem_3gpp_set_eps_ue_mode_operation (MMModem3gpp *self,
* of this method.
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
+ * Since: 1.8
*/
gboolean
mm_modem_3gpp_set_eps_ue_mode_operation_sync (MMModem3gpp *self,
@@ -898,12 +995,16 @@ mm_modem_3gpp_set_eps_ue_mode_operation_sync (MMModem3gpp *se
/**
* mm_modem_3gpp_get_initial_eps_bearer_finish:
* @self: A #MMModem3gpp.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_3gpp_get_initial_eps_bearer().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_3gpp_get_initial_eps_bearer().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_3gpp_get_initial_eps_bearer().
*
- * Returns: (transfer full): a #MMSim or #NULL if @error is set. The returned value should be freed with g_object_unref().
+ * Returns: (transfer full): a #MMSim or #NULL if @error is set. The returned
+ * value should be freed with g_object_unref().
+ *
+ * Since: 1.10
*/
MMBearer *
mm_modem_3gpp_get_initial_eps_bearer_finish (MMModem3gpp *self,
@@ -940,15 +1041,23 @@ modem_3gpp_get_initial_eps_bearer_ready (GDBusConnection *connection,
* mm_modem_3gpp_get_initial_eps_bearer:
* @self: A #MMModem3gpp.
* @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+ * @callback: A #GAsyncReadyCallback to call when the request is satisfied or
+ * %NULL.
* @user_data: User data to pass to @callback.
*
- * Asynchronously gets the initial EPS #MMBearer object exposed by this #MMModem3gpp.
+ * Asynchronously gets the initial EPS #MMBearer object exposed by this
+ * #MMModem3gpp.
*
- * When the operation is finished, @callback will be invoked in the <link linkend="g-main-context-push-thread-default">thread-default main loop</link> of the thread you are calling this method from.
- * You can then call mm_modem_3gpp_get_initial_eps_bearer_finish() to get the result of the operation.
+ * When the operation is finished, @callback will be invoked in the
+ * <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
+ * of the thread you are calling this method from. You can then call
+ * mm_modem_3gpp_get_initial_eps_bearer_finish() to get the result of the
+ * operation.
*
- * See mm_modem_3gpp_get_initial_eps_bearer_sync() for the synchronous, blocking version of this method.
+ * See mm_modem_3gpp_get_initial_eps_bearer_sync() for the synchronous, blocking
+ * version of this method.
+ *
+ * Since: 1.10
*/
void
mm_modem_3gpp_get_initial_eps_bearer (MMModem3gpp *self,
@@ -992,12 +1101,17 @@ mm_modem_3gpp_get_initial_eps_bearer (MMModem3gpp *self,
* @cancellable: (allow-none): A #GCancellable or %NULL.
* @error: Return location for error or %NULL.
*
- * Synchronously gets the initial EPS #MMBearer object exposed by this #MMModem3gpp.
+ * Synchronously gets the initial EPS #MMBearer object exposed by this
+ * #MMModem3gpp.
+ *
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_3gpp_get_initial_eps_bearer() for the asynchronous version of this
+ * method.
*
- * The calling thread is blocked until a reply is received. See mm_modem_3gpp_get_initial_eps_bearer()
- * for the asynchronous version of this method.
+ * Returns: (transfer full): a #MMBearer or #NULL if @error is set. The returned
+ * value should be freed with g_object_unref().
*
- * Returns: (transfer full): a #MMBearer or #NULL if @error is set. The returned value should be freed with g_object_unref().
+ * Since: 1.10
*/
MMBearer *
mm_modem_3gpp_get_initial_eps_bearer_sync (MMModem3gpp *self,
@@ -1036,12 +1150,16 @@ mm_modem_3gpp_get_initial_eps_bearer_sync (MMModem3gpp *self,
/**
* mm_modem_3gpp_set_initial_eps_bearer_settings_finish:
* @self: A #MMModem3gpp.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_3gpp_set_initial_eps_bearer_settings().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_3gpp_set_initial_eps_bearer_settings().
* @error: Return location for error or %NULL.
*
- * Finishes an operation started with mm_modem_3gpp_set_initial_eps_bearer_settings().
+ * Finishes an operation started with
+ * mm_modem_3gpp_set_initial_eps_bearer_settings().
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
+ * Since: 1.10
*/
gboolean
mm_modem_3gpp_set_initial_eps_bearer_settings_finish (MMModem3gpp *self,
@@ -1056,7 +1174,8 @@ mm_modem_3gpp_set_initial_eps_bearer_settings_finish (MMModem3gpp *self,
* @self: A #MMModem3gpp.
* @config: A #MMBearerProperties object with the properties to use.
* @cancellable: (allow-none): A #GCancellable or %NULL.
- * @callback: A #GAsyncReadyCallback to call when the request is satisfied or %NULL.
+ * @callback: A #GAsyncReadyCallback to call when the request is satisfied or
+ * %NULL.
* @user_data: User data to pass to @callback.
*
* Asynchronously configures the settings for the initial LTE default bearer.
@@ -1064,7 +1183,10 @@ mm_modem_3gpp_set_initial_eps_bearer_settings_finish (MMModem3gpp *self,
* When the operation is finished, @callback will be invoked in the
* <link linkend="g-main-context-push-thread-default">thread-default main loop</link>
* of the thread you are calling this method from. You can then call
- * mm_modem_3gpp_set_initial_eps_bearer_settings_finish() to get the result of the operation.
+ * mm_modem_3gpp_set_initial_eps_bearer_settings_finish() to get the result of
+ * the operation.
+ *
+ * Since: 1.10
*/
void
mm_modem_3gpp_set_initial_eps_bearer_settings (MMModem3gpp *self,
@@ -1098,6 +1220,8 @@ mm_modem_3gpp_set_initial_eps_bearer_settings (MMModem3gpp *self,
* version of this method.
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
+ * Since: 1.10
*/
gboolean
mm_modem_3gpp_set_initial_eps_bearer_settings_sync (MMModem3gpp *self,