- New tag: <%block>. A variant on <%def> that

  evaluates its contents in-place.
  Can be named or anonymous,
  the named version is intended for inheritance
  layouts where any given section can be
  surrounded by the <%block> tag in order for
  it to become overrideable by inheriting
  templates, without the need to specify a
  top-level <%def> plus explicit call.
  Modified scoping and argument rules as well as a
  more strictly enforced usage scheme make it ideal
  for this purpose without at all replacing most
  other things that defs are still good for.
  Lots of new docs. [ticket:164]

1 files changed, 9 insertions, 1 deletions

diff --git a/doc/build/caching.rst b/doc/build/caching.rst
index 6cf7197..19656c8 100644
--- a/doc/build/caching.rst
+++ b/doc/build/caching.rst
@@ -5,7 +5,7 @@ Caching
 ========
 
 Any template or component can be cached using the ``cache``
-argument to the ``<%page>`` or ``<%def>`` directives:
+argument to the ``<%page>``, ``<%def>`` or ``<%block>`` directives:
 
 .. sourcecode:: mako
 
@@ -32,6 +32,14 @@ The caching flag and all its options can be used with the
         other text
     </%def>
 
+... and equivalently with the ``<%block>`` tag, anonymous or named:
+
+.. sourcecode:: mako
+
+    <%block cached="True" cache_timeout="30" cache_type="memory">
+        other text
+    </%block>
+
 Cache arguments
 ================