Fixes for multiline doc descriotions breaking rst formatting

* strip whitespace to preserve indent level
* Make sure to indent subsequent lines of indentation

docs/bin/plugin_formatter.py

@@ -117,7 +117,7 @@ def html_ify(text):
     t = _CONST.sub(r"<code>\1</code>", t)
     t = _RULER.sub(r"<hr/>", t)
 
-    return t
+    return t.strip()
 
 
 def rst_fmt(text, fmt):

docs/templates/plugin.rst.j2

@@ -327,10 +327,10 @@ Common return values are documented :ref:`here <common_return_values>`, the foll
                 <td>
                     <div class="cell-border">
                         {% if value.description is string %}
-                            <div>@{ value.description | html_ify }@</div>
+                            <div>@{ value.description | html_ify |indent(4)}@</div>
                         {% else %}
                             {% for desc in value.description %}
-                                <div>@{ desc | html_ify }@</div>
+                                <div>@{ desc | html_ify |indent(4)}@</div>
                             {% endfor %}
                         {% endif %}
                         <br/>