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,