document response.cache_expires and response.cache_control

[mmerickel]

response.cache_expires is a convenience method wrapping around response.cache_control.

response.cache_expires = 50 # seconds from now

response.cache_expires(seconds, **kw)

However, you can also mutate response.cache_control directly in several ways. For example, you can set it to a cache-control header string, or you can tweak properties on it directly.

response.cache_control = 'no-cache, must-revalidate'

response.cache_control.no_cache = True
response.cache_control.must_revalidate = True
response.cache_control.max_age = 50  # seconds from now

Anyway I always need to look this up so it'd be nice if it were documented better. They also interact in interesting ways if you use both.