apr-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Aaron Bannert <aa...@clove.org>
Subject [PATCH] note the pending deprecation of apr_lock.h API
Date Fri, 15 Feb 2002 15:57:07 GMT
How do we feel about this? If (vote < 0), please provide an alternative
solution.

-aaron


Index: include/apr_lock.h
===================================================================
RCS file: /home/cvs/apr/include/apr_lock.h,v
retrieving revision 1.31
diff -u -u -r1.31 apr_lock.h
--- include/apr_lock.h	29 Dec 2001 23:14:21 -0000	1.31
+++ include/apr_lock.h	15 Feb 2002 15:55:29 -0000
@@ -88,6 +88,10 @@
 /*   Function definitions */
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Create a new instance of a lock structure.
  * @param lock The newly created lock structure.
  * @param type The type of lock to create, one of:
@@ -127,12 +131,20 @@
                                           apr_pool_t *pool);
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Lock a protected region.
  * @param lock The lock to set.
  */
 APR_DECLARE(apr_status_t) apr_lock_acquire(apr_lock_t *lock);
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Tries to lock a protected region.  
  * @param lock The lock to set.
  * @return If it fails, returns APR_EBUSY.  Otherwise, it returns APR_SUCCESS.
@@ -140,6 +152,10 @@
 APR_DECLARE(apr_status_t) apr_lock_tryacquire(apr_lock_t *lock);
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Lock a region with either a reader or writer lock.
  * @param lock The lock to set.
  * @param type The type of lock to acquire.
@@ -148,12 +164,20 @@
                                               apr_readerwriter_e type);
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Unlock a protected region.
  * @param lock The lock to reset.
  */
 APR_DECLARE(apr_status_t) apr_lock_release(apr_lock_t *lock);
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Free the memory associated with a lock.
  * @param lock The lock to free.
  * @remark If the lock is currently active when it is destroyed, it 
@@ -162,6 +186,10 @@
 APR_DECLARE(apr_status_t) apr_lock_destroy(apr_lock_t *lock);
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Re-open a lock in a child process.
  * @param lock The newly re-opened lock structure.
  * @param fname A file name to use if the lock mechanism requires one.  This
@@ -179,6 +207,10 @@
                                               apr_pool_t *pool);
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Return the pool associated with the current lock.
  * @param lock The currently open lock.
  * @param key The key to use when retreiving data associated with this lock
@@ -188,6 +220,10 @@
                                            void *data);
 
 /**
+ * <b>CAUTION: This API has been deprecated. The new and expanded
+ * synchronization routines reside in apr_thread_mutex.h, apr_proc_mutex.h,
+ * apr_thread_rwlock.h, and apr_thread_cond.h.</b>
+ *
  * Return the pool associated with the current lock.
  * @param lock The currently open lock.
  * @param data The user data to associate with the lock.

Mime
View raw message