document the cookies restriction with multiple values

plack · Sep 21, 2012 · 354d03e · 354d03e
1 parent 55e7374
commit 354d03e
Showing 1 changed file with 6 additions and 0 deletions.
diff --git a/lib/Plack/Request.pm b/lib/Plack/Request.pm
@@ -435,6 +435,12 @@ using:
 Returns a reference to a hash containing the cookies. Values are
 strings that are sent by clients and are URI decoded.
 
+If there are multiple cookies with the same name in the request, this
+method will ignore the duplicates and return only the first value. If
+that causes issus for you, you may have to use modules like
+CGI::Simple::Cookie to parse C<$request->header('Cookies')> by
+yourself.
+
 =item query_parameters
 
 Returns a reference to a hash containing query string (GET)