bunch more docs

[catagits/Web-Session.git] / lib / Plack / Session.pm

diff --git a/lib/Plack/Session.pm b/lib/Plack/Session.pm
index 6473b27..7c0a60c 100644 (file)
--- a/lib/Plack/Session.pm
+++ b/lib/Plack/Session.pm
@@ -60,8 +60,23 @@ Plack::Session - Middleware for session management
 
   use Plack::Session;
 
+  my $store = Plack::Session::Store->new;
+  my $state = Plack::Session::State->new;
+
+  my $s = Plack::Session->new(
+      store   => $store,
+      state   => $state,
+      request => Plack::Request->new( $env )
+  );
+
+  # ...
+
 =head1 DESCRIPTION
 
+This is the core session object, you probably want to look
+at L<Plack::Middlware::Session>, unless you are writing your
+own session middleware component.
+
 =head1 METHODS
 
 =over 4
@@ -91,7 +106,8 @@ an object with an equivalent interface.
 
 =head2 Session Data Storage
 
-These methods delegate to appropriate methods on the C<store>.
+These methods delegate to appropriate methods on the C<store>
+to manage your session data.
 
 =over 4