Return-Path: 
 <dev-return-5751-apmail-apr-dev-archive=apr.apache.org@apr.apache.org>
Delivered-To: apmail-apr-dev-archive@apr.apache.org
Received: (qmail 73415 invoked by uid 500); 15 Feb 2002 15:57:05 -0000
Mailing-List: contact dev-help@apr.apache.org; run by ezmlm
Precedence: bulk
List-Post: <mailto:dev@apr.apache.org>
List-Help: <mailto:dev-help@apr.apache.org>
List-Unsubscribe: <mailto:dev-unsubscribe@apr.apache.org>
List-Subscribe: <mailto:dev-subscribe@apr.apache.org>
Delivered-To: mailing list dev@apr.apache.org
Received: (qmail 73404 invoked from network); 15 Feb 2002 15:57:04 -0000
Date: Fri, 15 Feb 2002 07:57:07 -0800
From: Aaron Bannert <aaron@clove.org>
To: dev@apr.apache.org
Subject: [PATCH] note the pending deprecation of apr_lock.h API
Message-ID: <20020215075707.C31632@clove.org>
Mail-Followup-To: Aaron Bannert <aaron@clove.org>, dev@apr.apache.org
Mime-Version: 1.0
Content-Type: text/plain; charset=us-ascii
Content-Disposition: inline
User-Agent: Mutt/1.3.23i
X-Spam-Rating: daedalus.apache.org 1.6.2 0/1000/N

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.