Added documentation for NoTileLeftBehind and bumped version to 1.8.0

geoiq · Mar 24, 2011 · bba77cd · bba77cd
1 parent 5b13a4b
commit bba77cd
Show file tree

Hide file tree

Showing 3 changed files with 14 additions and 1 deletion.
diff --git a/API.html b/API.html
@@ -1036,6 +1036,16 @@ <h3><a id="custom-providers" name="custom-providers">Providers</a></h3>
     raise NotImplementedError
 </pre>
 
+<p>
+In cases where a provider generates a response that should not be cached,
+<code>renderTile</code> and <code>renderArea</code> may raise the
+<a href="http://tilestache.org/doc/TileStache.Core.html#NoTileLeftBehind">Core.NoTileLeftBehind</a>
+exception in lieu of a normal response. The exception is constructed using the
+intended response object, but nothing will be written to cache. This feature
+might useful in cases where a full tileset is being rendered for static
+hosting, and you don’t want millions of identical ocean tiles.
+</p>
+
 <p>
 See
 <a href="http://tilestache.org/doc/TileStache.Providers.html">TileStache.Providers</a>

diff --git a/CHANGELOG b/CHANGELOG
@@ -1,3 +1,6 @@
+2011-03-24: 1.8.0
+- Added new Core.NoTileLeftBehind exception class to suppress result caching.
+
 2011-03-17: 1.7.4
 - Fixed use of "layers.get(name)" to "name in layers" in WSGI server.
 - Made possible to build Composite docs without numpy or sympy.

diff --git a/VERSION b/VERSION
@@ -1 +1 @@
-1.7.4
+1.8.0