[evolution-data-server] Deprecate ECancellable[Rec]Mutex.

[Matthew Barnes <mbarnes src gnome org>]

commit 3f10eb77ec9caa50792ec5bff35108bea1deae1f
Author: Matthew Barnes <mbarnes redhat com>
Date:   Wed Dec 4 09:39:43 2013 -0500

    Deprecate ECancellable[Rec]Mutex.

 .../libedataserver/libedataserver-docs.sgml        |    1 +
 libedataserver/e-cancellable-locks.c               |   20 +++++++++++++++++++-
 libedataserver/e-cancellable-locks.h               |    9 +++++++++
 3 files changed, 29 insertions(+), 1 deletions(-)
---
diff --git a/docs/reference/libedataserver/libedataserver-docs.sgml 
b/docs/reference/libedataserver/libedataserver-docs.sgml
index 5c11b96..44557b8 100644
--- a/docs/reference/libedataserver/libedataserver-docs.sgml
+++ b/docs/reference/libedataserver/libedataserver-docs.sgml
@@ -68,6 +68,7 @@
 
   <chapter>
     <title>Deprecated Classes</title>
+    <xi:include href="xml/e-cancellable-locks.xml"/>
     <xi:include href="xml/e-credentials.xml"/>
     <xi:include href="xml/e-iterator.xml"/>
     <xi:include href="xml/e-list.xml"/>
diff --git a/libedataserver/e-cancellable-locks.c b/libedataserver/e-cancellable-locks.c
index fe0f2d6..6b5e793 100644
--- a/libedataserver/e-cancellable-locks.c
+++ b/libedataserver/e-cancellable-locks.c
@@ -24,7 +24,7 @@
 #include "e-cancellable-locks.h"
 
 /**
- * SECTION:cancellable_locks
+ * SECTION: e-cancellable-locks
  * @title: Cancellable Locks
  * @short_description: locks, which can listen for a #GCancellable during lock call
  *
@@ -53,6 +53,8 @@ cancellable_locks_cancelled_cb (GCancellable *cancellable,
  * Initializes @mutex structure.
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 void
 e_cancellable_mutex_init (ECancellableMutex *mutex)
@@ -71,6 +73,8 @@ e_cancellable_mutex_init (ECancellableMutex *mutex)
  * Frees memory allocated by e_cancellable_mutex_init().
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 void
 e_cancellable_mutex_clear (ECancellableMutex *mutex)
@@ -95,6 +99,8 @@ e_cancellable_mutex_clear (ECancellableMutex *mutex)
  * Returns: %TRUE, if lock had been acquired, %FALSE otherwise
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 gboolean
 e_cancellable_mutex_lock (ECancellableMutex *mutex,
@@ -149,6 +155,8 @@ e_cancellable_mutex_lock (ECancellableMutex *mutex,
  * %FALSE in e_cancellable_mutex_lock().
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 void
 e_cancellable_mutex_unlock (ECancellableMutex *mutex)
@@ -174,6 +182,8 @@ e_cancellable_mutex_unlock (ECancellableMutex *mutex)
  * Returns: Internal #GMutex, used in @mutex
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 GMutex *
 e_cancellable_mutex_get_internal_mutex (ECancellableMutex *mutex)
@@ -190,6 +200,8 @@ e_cancellable_mutex_get_internal_mutex (ECancellableMutex *mutex)
  * Initializes @rec_mutex structure.
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 void
 e_cancellable_rec_mutex_init (ECancellableRecMutex *rec_mutex)
@@ -208,6 +220,8 @@ e_cancellable_rec_mutex_init (ECancellableRecMutex *rec_mutex)
  * Frees memory allocated by e_cancellable_rec_mutex_init().
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 void
 e_cancellable_rec_mutex_clear (ECancellableRecMutex *rec_mutex)
@@ -232,6 +246,8 @@ e_cancellable_rec_mutex_clear (ECancellableRecMutex *rec_mutex)
  * Returns: %TRUE, if lock had been acquired, %FALSE otherwise
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 gboolean
 e_cancellable_rec_mutex_lock (ECancellableRecMutex *rec_mutex,
@@ -286,6 +302,8 @@ e_cancellable_rec_mutex_lock (ECancellableRecMutex *rec_mutex,
  * %FALSE in e_cancellable_rec_mutex_lock().
  *
  * Since: 3.8
+ *
+ * Deprecated: 3.12: If you think you need this, you're using mutexes wrong.
  **/
 void
 e_cancellable_rec_mutex_unlock (ECancellableRecMutex *rec_mutex)
diff --git a/libedataserver/e-cancellable-locks.h b/libedataserver/e-cancellable-locks.h
index 16e9e78..d7e5a01 100644
--- a/libedataserver/e-cancellable-locks.h
+++ b/libedataserver/e-cancellable-locks.h
@@ -21,6 +21,11 @@
 #error "Only <libedataserver/libedataserver.h> should be included directly."
 #endif
 
+#ifndef EDS_DISABLE_DEPRECATED
+
+/* Do not generate bindings. */
+#ifndef __GI_SCANNER__
+
 #ifndef E_CANCELLABLE_LOCKS_H
 #define E_CANCELLABLE_LOCKS_H
 
@@ -67,3 +72,7 @@ struct _ECancellableRecMutex {
 G_END_DECLS
 
 #endif /* E_CANCELLABLE_LOCKS_H */
+
+#endif /* __GI_SCANNER__ */
+
+#endif /* EDS_DISABLE_DEPRECATED */