Move arg and kwargs escaping to docscrape_sphinx

Author: has2k1

numpydoc/docscrape.py

@@ -199,14 +199,6 @@ def _read_to_next_section(self):
 
         return section
 
-    def _escape_args_and_kwargs(self, name):
-        if name[:2] == '**':
-            return r'\*\*' + name[2:]
-        elif name[:1] == '*':
-            return r'\*' + name[1:]
-        else:
-            return name
-
     def _read_sections(self):
         while not self._doc.eof():
             data = self._read_to_next_section()
@@ -229,7 +221,6 @@ def _parse_param_list(self, content):
             else:
                 arg_name, arg_type = header, ''
 
-            arg_name = self._escape_args_and_kwargs(arg_name)
             desc = r.read_to_next_unindented_line()
             desc = dedent_lines(desc)
             desc = strip_blank_lines(desc)

numpydoc/docscrape_sphinx.py

@@ -88,6 +88,14 @@ def _str_returns(self, name='Returns'):
                 out += ['']
         return out
 
+    def _escape_args_and_kwargs(self, name):
+        if name[:2] == '**':
+            return r'\*\*' + name[2:]
+        elif name[:1] == '*':
+            return r'\*' + name[1:]
+        else:
+            return name
+
     def _process_param(self, param, desc, fake_autosummary):
         """Determine how to display a parameter
 
@@ -122,7 +130,7 @@ def _process_param(self, param, desc, fake_autosummary):
         complicated to incorporate autosummary's signature mangling, as it
         relies on Sphinx's plugin mechanism.
         """
-        param = param.strip()
+        param = self._escape_args_and_kwargs(param.strip())
         # XXX: If changing the following, please check the rendering when param
         # ends with '_', e.g. 'word_'
         # See https://github.com/numpy/numpydoc/pull/144