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.
