From 778132d54c7216a3c743427e55e19646df8f67ea Mon Sep 17 00:00:00 2001 From: Philip Withnall Date: Wed, 28 Nov 2018 13:10:03 +0000 Subject: [PATCH] gmountoperation: Add missing documentation gtk-doc is unhappy that skeleton documentation comments had been written for these functions (for the introspection annotations) but that the documentation content was actually missing. Add that content. I like a happy gtk-doc. Signed-off-by: Philip Withnall --- gio/gmountoperation.h | 21 ++++++++++++++------- 1 file changed, 14 insertions(+), 7 deletions(-) diff --git a/gio/gmountoperation.h b/gio/gmountoperation.h index 1361fb86f..56db2a577 100644 --- a/gio/gmountoperation.h +++ b/gio/gmountoperation.h @@ -66,9 +66,12 @@ struct _GMountOperationClass /** * GMountOperationClass::ask_question: - * @op: - * @message: - * @choices: (array zero-terminated=1) (element-type utf8): + * @op: a #GMountOperation + * @message: string containing a message to display to the user + * @choices: (array zero-terminated=1) (element-type utf8): an array of + * strings for each possible choice + * + * Virtual implementation of #GMountOperation::ask-question. */ void (* ask_question) (GMountOperation *op, const char *message, @@ -81,10 +84,14 @@ struct _GMountOperationClass /** * GMountOperationClass::show_processes: - * @op: - * @message: - * @processes: (element-type GPid): - * @choices: (array zero-terminated=1) (element-type utf8): + * @op: a #GMountOperation + * @message: string containing a message to display to the user + * @processes: (element-type GPid): an array of #GPid for processes blocking + * the operation + * @choices: (array zero-terminated=1) (element-type utf8): an array of + * strings for each possible choice + * + * Virtual implementation of #GMountOperation::show-processes. * * Since: 2.22 */