Pass multiline as desc_parameterlist attribute

Author: TLouf

sphinx/addnodes.py

@@ -243,10 +243,6 @@ class desc_parameterlist(nodes.Part, nodes.Inline, nodes.FixedTextElement):
     """Node for a general parameter list."""
     child_text_separator = ', '
 
-    def __init__(self, *args: Any, multiline: bool = False, **kwargs: Any) -> None:
-        super().__init__(*args, **kwargs)
-        self.multiline = multiline
-
     def astext(self):
         return f'({super().astext()})'
 

sphinx/domains/c.py

@@ -721,7 +721,8 @@ def describe_signature(self, signode: TextElement, mode: str,
         multiline = self.multiline
         # only use the desc_parameterlist for the outer list, not for inner lists
         if mode == 'lastIsName':
-            paramlist = addnodes.desc_parameterlist(multiline=multiline)
+            paramlist = addnodes.desc_parameterlist()
+            paramlist['is_multiline'] = multiline
             for arg in self.args:
                 param_node = addnodes.desc_content() if multiline else paramlist
                 param = addnodes.desc_parameter('', '', noemph=True)

sphinx/domains/cpp.py

@@ -2133,7 +2133,8 @@ def describe_signature(self, signode: TextElement, mode: str,
         multiline = self.multiline
         # only use the desc_parameterlist for the outer list, not for inner lists
         if mode == 'lastIsName':
-            paramlist = addnodes.desc_parameterlist(multiline=multiline)
+            paramlist = addnodes.desc_parameterlist()
+            paramlist['is_multiline'] = multiline
             for arg in self.args:
                 param_node = addnodes.desc_content() if multiline else paramlist
                 param = addnodes.desc_parameter('', '', noemph=True)

sphinx/domains/python.py

@@ -228,7 +228,8 @@ def _parse_arglist(
     arglist: str, env: Optional[BuildEnvironment] = None, multiline=False
 ) -> addnodes.desc_parameterlist:
     """Parse a list of arguments using AST parser"""
-    params = addnodes.desc_parameterlist(multiline=multiline)
+    params = addnodes.desc_parameterlist()
+    params['is_multiline'] = multiline
     sig = signature_from_str('(%s)' % arglist)
     last_kind = None
     for param in sig.parameters.values():

sphinx/writers/html5.py

@@ -155,11 +155,11 @@ def visit_desc_parameterlist(self, node: Element) -> None:
         self.required_params_left = sum([isinstance(c, addnodes.desc_parameter)
                                          for c in node.children])
         self.param_separator = node.child_text_separator
-        if node.multiline:
+        if node.get('is_multiline'):
             self.body.append(self.starttag(node, 'dl'))
 
     def depart_desc_parameterlist(self, node: Element) -> None:
-        if node.multiline:
+        if node.get('is_multiline'):
             self.body.append('</dl>\n\n')
         self.body.append('<span class="sig-paren">)</span>')