From: Tim Starling <tstarling@wikimedia.org>
Date: Tue, 12 Mar 2013 00:32:54 +0000 (+1100)
Subject: Rewrite user_touched comment, since apparently it is not clear enough
X-Git-Tag: 1.31.0-rc.0~20384
X-Git-Url: http://git.cyclocoop.org/%22.%24image2.%22?a=commitdiff_plain;h=bf4c2fb7d6407e37189d6d473b566c4fa021dd4a;p=lhc%2Fweb%2Fwiklou.git

Rewrite user_touched comment, since apparently it is not clear enough

Change-Id: Ib993e5a6dc56963e9afbbdc2ada77762e1594f0b
---

diff --git a/maintenance/tables.sql b/maintenance/tables.sql
index 97d6ff20f7..a9177838fb 100644
--- a/maintenance/tables.sql
+++ b/maintenance/tables.sql
@@ -86,10 +86,12 @@ CREATE TABLE /*_*/user (
   -- Same with passwords.
   user_email tinytext NOT NULL,
 
-  -- This is a timestamp which is updated when a user
-  -- logs in, logs out, changes preferences, or performs
-  -- some other action requiring HTML cache invalidation
-  -- to ensure that the UI is updated.
+  -- If the browser sends an If-Modified-Since header, a 304 response is
+  -- suppressed if the value in this field for the current user is later than
+  -- the value in the IMS header. That is, this field is an invalidation timestamp
+  -- for the browser cache of logged-in users. Among other things, it is used
+  -- to prevent pages generated for a previously logged in user from being
+  -- displayed after a session expiry followed by a fresh login.
   user_touched binary(14) NOT NULL default '',
 
   -- A pseudorandomly generated value that is stored in