Add newlines to make param list HTML prettier

Author: TLouf

sphinx/writers/_html4.py

@@ -152,11 +152,12 @@ def visit_desc_parameterlist(self, node: Element) -> None:
                                          for c in node.children])
         self.param_separator = node.child_text_separator
         if node.get('is_multi_line'):
+            self.body.append('\n\n')
             self.body.append(self.starttag(node, 'dl'))
 
     def depart_desc_parameterlist(self, node: Element) -> None:
         if node.get('is_multi_line'):
-            self.body.append('</dl>\n\n')
+            self.body.append('\n</dl>\n\n')
         self.body.append('<span class="sig-paren">)</span>')
 
     def visit_desc_parameter_line(self, node: Element) -> None:

sphinx/writers/html5.py

@@ -158,11 +158,12 @@ def visit_desc_parameterlist(self, node: Element) -> None:
                                          for c in node.children])
         self.param_separator = node.child_text_separator
         if node.get('is_multi_line'):
+            self.body.append('\n\n')
             self.body.append(self.starttag(node, 'dl'))
 
     def depart_desc_parameterlist(self, node: Element) -> None:
         if node.get('is_multi_line'):
-            self.body.append('</dl>\n\n')
+            self.body.append('\n</dl>\n\n')
         self.body.append('<span class="sig-paren">)</span>')
 
     def visit_desc_parameter_line(self, node: Element) -> None: