[libsecret] Fix documentation problems

[Stefan Walter <stefw src gnome org>]

commit 8e9284b4bc459f118842316292d695f74bec342d
Author: Stef Walter <stefw gnome org>
Date:   Fri Apr 27 16:57:36 2012 +0200

    Fix documentation problems

 library/secret-collection.c |    2 +-
 library/secret-item.c       |    8 ++++----
 library/secret-password.c   |    7 +++----
 library/secret-prompt.c     |    2 +-
 library/secret-schema.c     |    4 ++--
 library/secret-service.c    |    2 +-
 library/secret-util.c       |    2 +-
 library/secret-value.c      |    6 +++---
 8 files changed, 16 insertions(+), 17 deletions(-)
---
diff --git a/library/secret-collection.c b/library/secret-collection.c
index e36986b..52d153a 100644
--- a/library/secret-collection.c
+++ b/library/secret-collection.c
@@ -38,7 +38,7 @@
  * lookup the items in the collection. There may not be any items exposed when
  * the collection is locked.
  *
- * @stability: Unstable
+ * Stability: Unstable
  */
 
 /**
diff --git a/library/secret-item.c b/library/secret-item.c
index a4cc95d..fa433eb 100644
--- a/library/secret-item.c
+++ b/library/secret-item.c
@@ -48,7 +48,7 @@
  *
  * Items can be created with secret_item_create() or secret_service_store().
  *
- * @stability: Unstable
+ * Stability: Unstable
  */
 
 /**
@@ -832,13 +832,13 @@ on_item_deleted (GObject *source,
 }
 
 /**
- * secret_collection_delete:
- * @self: a collection
+ * secret_item_delete:
+ * @self: an item
  * @cancellable: optional cancellation object
  * @callback: called when the operation completes
  * @user_data: data to pass to the callback
  *
- * Delete this collection.
+ * Delete this item.
  *
  * This method returns immediately and completes asynchronously. The secret
  * service may prompt the user. secret_service_prompt() will be used to handle
diff --git a/library/secret-password.c b/library/secret-password.c
index 9828d7b..093530f 100644
--- a/library/secret-password.c
+++ b/library/secret-password.c
@@ -38,7 +38,7 @@
  * Each of the functions accept a variable list of attributes names and their
  * values. Include a %NULL to terminate the list of attributes.
  *
- * @stability: Stable
+ * Stability: Stable
  */
 
 typedef struct {
@@ -233,8 +233,7 @@ secret_password_storev (const SecretSchema *schema,
 }
 
 /**
- * secret_service_store_finish:
- * @self: the secret service
+ * secret_password_store_finish:
  * @result: the asynchronous result passed to the callback
  * @error: location to place an error on failure
  *
@@ -969,7 +968,7 @@ secret_password_removev (const SecretSchema *schema,
 }
 
 /**
- * secret_password_remove_finish
+ * secret_password_remove_finish:
  * @result: the asynchronous result passed to the callback
  * @error: location to place an error on failure
  *
diff --git a/library/secret-prompt.c b/library/secret-prompt.c
index c0316f5..184f456 100644
--- a/library/secret-prompt.c
+++ b/library/secret-prompt.c
@@ -38,7 +38,7 @@
  * SecretServiceClass::prompt_async and SecretServiceClass::prompt_finish
  * virtual methods of the #SecretService class.
  *
- * @stability: Unstable
+ * Stability: Unstable
  */
 
 /**
diff --git a/library/secret-schema.c b/library/secret-schema.c
index 52a6961..e56b54a 100644
--- a/library/secret-schema.c
+++ b/library/secret-schema.c
@@ -60,7 +60,7 @@
  * }
  * </programlisting></informalexample>
  *
- * @stability: Stable
+ * Stability: Stable
  */
 
 /**
@@ -89,7 +89,7 @@
  * that are not stored by the libsecret library. Other libraries such as libgnome-keyring
  * don't store the schema name.
  *
- * @stability: Stable
+ * Stability: Stable
  */
 
 /**
diff --git a/library/secret-service.c b/library/secret-service.c
index b32206d..bebbdcc 100644
--- a/library/secret-service.c
+++ b/library/secret-service.c
@@ -65,7 +65,7 @@
  * In order to customize prompt handling, override the <literal>prompt_async</literal>
  * and <literal>prompt_finish</literal> virtual methods of the #SecretService class.
  *
- * @stability: Unstable
+ * Stability: Unstable
  */
 
 /**
diff --git a/library/secret-util.c b/library/secret-util.c
index 4c686c7..eccfcf0 100644
--- a/library/secret-util.c
+++ b/library/secret-util.c
@@ -28,7 +28,7 @@
  * the libsecret API is suitable for direct display to the user. It is up
  * to the application to handle them appropriately.
  *
- * @stability: Stable
+ * Stability: Stable
  */
 
 /**
diff --git a/library/secret-value.c b/library/secret-value.c
index 8333c00..4f6e49f 100644
--- a/library/secret-value.c
+++ b/library/secret-value.c
@@ -38,7 +38,7 @@
  * #SecretValue is reference counted and immutable. The secret data is only
  * freed when all references have been released via secret_value_unref().
  *
- * @stability: Unstable
+ * Stability: Unstable
  */
 
 /**
@@ -74,7 +74,7 @@ secret_value_get_type (void)
 }
 
 /**
- * secret_value_new_full:
+ * secret_value_new:
  * @secret: the secret data
  * @length: the length of the data
  * @content_type: the content type of the data
@@ -183,7 +183,7 @@ secret_value_get_content_type (SecretValue *value)
 }
 
 /**
- * secret_value_unref:
+ * secret_value_ref:
  * @value: value to reference
  *
  * Add another reference to the #SecretValue. For each reference