svn commit: r780656 - /httpd/httpd/trunk/include/ap_slotmem.h

[ji...@apache.org]

Author: jim
Date: Mon Jun  1 14:15:48 2009
New Revision: 780656

URL: http://svn.apache.org/viewvc?rev=780656&view=rev
Log:
Align doccos with code and clarify: grab tries to find a free
slot and returns that

Modified:
    httpd/httpd/trunk/include/ap_slotmem.h

Modified: httpd/httpd/trunk/include/ap_slotmem.h
URL: http://svn.apache.org/viewvc/httpd/httpd/trunk/include/ap_slotmem.h?rev=780656&r1=780655&r2=780656&view=diff
==============================================================================
--- httpd/httpd/trunk/include/ap_slotmem.h (original)
+++ httpd/httpd/trunk/include/ap_slotmem.h Mon Jun  1 14:15:48 2009
@@ -124,7 +124,7 @@
      */
     apr_status_t (* dptr)(ap_slotmem_instance_t *s, unsigned int item_id, void**mem);
     /**
-     * get/read the memory associated with this worker slot.
+     * get/read the data associated with this worker slot.
      * @param s ap_slotmem_instance_t to use.
      * @param item_id item to return for 0 to item_num
      * @param dest address to store the data
@@ -133,7 +133,7 @@
      */
     apr_status_t (* get)(ap_slotmem_instance_t *s, unsigned int item_id, unsigned char *dest, apr_size_t dest_len);
     /**
-     * put/write the memory associated with this worker slot.
+     * put/write the data associated with this worker slot.
      * @param s ap_slotmem_instance_t to use.
      * @param item_id item to return for 0 to item_num
      * @param src address of the data to store in the slot
@@ -154,16 +154,16 @@
      */
     apr_size_t (* slot_size)(ap_slotmem_instance_t *s);
     /**
-     * grab (or alloc) the slot associated with this item_id
+     * grab (or alloc) a free slot
      * @param s ap_slotmem_instance_t to use.
-     * @param item_id item allocate and mark as in-use
+     * @param item_id the available slot id and marked as in-use
      * @return APR_SUCCESS if all went well
      */
-    apr_status_t (* grab)(ap_slotmem_instance_t *s, unsigned int item_id);
+    apr_status_t (* grab)(ap_slotmem_instance_t *s, unsigned int *item_id);
     /**
      * release (or free) the slot associated with this item_id
      * @param s ap_slotmem_instance_t to use.
-     * @param item_id item free and mark as no longer in-use
+     * @param item_id slot id to free and mark as no longer in-use
      * @return APR_SUCCESS if all went well
      */
     apr_status_t (* release)(ap_slotmem_instance_t *s, unsigned int item_id);