Making the template docs better.

1 files changed, 26 insertions, 1 deletions

diff --git a/docs/source/templates.rst b/docs/source/templates.rst
index d0d5bf2..7ba33e1 100644
--- a/docs/source/templates.rst
+++ b/docs/source/templates.rst
@@ -14,7 +14,15 @@ supports the following templating engines:
  * `JSON`
 
 The default template system is `mako`, but can be configured by passing the 
-``default_renderer`` key in your app configuration.
+``default_renderer`` key in your app configuration::
+    
+    app = {
+        'default_renderer' : 'kajiki',
+        # ...
+    }
+
+The available renderer type strings are `mako`, `genshi`, `kajiki`, `jinja`, 
+and `json`.
 
 
 Using Renderers
@@ -47,6 +55,23 @@ templating. The first is ``override_template``, which allows you to overrides
 which template is used in your controller, and the second is ``render``, which
 allows you to manually render output using the Pecan templating framework.
 
+To use ``override_template``, simply call it within the body of your controller
+
+::
+
+    class MyController(object):
+        @expose('template_one.html')
+        def index(self):
+            # ...
+            override_template('template_two.html')
+            return dict(message='I will now render with template_two.html')
+
+The ``render`` helper is also quite simple to use::
+
+    @expose()
+    def controller(self):
+        return render('my_template.html', dict(message='I am the namespace'))
+
 
 The JSON Renderer
 -----------------