Use new desc_parameterline instead of desc_content

Author: TLouf

sphinx/addnodes.py

@@ -249,6 +249,10 @@ def astext(self):
         return f'({super().astext()})'
 
 
+class desc_parameterline(nodes.General, nodes.Element):
+    """Node for a parameter line."""
+
+
 class desc_parameter(nodes.Part, nodes.Inline, nodes.FixedTextElement):
     """Node for a single parameter."""
 

sphinx/domains/c.py

@@ -725,7 +725,7 @@ def describe_signature(self, signode: TextElement, mode: str,
             paramlist = addnodes.desc_parameterlist()
             paramlist['is_multiline'] = multiline
             for arg in self.args:
-                param_node = addnodes.desc_content() if multiline else paramlist
+                param_node = addnodes.desc_parameterline() if multiline else paramlist
                 param = addnodes.desc_parameter('', '', noemph=True)
                 arg.describe_signature(param, 'param', env, symbol=symbol)
                 param_node += param

sphinx/domains/cpp.py

@@ -2136,7 +2136,7 @@ def describe_signature(self, signode: TextElement, mode: str,
             paramlist = addnodes.desc_parameterlist()
             paramlist['is_multiline'] = multiline
             for arg in self.args:
-                param_node = addnodes.desc_content() if multiline else paramlist
+                param_node = addnodes.desc_parameterline() if multiline else paramlist
                 param = addnodes.desc_parameter('', '', noemph=True)
                 arg.describe_signature(param, 'param', env, symbol=symbol)
                 param_node += param

sphinx/domains/python.py

@@ -259,7 +259,7 @@ def _parse_arglist(
     sig = signature_from_str('(%s)' % arglist)
     last_kind = None
     for param in sig.parameters.values():
-        param_node = addnodes.desc_content() if multiline else params
+        param_node = addnodes.desc_parameterline() if multiline else params
         if param.kind != param.POSITIONAL_ONLY and last_kind == param.POSITIONAL_ONLY:
             # PEP-570: Separator for Positional Only Parameter: /
             param_node += addnodes.desc_parameter('', '', addnodes.desc_sig_operator('', '/'))

sphinx/writers/html5.py

@@ -165,6 +165,12 @@ def depart_desc_parameterlist(self, node: Element) -> None:
             self.body.append('</dl>\n\n')
         self.body.append('<span class="sig-paren">)</span>')
 
+    def visit_desc_parameterline(self, node: Element) -> None:
+        self.body.append(self.starttag(node, 'dd', ''))
+
+    def depart_desc_parameterline(self, node: Element) -> None:
+        self.body.append('</dd>')
+
     # If required parameters are still to come, then put the comma after
     # the parameter.  Otherwise, put the comma before.  This ensures that
     # signatures like the following render correctly (see issue #1001):