From 837f6176272e8599ad689b2c10cbe610d5ecc0a8 Mon Sep 17 00:00:00 2001
From: TommyC81 <tommyc81@gmail.com>
Date: Fri, 29 Jun 2012 21:42:06 +0300
Subject: [PATCH] Re-organized and added some more help on the reflash() and
 keep() functions.

---
 laravel/documentation/session/usage.md | 27 ++++++++++++++++++++++----
 1 file changed, 23 insertions(+), 4 deletions(-)

diff --git a/laravel/documentation/session/usage.md b/laravel/documentation/session/usage.md
index 5f9aad56..b390b75e 100644
--- a/laravel/documentation/session/usage.md
+++ b/laravel/documentation/session/usage.md
@@ -5,6 +5,7 @@ ## Contents
 - [Storing Items](#put)
 - [Retrieving Items](#get)
 - [Removing Items](#forget)
+- [Flashing Items](#flash)
 - [Regeneration](#regeneration)
 
 <a name="put"></a>
@@ -16,10 +17,6 @@ ## Storing Items
 
 The first parameter is the **key** to the session item. You will use this key to retrieve the item from the session. The second parameter is the **value** of the item.
 
-The **flash** method stores an item in the session that will expire after the next request. It's useful for storing temporary data like status or error messages:
-
-	Session::flash('status', 'Welcome Back!');
-
 <a name="get"></a>
 ## Retrieving Items
 
@@ -53,6 +50,28 @@ ## Removing Items
 
 	Session::flush();
 
+<a name="flash"></a>
+## Flashing Items
+
+The **flash** method stores an item in the session that will expire after the next request. It's useful for storing temporary data like status or error messages:
+
+	Session::flash('status', 'Welcome Back!');
+	
+Flash items that are expring in subsequent requests can be retained for another request by using one of the following methods:
+
+Retain all items for another request:
+
+	Session::reflash();
+	
+Retain an individual item for another request:
+	
+	Session::keep('status');
+	
+Retain several items for another request:
+	
+	Session::keep(array('status', 'other_item'));
+
+
 <a name="regeneration"></a>
 ## Regeneration