- New environment setting ``PYRAMID_PREVENT_HTTP_CACHE`` and new

  configuration file value ``prevent_http_cache``.  These are synomymous and
  allow you to prevent HTTP cache headers from being set by Pyramid's
  ``http_cache`` machinery globally in a process.  see the "Influencing HTTP
  Caching" section of the "View Configuration" narrative chapter and the
  detailed documentation for this setting in the "Environment Variables and
  Configuration Settings" narrative chapter.

- New documentation section in View Configuration narrative chapter:
  "Influencing HTTP Caching".

1 files changed, 19 insertions, 0 deletions

diff --git a/docs/narr/environment.rst b/docs/narr/environment.rst
index a57b316e1..7f8e3953d 100644
--- a/docs/narr/environment.rst
+++ b/docs/narr/environment.rst
@@ -117,6 +117,25 @@ this value is true.  See also :ref:`debug_routematch_section`.
 |                                 |                             |
 +---------------------------------+-----------------------------+
 
+.. _preventing_http_caching:
+
+Preventing HTTP Caching
+------------------------
+
+Prevent the ``http_cache`` view configuration argument from having any effect
+globally in this process when this value is true.  No http caching-related
+response headers will be set by the Pyramid ``http_cache`` view configuration
+feature when this is true.  See also :ref:`influencing_http_caching`.
+
++---------------------------------+-----------------------------+
+| Environment Variable Name       | Config File Setting Name    |
++=================================+=============================+
+| ``PYRAMID_PREVENT_HTTP_CACHE``  |  ``prevent_http_cache``     |
+|                                 |                             |
+|                                 |                             |
+|                                 |                             |
++---------------------------------+-----------------------------+
+
 Debugging All
 -------------