From 80a9016636ea586f65f55f15b89e3802d6605cf9 Mon Sep 17 00:00:00 2001
From: Jan-Piet Mens <jpmens@gmail.com>
Date: Sun, 30 Sep 2012 13:20:24 +0200
Subject: [PATCH] module docs: fixed rst template - notes is now supported -
 multiline code examples are now supported (HTML rendering was off)

---
 hacking/templates/rst.j2 | 15 ++++++++++++---
 1 file changed, 12 insertions(+), 3 deletions(-)

diff --git a/hacking/templates/rst.j2 b/hacking/templates/rst.j2
index 6a2108a638f..f67e05339bc 100644
--- a/hacking/templates/rst.j2
+++ b/hacking/templates/rst.j2
@@ -18,7 +18,7 @@
 @{ desc | jpfunc }@ 
 {% endfor %}
 
-{% if options is defined -%}
+{% if options -%}
 .. raw:: html
 
     <table>
@@ -33,7 +33,7 @@
     <tr>
     <td>@{ k }@</td>
     <td>@{ v.get('required',False) }@</td>
-    <td>@{ v['default'] }@</td>
+    <td>{% if v['default'] %}@{ v['default'] }@{% endif %}</td>
     <td><ul>{% for choice in v.get('choices',[]) -%}<li>@{ choice }@</li>{% endfor -%}</ul></td>
     <td>{% for desc in v.description -%}@{ desc | html_ify }@{% endfor -%}</td>
     </tr>
@@ -46,8 +46,17 @@
 {% for example in examples %}
     {% if example['description'] %}<p>@{ example['description'] | html_ify }@</p>{% endif %}
     <p><pre>
-    @{ example['code'] }@</pre></p>
+    @{ example['code'] }@
+    </pre></p>
 {% endfor %}
     <br/>
 
+{% if notes %}
+.. raw:: html
+
+    <h4>Notes</h4>
+    {% for note in notes %}
+    <p>@{ note | html_ify }@</p>
+    {% endfor %}
+{% endif %}