Merge pull request matplotlib#22899 from matplotlib/doccleanup

Fix documentation markup issues

Author: timhoffm

doc/api/next_api_changes/removals/22107-OG.rst

@@ -2,6 +2,7 @@ Removal of deprecated ``mathtext`` APIs
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The following `matplotlib.mathtext` APIs have been removed:
+
 - ``Fonts`` and all its subclasses,
 - ``FontConstantsBase`` and all its subclasses,
 - ``Node`` and all its subclasses,
@@ -18,15 +19,19 @@ Removal of various ``mathtext`` helpers
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The following `matplotlib.mathtext` classes:
+
 - ``MathtextBackendPdf``,
 - ``MathtextBackendPs``,
 - ``MathtextBackendSvg``,
 - ``MathtextBackendCairo``,
+
 and the ``.mathtext_parser`` attributes on
+
 - `.RendererPdf`,
 - `.RendererPS`,
 - `.RendererSVG`,
 - `.RendererCairo`
+
 have been removed. The `.MathtextBackendPath` class can be used instead.
 
 The methods ``get_depth``, ``parse``, ``to_mask``, ``to_rgba``, and ``to_png``

doc/devel/MEP/MEP27.rst

@@ -13,9 +13,11 @@ Status
 Branches and Pull requests
 ==========================
 Main PR (including GTK3):
+
 + https://github.com/matplotlib/matplotlib/pull/4143
 
 Backend specific branch diffs:
+
 + https://github.com/OceanWolf/matplotlib/compare/backend-refactor...OceanWolf:backend-refactor-tkagg
 + https://github.com/OceanWolf/matplotlib/compare/backend-refactor...OceanWolf:backend-refactor-qt
 + https://github.com/OceanWolf/matplotlib/compare/backend-refactor...backend-refactor-wx
@@ -49,15 +51,14 @@ Two main places for generic code appear in the classes derived from
 
 1. ``FigureManagerBase`` has **three** jobs at the moment:
 
-    1. The documentation describes it as a *``Helper class for pyplot
-       mode, wraps everything up into a neat bundle''*
+    1. The documentation describes it as a *Helper class for pyplot
+       mode, wraps everything up into a neat bundle*
     2. But it doesn't just wrap the canvas and toolbar, it also does
        all of the windowing tasks itself.  The conflation of these two
-       tasks gets seen the best in the following line: ```python
-       self.set_window_title("Figure %d" % num) ``` This combines
+       tasks gets seen the best in the following line:
+       ``self.set_window_title("Figure %d" % num)`` This combines
        backend specific code ``self.set_window_title(title)`` with
        matplotlib generic code ``title = "Figure %d" % num``.
-
     3. Currently the backend specific subclass of ``FigureManager``
        decides when to end the mainloop.  This also seems very wrong
        as the figure should have no control over the other figures.
@@ -95,7 +96,7 @@ The description of this MEP gives us most of the solution:
    1. This allows us to break up the conversion of backends into
       separate PRs as we can keep the existing ``FigureManagerBase``
       class and its dependencies intact.
-   2. and this also anticipates MEP22 where the new
+   2. And this also anticipates MEP22 where the new
       ``NavigationBase`` has morphed into a backend independent
       ``ToolManager``.
 

doc/users/explain/interactive_guide.rst

@@ -431,10 +431,10 @@ method.  The source for the ``prompt_toolkit`` input hooks lives at
 .. rubric:: Footnotes
 
 .. [#f1] A limitation of this design is that you can only wait for one
-	 input, if there is a need to multiplex between multiple sources
-	 then the loop would look something like ::
+     input, if there is a need to multiplex between multiple sources
+     then the loop would look something like ::
 
-	   fds = [...]
+       fds = [...]
            while True:                    # Loop
                inp = select(fds).read()   # Read
                eval(inp)                  # Evaluate / Print
@@ -443,6 +443,6 @@ method.  The source for the ``prompt_toolkit`` input hooks lives at
          <https://www.youtube.com/watch?v=ZzfHjytDceU>`__ if you must.
 
 .. [#f3] These examples are aggressively dropping many of the
-	 complexities that must be dealt with in the real world such as
-	 keyboard interrupts, timeouts, bad input, resource
-	 allocation and cleanup, etc.
+     complexities that must be dealt with in the real world such as
+     keyboard interrupts, timeouts, bad input, resource
+     allocation and cleanup, etc.