@@ -137,13 +137,15 @@ You can also store small messages that will only be available for the very
 next request::
 
 // store a message for the very next request (in a controller)
-$session->setFlash('notice', 'Congratulations, your action succeeded!');
+$session->getFlashBag()->set('notice', 'Congratulations, your action succeeded!');
 
 // display the message back in the next request (in a template)
-{{ app.session.flash('notice') }}
+{{ app.session.flashBag.get('notice') }}
 
 This is useful when you need to set a success message before redirecting
-the user to another page (which will then show the message).
+the user to another page (which will then show the message). Please note that
+when you use has() instead of get(), the flash message will not be cleared and
+thus remain available during following requests.
 
 Securing Resources
 ------------------