aboutsummaryrefslogtreecommitdiff
path: root/libmm-glib/mm-modem-voice.c
diff options
context:
space:
mode:
Diffstat (limited to 'libmm-glib/mm-modem-voice.c')
-rw-r--r--libmm-glib/mm-modem-voice.c247
1 files changed, 173 insertions, 74 deletions
diff --git a/libmm-glib/mm-modem-voice.c b/libmm-glib/mm-modem-voice.c
index ce22e0b8..8d13a240 100644
--- a/libmm-glib/mm-modem-voice.c
+++ b/libmm-glib/mm-modem-voice.c
@@ -50,6 +50,8 @@ G_DEFINE_TYPE (MMModemVoice, mm_modem_voice, MM_GDBUS_TYPE_MODEM_VOICE_PROXY)
* Gets the DBus path of the #MMObject which implements this interface.
*
* Returns: (transfer none): The DBus path of the #MMObject object.
+ *
+ * Since: 1.6
*/
const gchar *
mm_modem_voice_get_path (MMModemVoice *self)
@@ -64,9 +66,13 @@ mm_modem_voice_get_path (MMModemVoice *self)
* mm_modem_voice_dup_path:
* @self: A #MMModemVoice.
*
- * 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.6
*/
gchar *
mm_modem_voice_dup_path (MMModemVoice *self)
@@ -87,7 +93,9 @@ mm_modem_voice_dup_path (MMModemVoice *self)
*
* Checks whether emergency calls only are allowed.
*
- * Returns: %TRUE if only emergency calls are allowed, %FALSE otherwise..
+ * Returns: %TRUE if only emergency calls are allowed, %FALSE otherwise.
+ *
+ * Since: 1.12
*/
gboolean
mm_modem_voice_get_emergency_only (MMModemVoice *self)
@@ -120,12 +128,18 @@ list_call_context_free (ListCallsContext *ctx)
/**
* mm_modem_voice_list_calls_finish:
* @self: A #MMModem.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_list_calls().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_list_calls().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_list_calls().
*
- * Returns: (element-type ModemManager.Call) (transfer full): A list of #MMCall objects, or #NULL if either not found or @error is set. The returned value should be freed with g_list_free_full() using g_object_unref() as #GDestroyNotify function.
+ * Returns: (element-type ModemManager.Call) (transfer full): A list of #MMCall
+ * objects, or #NULL if either not found or @error is set. The returned value
+ * should be freed with g_list_free_full() using g_object_unref() as
+ * #GDestroyNotify function.
+ *
+ * Since: 1.6
*/
GList *
mm_modem_voice_list_calls_finish (MMModemVoice *self,
@@ -204,15 +218,21 @@ create_next_call (GTask *task)
* mm_modem_voice_list_calls:
* @self: A #MMModemVoice.
* @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 lists the #MMCall objects in the modem.
*
- * 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_voice_list_calls_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_voice_list_calls_finish() to get the result of the operation.
+ *
+ * See mm_modem_voice_list_calls_sync() for the synchronous, blocking version of
+ * this method.
*
- * See mm_modem_voice_list_calls_sync() for the synchronous, blocking version of this method.
+ * Since: 1.6
*/
void
mm_modem_voice_list_calls (MMModemVoice *self,
@@ -251,10 +271,15 @@ mm_modem_voice_list_calls (MMModemVoice *self,
*
* Synchronously lists the #MMCall objects in the modem.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_list_calls()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_list_calls() for the asynchronous version of this method.
+ *
+ * Returns: (element-type ModemManager.Call) (transfer full): A list of #MMCall
+ * objects, or #NULL if either not found or @error is set. The returned value
+ * should be freed with g_list_free_full() using g_object_unref() as
+ * #GDestroyNotify function.
*
- * Returns: (element-type ModemManager.Call) (transfer full): A list of #MMCall objects, or #NULL if either not found or @error is set. The returned value should be freed with g_list_free_full() using g_object_unref() as #GDestroyNotify function.
+ * Since: 1.6
*/
GList *
mm_modem_voice_list_calls_sync (MMModemVoice *self,
@@ -304,12 +329,16 @@ mm_modem_voice_list_calls_sync (MMModemVoice *self,
/**
* mm_modem_voice_create_call_finish:
* @self: A #MMModemVoice.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_create_call().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_create_call().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_create_call().
*
- * Returns: (transfer full): A newly created #MMCall, or %NULL if @error is set. The returned value should be freed with g_object_unref().
+ * Returns: (transfer full): A newly created #MMCall, or %NULL if @error is set.
+ * The returned value should be freed with g_object_unref().
+ *
+ * Since: 1.6
*/
MMCall *
mm_modem_voice_create_call_finish (MMModemVoice *self,
@@ -379,15 +408,21 @@ create_call_ready (MMModemVoice *self,
* @self: A #MMModemVoice.
* @properties: A ##MMCallProperties 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 creates a new #MMCall in the modem.
*
- * 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_voice_create_call_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_voice_create_call_finish() to get the result of the operation.
+ *
+ * See mm_modem_voice_create_call_sync() for the synchronous, blocking version
+ * of this method.
*
- * See mm_modem_voice_create_call_sync() for the synchronous, blocking version of this method.
+ * Since: 1.6
*/
void
mm_modem_voice_create_call (MMModemVoice *self,
@@ -422,10 +457,13 @@ mm_modem_voice_create_call (MMModemVoice *self,
*
* Synchronously creates a new #MMCall in the modem.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_create_call()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_create_call() for the asynchronous version of this method.
+ *
+ * Returns: (transfer full): A newly created #MMCall, or %NULL if @error is set.
+ * The returned value should be freed with g_object_unref().
*
- * Returns: (transfer full): A newly created #MMCall, or %NULL if @error is set. The returned value should be freed with g_object_unref().
+ * Since: 1.6
*/
MMCall *
mm_modem_voice_create_call_sync (MMModemVoice *self,
@@ -468,12 +506,15 @@ mm_modem_voice_create_call_sync (MMModemVoice *self,
/**
* mm_modem_voice_delete_call_finish:
* @self: A #MMModemVoice.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_delete_call().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_delete_call().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_delete_call().
*
* Returns: %TRUE if the call was deleted, %FALSE if @error is set.
+ *
+ * Since: 1.6
*/
gboolean
mm_modem_voice_delete_call_finish (MMModemVoice *self,
@@ -490,15 +531,21 @@ mm_modem_voice_delete_call_finish (MMModemVoice *self,
* @self: A #MMModemVoice.
* @call: Path of the #MMCall to delete.
* @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 deletes a given #MMCall from the modem.
*
- * 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_voice_delete_call_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_voice_delete_call_finish() to get the result of the operation.
+ *
+ * See mm_modem_voice_delete_call_sync() for the synchronous, blocking version
+ * of this method.
*
- * See mm_modem_voice_delete_call_sync() for the synchronous, blocking version of this method.
+ * Since: 1.6
*/
void
mm_modem_voice_delete_call (MMModemVoice *self,
@@ -525,10 +572,12 @@ mm_modem_voice_delete_call (MMModemVoice *self,
* Synchronously deletes a given #MMCall from the modem.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_delete_call()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_delete_call() for the asynchronous version of this method.
*
* Returns: %TRUE if the CALL was deleted, %FALSE if @error is set.
+ *
+ * Since: 1.6
*/
gboolean
mm_modem_voice_delete_call_sync (MMModemVoice *self,
@@ -549,12 +598,14 @@ mm_modem_voice_delete_call_sync (MMModemVoice *self,
/**
* mm_modem_voice_hold_and_accept_finish:
* @self: A #MMModemVoice.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_hold_and_accept().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_hold_and_accept().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_hold_and_accept().
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -571,15 +622,20 @@ mm_modem_voice_hold_and_accept_finish (MMModemVoice *self,
* mm_modem_voice_hold_and_accept:
* @self: A #MMModemVoice.
* @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 puts all active calls on hold and accepts the next waiting or held call.
+ * Asynchronously puts all active calls on hold and accepts the next waiting or
+ * held call.
*
- * 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_voice_hold_and_accept_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_voice_hold_and_accept_finish() to get the result of the operation.
*
- * See mm_modem_voice_hold_and_accept_sync() for the synchronous, blocking version of this method.
+ * See mm_modem_voice_hold_and_accept_sync() for the synchronous, blocking
+ * version of this method.
*
* Since: 1.12
*/
@@ -603,12 +659,14 @@ mm_modem_voice_hold_and_accept (MMModemVoice *self,
* @cancellable: (allow-none): A #GCancellable or %NULL.
* @error: Return location for error or %NULL.
*
- * Synchronously puts all active calls on hold and accepts the next waiting or held call.
+ * Synchronously puts all active calls on hold and accepts the next waiting or
+ * held call.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_hold_and_accept()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_hold_and_accept() for the asynchronous version of this method.
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -628,12 +686,14 @@ mm_modem_voice_hold_and_accept_sync (MMModemVoice *self,
/**
* mm_modem_voice_hangup_and_accept_finish:
* @self: A #MMModemVoice.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_hangup_and_accept().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_hangup_and_accept().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_hangup_and_accept().
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -650,15 +710,20 @@ mm_modem_voice_hangup_and_accept_finish (MMModemVoice *self,
* mm_modem_voice_hangup_and_accept:
* @self: A #MMModemVoice.
* @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 hangs up all active calls and accepts the next waiting or held call.
+ * Asynchronously hangs up all active calls and accepts the next waiting or held
+ * call.
*
- * 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_voice_hangup_and_accept_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_voice_hangup_and_accept_finish() to get the result of the operation.
*
- * See mm_modem_voice_hangup_and_accept_sync() for the synchronous, blocking version of this method.
+ * See mm_modem_voice_hangup_and_accept_sync() for the synchronous, blocking
+ * version of this method.
*
* Since: 1.12
*/
@@ -682,12 +747,14 @@ mm_modem_voice_hangup_and_accept (MMModemVoice *self,
* @cancellable: (allow-none): A #GCancellable or %NULL.
* @error: Return location for error or %NULL.
*
- * Synchronously hangs up all active calls and accepts the next waiting or held call.
+ * Synchronously hangs up all active calls and accepts the next waiting or held
+ * call.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_hangup_and_accept()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_hangup_and_accept() for the asynchronous version of this method.
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -707,12 +774,14 @@ mm_modem_voice_hangup_and_accept_sync (MMModemVoice *self,
/**
* mm_modem_voice_hangup_all_finish:
* @self: A #MMModemVoice.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_hangup_all().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_hangup_all().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_hangup_all().
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -729,15 +798,19 @@ mm_modem_voice_hangup_all_finish (MMModemVoice *self,
* mm_modem_voice_hangup_all:
* @self: A #MMModemVoice.
* @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 hangs up all ongoing (active, waiting, held) calls.
*
- * 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_voice_hangup_all_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_voice_hangup_all_finish() to get the result of the operation.
*
- * See mm_modem_voice_hangup_all_sync() for the synchronous, blocking version of this method.
+ * See mm_modem_voice_hangup_all_sync() for the synchronous, blocking version of
+ * this method.
*
* Since: 1.12
*/
@@ -763,10 +836,11 @@ mm_modem_voice_hangup_all (MMModemVoice *self,
*
* Synchronously hangs up all ongoing (active, waiting, held) calls.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_hangup_all()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_hangup_all() for the asynchronous version of this method.
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -786,12 +860,14 @@ mm_modem_voice_hangup_all_sync (MMModemVoice *self,
/**
* mm_modem_voice_transfer_finish:
* @self: A #MMModemVoice.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_transfer().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_transfer().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_transfer().
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -808,15 +884,19 @@ mm_modem_voice_transfer_finish (MMModemVoice *self,
* mm_modem_voice_transfer:
* @self: A #MMModemVoice.
* @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 joins all active and held calls, and disconnects from them.
*
- * 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_voice_transfer_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_voice_transfer_finish() to get the result of the operation.
*
- * See mm_modem_voice_transfer_sync() for the synchronous, blocking version of this method.
+ * See mm_modem_voice_transfer_sync() for the synchronous, blocking version of
+ * this method.
*
* Since: 1.12
*/
@@ -842,10 +922,11 @@ mm_modem_voice_transfer (MMModemVoice *self,
*
* Synchronously joins all active and held calls, and disconnects from them.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_transfer()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_transfer() for the asynchronous version of this method.
*
* Returns: %TRUE if the operation was successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -865,12 +946,14 @@ mm_modem_voice_transfer_sync (MMModemVoice *self,
/**
* mm_modem_voice_call_waiting_setup_finish:
* @self: A #MMModemVoice.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_call_waiting_setup().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_call_waiting_setup().
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_call_waiting_setup().
*
* Returns: %TRUE if @status is set, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -888,15 +971,20 @@ mm_modem_voice_call_waiting_setup_finish (MMModemVoice *self,
* @self: A #MMModemVoice.
* @enable: Whether the call waiting service should be enabled.
* @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 enables or disables the call waiting network service.
*
- * 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_voice_call_waiting_setup_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_voice_call_waiting_setup_finish() to get the result of the
+ * operation.
*
- * See mm_modem_voice_call_waiting_setup_sync() for the synchronous, blocking version of this method.
+ * See mm_modem_voice_call_waiting_setup_sync() for the synchronous, blocking
+ * version of this method.
*
* Since: 1.12
*/
@@ -925,10 +1013,12 @@ mm_modem_voice_call_waiting_setup (MMModemVoice *self,
*
* Synchronously enables or disables the call waiting network service.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_call_waiting_setup()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_call_waiting_setup() for the asynchronous version of this
+ * method.
*
* Returns: %TRUE if the operation is successful, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -950,13 +1040,15 @@ mm_modem_voice_call_waiting_setup_sync (MMModemVoice *self,
/**
* mm_modem_voice_call_waiting_query_finish:
* @self: A #MMModemVoice.
- * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to mm_modem_voice_call_waiting_query().
+ * @res: The #GAsyncResult obtained from the #GAsyncReadyCallback passed to
+ * mm_modem_voice_call_waiting_query().
* @status: Output location where to store the status.
* @error: Return location for error or %NULL.
*
* Finishes an operation started with mm_modem_voice_call_waiting_query().
*
* Returns: %TRUE if @status is set, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean
@@ -974,15 +1066,20 @@ mm_modem_voice_call_waiting_query_finish (MMModemVoice *self,
* mm_modem_voice_call_waiting_query:
* @self: A #MMModemVoice.
* @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 queries the status of the call waiting network service.
*
- * 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_voice_call_waiting_query_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_voice_call_waiting_query_finish() to get the result of the
+ * operation.
*
- * See mm_modem_voice_call_waiting_query_sync() for the synchronous, blocking version of this method.
+ * See mm_modem_voice_call_waiting_query_sync() for the synchronous, blocking
+ * version of this method.
*
* Since: 1.12
*/
@@ -1009,10 +1106,12 @@ mm_modem_voice_call_waiting_query (MMModemVoice *self,
*
* Synchronously queries the status of the call waiting network service.
*
- * The calling thread is blocked until a reply is received. See mm_modem_voice_call_waiting_query()
- * for the asynchronous version of this method.
+ * The calling thread is blocked until a reply is received. See
+ * mm_modem_voice_call_waiting_query() for the asynchronous version of this
+ * method.
*
* Returns: %TRUE if @status is set, %FALSE if @error is set.
+ *
* Since: 1.12
*/
gboolean