style and wording fixes
[mdref/mdref-http] / http / Client / enqueue.md
index b5a6d756cee268fdc37a7ac82d910b90ec29abfb..a863710d083d34c670d917cd5835217b6ec04aaf 100644 (file)
@@ -3,8 +3,17 @@
 Add another http\Client\Request to the request queue.
 If the optional callback $cb returns true, the request will be automatically dequeued.
 
+> ***Note:***  
+> The http\Client\Response object resulting from the request is always stored 
+> internally to be retreived at a later time, __even__ when $cb is used.
+> 
+> If you are about to send a lot of requests and do __not__ need the response
+> after executing the callback, you can use http\Client::getResponse() within
+> the callback to keep the memory usage level as low as possible.
+
 See http\Client::dequeue() and http\Client::send().
 
+
 ## Params:
 
 * http\Client\Request $request