[1.2.X] Fixed #13020 - add clarifying note to SessionStore. thanks elbarto for the patch.

Backport of r15053 from trunk.

git-svn-id: http://code.djangoproject.com/svn/django/branches/releases/1.2.X@15054 bcc190cf-cafb-0310-a4f2-bffc1f526a37

1 files changed, 9 insertions, 0 deletions

diff --git a/docs/topics/http/sessions.txt b/docs/topics/http/sessions.txt
index 8a0f0d4b72..a1f70f3f57 100644
--- a/docs/topics/http/sessions.txt
+++ b/docs/topics/http/sessions.txt
@@ -307,12 +307,21 @@ Using sessions out of views
 An API is available to manipulate session data outside of a view::
 
     >>> from django.contrib.sessions.backends.db import SessionStore
+    >>> import datetime
     >>> s = SessionStore(session_key='2b1189a188b44ad18c35e113ac6ceead')
     >>> s['last_login'] = datetime.datetime(2005, 8, 20, 13, 35, 10)
     >>> s['last_login']
     datetime.datetime(2005, 8, 20, 13, 35, 0)
     >>> s.save()
 
+If ``session_key`` isn't provided, one will be generated automatically::
+
+    >>> from django.contrib.sessions.backends.db import SessionStore
+    >>> s = SessionStore()
+    >>> s.save()
+    >>> s.session_key
+    '2b1189a188b44ad18c35e113ac6ceead'
+
 If you're using the ``django.contrib.sessions.backends.db`` backend, each
 session is just a normal Django model. The ``Session`` model is defined in
 ``django/contrib/sessions/models.py``. Because it's a normal model, you can