X-Git-Url: http://git.shadowcat.co.uk/gitweb/gitweb.cgi?a=blobdiff_plain;f=lib%2FCatalyst%2FPlugin%2FSession.pm;h=6422027697c89c80ee5c1ec60d0648266ccab087;hb=a92c8aeb312680dba7b44855e78d7554a0ed3485;hp=55c5b6fa6724d60ea334f013a5e5a1ddacfce502;hpb=3f1824687bb8b5afd7835e0597359fe0fd078b00;p=catagits%2FCatalyst-Plugin-Session.git

diff --git a/lib/Catalyst/Plugin/Session.pm b/lib/Catalyst/Plugin/Session.pm
index 55c5b6f..6422027 100644
--- a/lib/Catalyst/Plugin/Session.pm
+++ b/lib/Catalyst/Plugin/Session.pm
@@ -384,6 +384,26 @@ dumped objects if session ID is defined.
 
 =back
 
+=head1 USING SESSIONS DURING PREPARE
+
+The earliest point in time at which you may use the session data is after
+L<Catalyst::Plugin::Session>'s C<prepare_action> has finished.
+
+State plugins must set $c->session ID before C<prepare_action>, and during
+C<prepare_action> L<Catalyst::Plugin::Session> will actually load the data from
+the store.
+
+	sub prepare_action {
+		my $c = shift;
+
+		# don't touch $c->session yet!
+		
+		$c->NEXT::prepare_action( @_ );
+
+		$c->session;  # this is OK
+		$c->sessionid; # this is also OK
+	}
+
 =head1 CONFIGURATION
 
     $c->config->{session} = {