* Caller must suppress garbage collection for the target bucket before
* calling this function, and resume it afterwards.
*
- * If a matching item is found, res->target will be its arena offset and
- * res->found will be true. If not, res->target will be the arena offset of
- * the item following the insert position and found will be false. In either
- * case, res->pointer_to_target will a pointer to the address where the value
- * of target was found. res->target_node will be a pointer to the address of
- * the CHashNode with offset res->target, unless res->target is invalid.
+ * If a matching item is found, res->target will be a CHashPtr to that item
+ * and res->found will be true. If not, res->target will be a CHashPtr to the
+ * item which follows the insert position in the bucket chain, and res->found
+ * will be false. In either case, res->pointer_to_target will a pointer to
+ * the address where the value of target was found. res->target_node will be
+ * a pointer to the address of the CHashNode referenced by res->target, unless
+ * res->target is invalid.
*
* NB: If you change this function, make sure to adjust CHashBucketCleanup
* similarly.