summary refs log tree commit homepage
diff options
context:
space:
mode:
authorEric Wong <normalperson@yhbt.net>2010-06-14 08:33:55 +0000
committerEric Wong <normalperson@yhbt.net>2010-06-14 08:33:55 +0000
commit43175d4fe36f91a28563a8cbf46160ee076de31c (patch)
treec858cc8f7ba9fbe1d7f8607847a285ade6ca7d0a
parentdbcbbe566b6745e6ff8b1a56218bdc0999810902 (diff)
Rack 1.2 removed the +size+ method requirement, but we'll
still support it since Rack 1.2 doesn't _prohibit_ it, and
Rack 1.[01] applications will continue to exist for a while.
-rw-r--r--lib/unicorn/tee_input.rb6
1 files changed, 6 insertions, 0 deletions
diff --git a/lib/unicorn/tee_input.rb b/lib/unicorn/tee_input.rb
index 963414b..8ff7258 100644
--- a/lib/unicorn/tee_input.rb
+++ b/lib/unicorn/tee_input.rb
@@ -39,6 +39,12 @@ module Unicorn
     # For Transfer-Encoding:chunked requests, this requires consuming
     # all of the input stream before returning since there's no other
     # way to determine the size of the request body beforehand.
+    #
+    # This method is no longer part of the Rack specification as of
+    # Rack 1.2, so its use is not recommended.  This method only exists
+    # for compatibility with Rack applications designed for Rack 1.1 and
+    # earlier.  Most applications should only need to call +read+ with a
+    # specified +length+ in a loop until it returns +nil+.
     def size
       len and return len