summaryrefslogtreecommitdiff
path: root/docs
diff options
context:
space:
mode:
Diffstat (limited to 'docs')
-rw-r--r--docs/narr/sessions.rst7
1 files changed, 3 insertions, 4 deletions
diff --git a/docs/narr/sessions.rst b/docs/narr/sessions.rst
index 6a538766c..958ede7d6 100644
--- a/docs/narr/sessions.rst
+++ b/docs/narr/sessions.rst
@@ -222,10 +222,11 @@ Using the ``session.pop_flash`` Method
Once one or more messages have been added to a flash queue by the
``session.flash()`` API, the ``session.pop_flash()`` API can be used to
-pop that queue and return it for use.
+pop an entire queue and return it for use.
To pop a particular queue of messages from the flash object, use the session
-object's ``pop_flash()`` method.
+object's ``pop_flash()`` method. This returns a list of the messages
+that were added to the flash queue, and empties the queue.
.. method:: pop_flash(queue='')
@@ -249,8 +250,6 @@ been popped.
>>> request.session.pop_flash()
[]
-The object returned from ``pop_flash()`` is a list.
-
Using the ``session.peek_flash`` Method
~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~