[libsecret] Fix documentation warnings

[Stefan Walter <stefw src gnome org>]

commit 482dc34d7468ddfc08f1a204459dec4d3785f1f6
Author: Stef Walter <stefw gnome org>
Date:   Thu Oct 17 08:59:55 2013 +0200

    Fix documentation warnings

 docs/reference/libsecret/libsecret-sections.txt |    2 +
 libsecret/secret-paths.c                        |   25 ++++++++++++++++++++++-
 libsecret/secret-service.c                      |    4 +++
 libsecret/secret-util.c                         |    7 ++++++
 4 files changed, 37 insertions(+), 1 deletions(-)
---
diff --git a/docs/reference/libsecret/libsecret-sections.txt b/docs/reference/libsecret/libsecret-sections.txt
index a18b89e..d62dd5d 100644
--- a/docs/reference/libsecret/libsecret-sections.txt
+++ b/docs/reference/libsecret/libsecret-sections.txt
@@ -226,6 +226,8 @@ secret_service_prompt_sync
 secret_service_set_alias
 secret_service_set_alias_finish
 secret_service_set_alias_sync
+secret_service_get_collection_gtype
+secret_service_get_item_gtype
 <SUBSECTION Standard>
 SECRET_IS_SERVICE
 SECRET_IS_SERVICE_CLASS
diff --git a/libsecret/secret-paths.c b/libsecret/secret-paths.c
index 8114b79..93e6e94 100644
--- a/libsecret/secret-paths.c
+++ b/libsecret/secret-paths.c
@@ -242,7 +242,7 @@ secret_item_new_for_dbus_path_finish (GAsyncResult *result,
 }
 
 /**
- * secret_item_new_dbus_path_sync:
+ * secret_item_new_for_dbus_path_sync:
  * @service: (allow-none): a secret service object
  * @item_path: the D-Bus path of the item
  * @flags: initialization flags for the new item
@@ -2394,6 +2394,29 @@ secret_service_set_alias_to_dbus_path_sync (SecretService *self,
        return ret;
 }
 
+/**
+ * secret_service_prompt_at_dbus_path_sync:
+ * @self: the secret service
+ * @prompt_path: the D-Bus object path of the prompt
+ * @cancellable: optional cancellation object
+ * @return_type: (allow-none): the variant type of the prompt result
+ * @error: location to place error on failure
+ *
+ * Perform prompting for a #SecretPrompt.
+ *
+ * Override the #SecretServiceClass <literal>prompt_async</literal> virtual method
+ * to change the behavior of the propmting. The default behavior is to simply
+ * run secret_prompt_perform() on the prompt.
+ *
+ * Returns a variant result if the prompt was completed and not dismissed. The
+ * type of result depends on the action the prompt is completing, and is defined
+ * in the Secret Service DBus API specification.
+ *
+ * This method may block and should not be used in user interface threads.
+ *
+ * Returns: (transfer full): %NULL if the prompt was dismissed or an error occurred,
+ *          a variant result if the prompt was successful
+ */
 GVariant *
 secret_service_prompt_at_dbus_path_sync (SecretService *self,
                                          const gchar *prompt_path,
diff --git a/libsecret/secret-service.c b/libsecret/secret-service.c
index 3c9539c..0295c89 100644
--- a/libsecret/secret-service.c
+++ b/libsecret/secret-service.c
@@ -88,6 +88,10 @@
  * @prompt_async: called to perform asynchronous prompting when necessary
  * @prompt_finish: called to complete an asynchronous prompt operation
  * @prompt_sync: called to perform synchronous prompting when necessary
+ * @get_collection_gtype: called to get the GObject type for collections
+ *                        instantiated by the #SecretService proxy
+ * @get_item_gtype: called to get the GObject type for collections
+ *                  instantiated by the #SecretService proxy
  *
  * The class for #SecretService.
  */
diff --git a/libsecret/secret-util.c b/libsecret/secret-util.c
index e85d3ee..2442d37 100644
--- a/libsecret/secret-util.c
+++ b/libsecret/secret-util.c
@@ -32,6 +32,13 @@
  */
 
 /**
+ * SECRET_ERROR:
+ *
+ * The error domain quark which denotes libsecret specific errors from the
+ * #SecretError enumeration.
+ */
+
+/**
  * SecretError:
  * @SECRET_ERROR_PROTOCOL: received an invalid data or message from the Secret
  *                         Service