Ticket #4914: 4914.2.patch

docs/sessions.txt

@@ -190 +190 @@
     # request.session['foo'] instead of request.session.
     request.session['foo']['bar'] = 'baz'
 
-To change this default behavior, set the ``SESSION_SAVE_EVERY_REQUEST`` setting
+To save the session explicitly, you can set ``request.session.modified`` to
+``True``::
+
+    # Session is not modified directly, so inform the session that it has changed.
+    request.session['foo']['bar'] = 'baz'
+    request.session.modified = True
+
+To change the default behavior of only saving to the session database when the
+session has been modified, set the ``SESSION_SAVE_EVERY_REQUEST`` setting
 to ``True``. If ``SESSION_SAVE_EVERY_REQUEST`` is ``True``, Django will save
 the session to the database on every single request.