some docstring reformatting and fixing

IPython/core/crashhandler.py

@@ -32,6 +32,8 b' from IPython.utils.py3compat import input'
 
 from IPython.core.release import __version__ as version
 
+from typing import Optional
+
 #-----------------------------------------------------------------------------
 # Code
 #-----------------------------------------------------------------------------
@@ -95,8 +97,15 b' class CrashHandler(object):'
     message_template = _default_message_template
     section_sep = '\n\n'+'*'*75+'\n\n'
 
-    def __init__(self, app, contact_name=None, contact_email=None,
-                 bug_tracker=None, show_crash_traceback=True, call_pdb=False):
+    def __init__(
+        self,
+        app,
+        contact_name: Optional[str] = None,
+        contact_email: Optional[str] = None,
+        bug_tracker: Optional[str] = None,
+        show_crash_traceback: bool = True,
+        call_pdb: bool = False,
+    ):
         """Create a new crash handler
 
         Parameters
@@ -113,10 +122,15 b' class CrashHandler(object):'
         show_crash_traceback : bool
             If false, don't print the crash traceback on stderr, only generate
             the on-disk report
-        Non-argument instance attributes
+        call_pdb
+            Whether to call pdb on crash
+
+        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.
+
         """
         self.crash_report_fname = "Crash_report_%s.txt" % app.name
         self.app = app

IPython/core/magic.py

@@ -115,13 +115,10 b' def record_magic(dct, magic_kind, magic_name, func):'
     ----------
     dct : dict
       A dictionary with 'line' and 'cell' subdicts.
-
     magic_kind : str
       Kind of magic to be stored.
-
     magic_name : str
       Key to store the magic as.
-
     func : function
       Callable object to store.
     """
@@ -387,7 +384,7 b' class MagicsManager(Configurable):'
 
         Parameters
         ----------
-        magic_objects : one or more classes or instances
+        *magic_objects : one or more classes or instances
         """
         # Start by validating them to ensure they have all had their magic
         # methods registered at the instance level
@@ -423,10 +420,8 b' class MagicsManager(Configurable):'
         ----------
         func : callable
           Function to be registered as a magic.
-
         magic_kind : str
           Kind of magic, one of 'line', 'cell' or 'line_cell'
-
         magic_name : optional str
           If given, the name the magic will have in the IPython namespace.  By
           default, the name of the function itself is used.
@@ -451,10 +446,8 b' class MagicsManager(Configurable):'
         ----------
         alias_name : str
           The name of the magic to be registered.
-
         magic_name : str
           The name of an existing magic.
-
         magic_kind : str
           Kind of magic, one of 'line' or 'cell'
         """
@@ -580,21 +573,16 b' class Magics(Configurable):'
 
         Parameters
         ----------
-
         arg_str : str
           The arguments to parse.
-
         opt_str : str
           The options specification.
-
         mode : str, default 'string'
           If given as 'list', the argument string is returned as a list (split
           on whitespace) instead of a string.
-
         list_all : bool, default False
           Put all option values in lists. Normally only options
           appearing more than once are put in a list.
-
         posix : bool, default True
           Whether to split the input line in POSIX mode or not, as per the
           conventions outlined in the :mod:`shlex` module from the standard

IPython/core/payloadpage.py

@@ -18,7 +18,6 b' def page(strng, start=0, screen_lines=0, pager_cmd=None):'
     ----------
     strng : str or mime-dict
       Text to page, or a mime-type keyed dict of already formatted data.
-
     start : int
       Starting line at which to place the display.
     """

IPython/core/pylabtools.py

@@ -241,7 +241,7 b' def select_figure_formats(shell, formats, **kwargs):'
     """Select figure formats for the inline backend.
 
     Parameters
-    ==========
+    ----------
     shell : InteractiveShell
         The main IPython instance.
     formats : str or set
@@ -408,7 +408,6 b' def configure_inline_support(shell, backend):'
     Parameters
     ----------
     shell : InteractiveShell instance
-
     backend : matplotlib backend
     """
     warnings.warn(

IPython/core/ultratb.py

@@ -556,7 +556,7 b' class ListTB(TBTools):'
         Parameters
         ----------
         etype : exception type
-        evalue : exception value
+        value : exception value
         """
         return ListTB.structured_traceback(self, etype, value)