DOC: Some more autoformatting of docstrings.

Trying to head toward 100% of DocString autoformatted in IPython and
fixing issues in velin when I find cases that are wrong.

IPython/__init__.py

@@ -80,8 +80,7 b' def embed_kernel(module=None, local_ns=None, **kwargs):'
         The module to load into IPython globals (default: caller)
     local_ns : dict, optional
         The namespace to load into IPython user namespace (default: caller)
-    
-    kwargs : various, optional
+    **kwargs : various, optional
         Further keyword args are relayed to the IPKernelApp constructor,
         allowing configuration of the Kernel.  Will only have an effect
         on the first embed_kernel call for a given process.
@@ -112,13 +111,12 b' def start_ipython(argv=None, **kwargs):'
     
     Parameters
     ----------
-    
     argv : list or None, optional
         If unspecified or None, IPython will parse command-line options from sys.argv.
         To prevent any command-line parsing, pass an empty list: `argv=[]`.
     user_ns : dict, optional
         specify this dictionary to initialize the IPython user namespace with particular values.
-    kwargs : various, optional
+    **kwargs : various, optional
         Any other kwargs will be passed to the Application constructor,
         such as `config`.
     """
@@ -138,13 +136,12 b' def start_kernel(argv=None, **kwargs):'
     
     Parameters
     ----------
-    
     argv : list or None, optional
         If unspecified or None, IPython will parse command-line options from sys.argv.
         To prevent any command-line parsing, pass an empty list: `argv=[]`.
     user_ns : dict, optional
         specify this dictionary to initialize the IPython user namespace with particular values.
-    kwargs : various, optional
+    **kwargs : various, optional
         Any other kwargs will be passed to the Application constructor,
         such as `config`.
     """

IPython/core/completer.py

@@ -763,11 +763,11 b' def match_dict_keys(keys: List[Union[str, bytes, Tuple[Union[str, bytes]]]], pre'
 
     Parameters
     ----------
-    keys:
+    keys
         list of keys in dictionary currently being completed.
-    prefix:
+    prefix
         Part of the text already typed by the user. E.g. `mydict[b'fo`
-    delims:
+    delims
         String of delimiters to consider when finding the current key.
     extra_prefix: optional
         Part of the text already typed in multi-key index cases. E.g. for
@@ -993,7 +993,7 b' def _formatparamchildren(parameter) -> str:'
 
     Parameters
     ----------
-    parameter:
+    parameter
         Jedi's function `Param`
 
     Returns

IPython/core/crashhandler.py

@@ -104,22 +104,16 b' class CrashHandler(object):'
         app :  Application
             A running :class:`Application` instance, which will be queried at
             crash time for internal information.
-
         contact_name : str
             A string with the name of the person to contact.
-
         contact_email : str
             A string with the email address of the contact.
-
         bug_tracker : str
             A string with the URL for your project's bug tracker.
-
         show_crash_traceback : bool
             If false, don't print the crash traceback on stderr, only generate
             the on-disk report
-
-        Non-argument instance attributes:
-
+        Non-argument instance attributes
         These instances contain some non-argument attributes which allow for
         further customization of the crash handler's behavior. Please see the
         source for further details.

IPython/core/debugger.py

@@ -109,7 +109,6 b' class Tracer(object):'
 
         Parameters
         ----------
-
         colors : str, optional
             The name of the color scheme to use, it must be one of IPython's
             valid color schemes.  If not given, the function will default to

IPython/core/display_functions.py

@@ -133,12 +133,11 b' def display('
     clear : bool, optional
         Should the output area be cleared before displaying anything? If True,
         this will wait for additional output before clearing. [default: False]
-    kwargs: additional keyword-args, optional
+    **kwargs : additional keyword-args, optional
         Additional keyword-arguments are passed through to the display publisher.
 
     Returns
     -------
-
     handle: DisplayHandle
         Returns a handle on updatable displays for use with :func:`update_display`,
         if `display_id` is given. Returns :any:`None` if no `display_id` is given
@@ -146,7 +145,6 b' def display('
 
     Examples
     --------
-
     >>> class Json(object):
     ...     def __init__(self, json):
     ...         self.json = json
@@ -185,12 +183,10 b' def display('
 
     See Also
     --------
-
     :func:`update_display`
 
     Notes
     -----
-
     In Python, objects can declare their textual representation using the
     `__repr__` method. IPython expands on this idea and allows objects to declare
     other, rich representations including:
@@ -300,15 +296,13 b' def update_display(obj, *, display_id, **kwargs):'
 
     Parameters
     ----------
-
-    obj:
+    obj
         The object with which to update the display
     display_id: keyword-only
         The id of the display to update
 
     See Also
     --------
-
     :func:`display`
     """
     kwargs['update'] = True
@@ -343,10 +337,9 b' class DisplayHandle(object):'
 
         Parameters
         ----------
-
-        obj:
+        obj
             object to display
-        **kwargs:
+        **kwargs
             additional keyword arguments passed to display
         """
         display(obj, display_id=self.display_id, **kwargs)
@@ -356,10 +349,9 b' class DisplayHandle(object):'
 
         Parameters
         ----------
-
-        obj:
+        obj
             object to display
-        **kwargs:
+        **kwargs
             additional keyword arguments passed to update_display
         """
         update_display(obj, display_id=self.display_id, **kwargs)