Updated Intro.pod
[catagits/Catalyst-Runtime.git] / lib / Catalyst / Response.pm
index 6f8b5c6..a6fbf0f 100644 (file)
@@ -24,7 +24,6 @@ Catalyst::Response - Catalyst Response Class
     $res->content_length;
     $res->content_type;
     $res->cookies;
-    $res->handle;
     $res->header;
     $res->headers;
     $res->output;
@@ -63,31 +62,32 @@ Shortcut to $res->headers->content_type
 
 =item $res->cookies
 
-Returns a reference to a hash containing the cookies to be set.
+Returns a reference to a hash containing the cookies to be set. The keys of the
+hash are the cookies' names, and their corresponding values are hash references
+used to construct L<CGI::Cookie> object.
 
     $c->response->cookies->{foo} = { value => '123' };
 
-=item $res->handle
+The values correspond to the L<CGI::Cookie> parameters of the same name, except
+they are used without a leading dash.
 
-Response IO handle.
+The proxied parameters are
 
-=cut
+=over 4
 
-sub handle {
-    my ( $self, $handle ) = @_;
-    
-    if ($handle) { 
-        $self->{handle} = $handle;
-    }
-    else {
-        # Finalize headers if someone touches the output handle
-        if ( $self->{_context} ) {
-            $self->{_context}->finalize_headers;
-        }
-    }
-    
-    return $self->{handle};
-}
+=item value
+
+=item expires
+
+=item domain
+
+=item path
+
+=item secure
+
+=item 
+
+=back
 
 =item $res->header