[ZDP] BackTalk to Document The Zope Book (2.5 Edition)/Using Basic Zope Objects

[nobody@nowhere.com]

A comment to the paragraph below was recently added via http://www.zope.org/Documentation/Books/ZopeBook/current/BasicObject.stx#3-225

---------------

      For now, leave all of these entries as is, they are good,
      reasonable defaults.  That's all there is to setting up a cache
      manager!

        % Anonymous User - Sep. 12, 2002 11:38 am:
         A description should be given of how the REQUEST variables
         are used as keys (eg. how to use form data/query strings
         as part of the key).  

         /path/to/url?month=Jan should not hit /pth/to/url?month=Feb in the cache.

        % Anonymous User - Sep. 12, 2002 11:48 am:
         Normally query string parameters can be placed directly into the 
         "REQUEST variables" area.  For example, with the following request:
         http://www.zope.org/stuff?month=Jan&day=23
         if the "REQUEST variables" area has a single line "month" (instead of
         the default "AUTHENTICATED_USER"), then
         a single "Path" will show up in the Statistics page; however, there
         will be a different entry accounted for in the "Entries" column
         of the statistics page: one for each distinct month value that
         has been cached.  No distinction will be made upon the "day" query
         string (unless an additional line is given for "day" in the "REQUEST
         variables" area).

         Note that if a Zope directory houses an "index_html" file, and the
         URL does not explicity give the "index_html" (i.e. http://www.zope.org/path?month=xxx instead of
         http://www.zope.org/index_html?month=xxx), then
         the query string will not be able to serve as a key for the cache manager.
         Therefore, if you want to cache index_html, keying on query strings, then
         you must give fully qualified paths to the .../index_html object rather
         than assuming index_html as the default.