jwoolley 2003/09/26 12:12:33
Modified: include Tag: APR_0_9_BRANCH apr_pools.h
Log:
clarify docs
submitted by: stas
Revision Changes Path
No revision
No revision
1.103.2.1 +6 -4 apr/include/apr_pools.h
Index: apr_pools.h
===================================================================
RCS file: /home/cvs/apr/include/apr_pools.h,v
retrieving revision 1.103
retrieving revision 1.103.2.1
diff -u -d -u -r1.103 -r1.103.2.1
--- apr_pools.h 11 Mar 2003 20:02:06 -0000 1.103
+++ apr_pools.h 26 Sep 2003 19:12:32 -0000 1.103.2.1
@@ -481,10 +481,12 @@
*
* Users of APR must take EXTREME care when choosing a key to
* use for their data. It is possible to accidentally overwrite
- * data by choosing a key that another part of the program is using
- * It is advised that steps are taken to ensure that a unique
- * key is used at all times.
- * @bug Specify how to ensure this uniqueness!
+ * data by choosing a key that another part of the program is using.
+ * Therefore it is advised that steps are taken to ensure that unique
+ * keys are used for all of the userdata objects in a particular pool
+ * (the same key in two different pools or a pool and one of its
+ * subpools is okay) at all times. Careful namespace prefixing of
+ * key names is a typical way to help ensure this uniqueness.
*/
APR_DECLARE(apr_status_t) apr_pool_userdata_set(
const void *data,
