Update documentation for to have correct headers0.5

 * Add add more warnings to unstable API documentation

7 files changed, 22 insertions, 1 deletions

diff --git a/libsecret/secret-collection.c b/libsecret/secret-collection.c
index 1165e12..b590c5c 100644
--- a/libsecret/secret-collection.c
+++ b/libsecret/secret-collection.c
@@ -40,6 +40,9 @@
  * lookup the items in the collection. There may not be any items exposed when
  * the collection is locked.
  *
+ * These functions have an unstable API and may change across versions. Use
+ * <literal>libsecret-unstable</literal> package to access them.
+ *
  * Stability: Unstable
  */
 
diff --git a/libsecret/secret-item.c b/libsecret/secret-item.c
index ca4c107..49a9dba 100644
--- a/libsecret/secret-item.c
+++ b/libsecret/secret-item.c
@@ -50,6 +50,9 @@
  *
  * Items can be created with secret_item_create() or secret_service_store().
  *
+ * These functions have an unstable API and may change across versions. Use
+ * <literal>libsecret-unstable</literal> package to access them.
+ *
  * Stability: Unstable
  */
 
diff --git a/libsecret/secret-password.c b/libsecret/secret-password.c
index f506596..5f2288b 100644
--- a/libsecret/secret-password.c
+++ b/libsecret/secret-password.c
@@ -39,7 +39,10 @@
  * 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
+ * These functions have an unstable API and may change across versions. Use
+ * <literal>libsecret-unstable</literal> package to access them.
+ *
+ * Stability: Unstable
  */
 
 /**
diff --git a/libsecret/secret-paths.c b/libsecret/secret-paths.c
index 60df179..dea7097 100644
--- a/libsecret/secret-paths.c
+++ b/libsecret/secret-paths.c
@@ -36,6 +36,9 @@
  * service using the DBus API directly, and only wish to use a few calls
  * in libsecret.
  *
+ * These functions have an unstable API and may change across versions. Use
+ * <literal>libsecret-unstable</literal> package to access them.
+ *
  * Stability: Unstable
  */
 
diff --git a/libsecret/secret-prompt.c b/libsecret/secret-prompt.c
index 6d8e2f8..029739a 100644
--- a/libsecret/secret-prompt.c
+++ b/libsecret/secret-prompt.c
@@ -38,6 +38,9 @@
  * SecretServiceClass::prompt_async and SecretServiceClass::prompt_finish
  * virtual methods of the #SecretService class.
  *
+ * These functions have an unstable API and may change across versions. Use
+ * <literal>libsecret-unstable</literal> package to access them.
+ *
  * Stability: Unstable
  */
 
diff --git a/libsecret/secret-service.c b/libsecret/secret-service.c
index eea9b18..6d4218b 100644
--- a/libsecret/secret-service.c
+++ b/libsecret/secret-service.c
@@ -66,6 +66,9 @@
  * In order to customize prompt handling, override the <literal>prompt_async</literal>
  * and <literal>prompt_finish</literal> virtual methods of the #SecretService class.
  *
+ * These functions have an unstable API and may change across versions. Use
+ * <literal>libsecret-unstable</literal> package to access them.
+ *
  * Stability: Unstable
  */
 
diff --git a/libsecret/secret-value.c b/libsecret/secret-value.c
index 9b46c48..7bd7bc2 100644
--- a/libsecret/secret-value.c
+++ b/libsecret/secret-value.c
@@ -38,6 +38,9 @@
  * #SecretValue is reference counted and immutable. The secret data is only
  * freed when all references have been released via secret_value_unref().
  *
+ * These functions have an unstable API and may change across versions. Use
+ * <literal>libsecret-unstable</literal> package to access them.
+ *
  * Stability: Unstable
  */