[ViewVC] Diff of: cvs/AnyEvent-HTTP/HTTP.pm

Comparing AnyEvent-HTTP/HTTP.pm (file contents):
Revision 1.44 by root, Tue Jul 7 00:15:32 2009 UTC vs.
Revision 1.45 by root, Fri Jul 17 16:56:36 2009 UTC

 This callback is useful when the data is too large to be held in memory
 (so the callback writes it to a file) or when only some information should
 be extracted, or when the body should be processed incrementally.
 It is usually preferred over doing your own body handling via
-C<want_body_handle>.
+C<want_body_handle>, but in case of streaming APIs, where HTTP is
+only used to create a connection, C<want_body_handle> is the better
+alternative, as it allows you to install your own event handler, reducing
+resource usage.
 =item want_body_handle => $enable
 When enabled (default is disabled), the behaviour of AnyEvent::HTTP
 changes considerably: after parsing the headers, and instead of
 This is useful with some push-type services, where, after the initial
 headers, an interactive protocol is used (typical example would be the
 push-style twitter API which starts a JSON/XML stream).
 If you think you need this, first have a look at C<on_body>, to see if
-that doesn'T solve your problem in a better way.
+that doesn't solve your problem in a better way.
 =back
 Example: make a simple HTTP GET request for http://www.nethype.de/

-–
+Removed lines
-+
+Added lines
-<
+Changed lines
->
+Changed lines