X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FPlack%2FSession.pm;h=6473b27849f2445f71650114473dfa8f347e7899;hb=43f34c01a20c9f5b05bd43532d4b564fe6bd4817;hp=223cf372f214fc899c9bd57d29d7f8ea4f621052;hpb=05b5f99d2078fb14c9338621b182cfb5d7858678;p=catagits%2FWeb-Session.git

diff --git a/lib/Plack/Session.pm b/lib/Plack/Session.pm
index 223cf37..6473b27 100644
--- a/lib/Plack/Session.pm
+++ b/lib/Plack/Session.pm
@@ -68,14 +68,31 @@ Plack::Session - Middleware for session management
 
 =item B<new ( %params )>
 
+The constructor expects keys in C<%params> for I<state>,
+I<store> and I<request>. The I<request> param is expected to be
+a L<Plack::Request> instance or an object with an equivalent
+interface.
+
 =item B<id>
 
+This is the accessor for the session id.
+
 =item B<state>
 
+This is expected to be a L<Plack::Session::State> instance or
+an object with an equivalent interface.
+
 =item B<store>
 
+This is expected to be a L<Plack::Session::Store> instance or
+an object with an equivalent interface.
+
 =back
 
+=head2 Session Data Storage
+
+These methods delegate to appropriate methods on the C<store>.
+
 =over 4
 
 =item B<get ( $key )>
@@ -86,12 +103,25 @@ Plack::Session - Middleware for session management
 
 =back
 
+=head2 Session Lifecycle Management
+
 =over 4
 
 =item B<expire>
 
+This method can be called to expire the current session id. It
+will call the C<cleanup> method on the C<store> and the C<finalize>
+method on the C<state>, passing both of them the session id and
+the C<$response>.
+
 =item B<finalize ( $response )>
 
+This method should be called at the end of the response cycle. It
+will call the C<persist> method on the C<store> and the
+C<expire_session_id> method on the C<state>, passing both of them
+the session id. The C<$response> is expected to be a L<Plack::Response>
+instance or an object with an equivalent interface.
+
 =back
 
 =head1 BUGS