no need to mention the kernel send buffer

mojolicious · Oct 14, 2011 · 8fd45e5 · 8fd45e5
1 parent 2633917
commit 8fd45e5
Show file tree

Hide file tree

Showing 3 changed files with 8 additions and 15 deletions.
diff --git a/lib/Mojo/Transaction/WebSocket.pm b/lib/Mojo/Transaction/WebSocket.pm
@@ -512,10 +512,8 @@ Resume transaction.
   $ws->send_message([$bytes]);
   $ws->send_message([$bytes], sub {...});
 
-Send a message non-blocking via WebSocket, encoding and framing will be
-handled transparently.
-The optional drain callback will be invoked once all data has been written to
-the kernel send buffer or equivalent.
+Send a message non-blocking via WebSocket, the optional drain callback will
+be invoked once all data has been written.
 
 =head2 C<server_handshake>
 

diff --git a/lib/Mojolicious/Controller.pm b/lib/Mojolicious/Controller.pm
@@ -947,10 +947,8 @@ Note that this method is EXPERIMENTAL and might change without warning!
   $c = $c->send_message([$bytes]);
   $c = $c->send_message([$bytes], sub {...});
 
-Send a message non-blocking via WebSocket, encoding and framing will be
-handled transparently.
-The optional drain callback will be invoked once all data has been written to
-the kernel send buffer or equivalent.
+Send a message non-blocking via WebSocket, the optional drain callback will
+be invoked once all data has been written.
 Note that this method is EXPERIMENTAL and might change without warning!
 
 =head2 C<session>
@@ -1043,8 +1041,7 @@ Generate a portable L<Mojo::URL> object with base for a route, path or URL.
   $c->write('Hello!', sub {...});
 
 Write dynamic content non-blocking, the optional drain callback will be
-invoked once all data has been written to the kernel send buffer or
-equivalent.
+invoked once all data has been written.
 
   # Keep connection alive (with Content-Length header)
   $c->res->headers->content_length(6);
@@ -1075,10 +1072,8 @@ timeout, which usually defaults to C<15> seconds.
   $c->write_chunk(sub {...});
   $c->write_chunk('Hello!', sub {...});
 
-Write dynamic content non-blocking with the C<chunked> transfer encoding,
-which doesn't require a C<Content-Length> header.
-The optional drain callback will be invoked once all data has been written to
-the kernel send buffer or equivalent.
+Write dynamic content non-blocking with the C<chunked> transfer encoding, the
+optional drain callback will be invoked once all data has been written.
 
   $c->write_chunk('He', sub {
     my $c = shift;

diff --git a/lib/Mojolicious/Guides/Cookbook.pod b/lib/Mojolicious/Guides/Cookbook.pod
@@ -339,7 +339,7 @@ Sending a streaming request is almost just as easy.
   $ua->start($tx);
 
 The drain callback passed to C<write> will be invoked whenever the entire
-previous chunk has been written to the kernel send buffer.
+previous chunk has actually been written.
 
 =head2 Large file downloads