DOC: standardize rst markup

tacaswell · tacaswell · commit e65b5223b78e · 2020-06-09T13:51:33.000-04:00
diff --git a/doc/users/next_whats_new/2018-09-19-AL.rst b/doc/users/next_whats_new/2018-09-19-AL.rst
@@ -1,7 +1,5 @@
-:orphan:
-
 `matplotlib.rc_context` is now a `contextlib.contextmanager`
-````````````````````````````````````````````````````````````
+------------------------------------------------------------
 
 `matplotlib.rc_context` can now be used as a decorator (technically, it is now
 implemented as a `contextlib.contextmanager`), e.g. ::
diff --git a/doc/users/next_whats_new/2019-06-01-AL.rst b/doc/users/next_whats_new/2019-06-01-AL.rst
@@ -1,5 +1,5 @@
 GridSpec.subplots()
-```````````````````
+-------------------
 
 The `.GridSpec` class gained a `~.GridSpecBase.subplots` method, so that one
 can write ::
diff --git a/doc/users/next_whats_new/2019-06-25-AL.rst b/doc/users/next_whats_new/2019-06-25-AL.rst
@@ -1,2 +1,2 @@
 3D axes now support minor ticks
-```````````````````````````````
+-------------------------------
diff --git a/doc/users/next_whats_new/2019-07-31_axes-box-aspect.rst b/doc/users/next_whats_new/2019-07-31_axes-box-aspect.rst
@@ -1,4 +1,3 @@
-:orphan:
 
 Setting axes box aspect
 -----------------------
diff --git a/doc/users/next_whats_new/2019-10-18_rcParams-for-raise-window-behavior.rst b/doc/users/next_whats_new/2019-10-18_rcParams-for-raise-window-behavior.rst
@@ -1,8 +1,6 @@
-:orphan:
 
 rcParams for controlling default "raise window" behavior
 --------------------------------------------------------
 The new config option :rc:`figure.raise_window` allows to disable
 raising the plot window when calling `~.pyplot.show` or `~.pyplot.pause`.
 ``MacOSX`` backend is currently not supported.
-
diff --git a/doc/users/next_whats_new/2019-12-20-set_xy_position b/doc/users/next_whats_new/2019-12-20-set_xy_position
@@ -1,5 +1,6 @@
 Align labels to axes edges
 --------------------------
+
 `~.axes.Axes.set_xlabel`, `~.axes.Axes.set_ylabel` and `ColorbarBase.set_label`
 support a parameter ``loc`` for simplified positioning. Supported values are
 'left', 'center', or 'right'. The default is controlled via
diff --git a/doc/users/next_whats_new/2020-01-24-lateshare.rst b/doc/users/next_whats_new/2020-01-24-lateshare.rst
@@ -1,5 +1,6 @@
 `.Axes.sharex`, `.Axes.sharey`
 ------------------------------
+
 These new methods allow sharing axes *immediately* after creating them.  For
 example, they can be used to selectively link some axes created all together
 using `~.Figure.subplots`.
diff --git a/doc/users/next_whats_new/2020-01-25-clabel_zorder.rst b/doc/users/next_whats_new/2020-01-25-clabel_zorder.rst
@@ -1,5 +1,6 @@
 Set zorder of contour labels
 ----------------------------
+
 `~.axes.Axes.clabel` now accepts a ``zorder`` kwarg
 making it easier to set the ``zorder`` of contour labels.
 If not specified, the default ``zorder`` of clabels used to always be 3
diff --git a/doc/users/next_whats_new/2020-02-03-fontpath.rst b/doc/users/next_whats_new/2020-02-03-fontpath.rst
@@ -1,5 +1,5 @@
 Simple syntax to select fonts by absolute path
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+----------------------------------------------
 
 Fonts can now be selected by passing an absolute `pathlib.Path` to the *font*
 kwarg of `.Text`.
diff --git a/doc/users/next_whats_new/2020-02-24-mathtext-fallback.rst b/doc/users/next_whats_new/2020-02-24-mathtext-fallback.rst
@@ -1,5 +1,6 @@
 Add generalized "mathtext.fallback" rcParam
-------------------------------------------------------------------------
+-------------------------------------------
+
 New  "mathtext.fallback" rcParam. Takes "cm", "stix", "stixsans"
 or "none" to turn fallback off. "mathtext.fallback_to_cm" is
-deprecated, but if used, will override new fallback.
+deprecated, but if used, will override new fallback.
diff --git a/doc/users/next_whats_new/2020-03-05_markerstyle-for-lines.rst b/doc/users/next_whats_new/2020-03-05_markerstyle-for-lines.rst
@@ -1,7 +1,7 @@
 Lines now accept ``MarkerStyle`` instances as input
 ---------------------------------------------------
+
 Similar to `~.Axes.scatter`, `~.Axes.plot` and `~.lines.Line2D` now accept
 `~.markers.MarkerStyle` instances as input for the *marker* parameter::
 
     plt.plot(..., marker=matplotlib.markers.MarkerStyle("D"))
-
diff --git a/doc/users/next_whats_new/2020-03-06-auto-tick-formatters.rst b/doc/users/next_whats_new/2020-03-06-auto-tick-formatters.rst
@@ -1,5 +1,6 @@
 Allow tick formatters to be set with str or function inputs
-------------------------------------------------------------------------
+-----------------------------------------------------------
+
 `~.Axis.set_major_formatter` and `~.Axis.set_minor_formatter`
 now accept `str` or function inputs in addition to `~.ticker.Formatter`
 instances. For a `str` a `~.ticker.StrMethodFormatter` is automatically
diff --git a/doc/users/next_whats_new/2020-03-15-cursor-sigdigits.rst b/doc/users/next_whats_new/2020-03-15-cursor-sigdigits.rst
@@ -1,5 +1,5 @@
 Cursor text now uses a number of significant digits matching pointing precision
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+-------------------------------------------------------------------------------
 
 Previously, the x/y position displayed by the cursor text would usually include
 far more significant digits than the mouse pointing precision (typically one
diff --git a/doc/users/next_whats_new/2020-04-13-AL.rst b/doc/users/next_whats_new/2020-04-13-AL.rst
@@ -1,5 +1,6 @@
 `.backend_bases.key_press_handler` and `.backend_bases.button_press_handler` simplifications
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+--------------------------------------------------------------------------------------------
+
 These event handlers can now be directly connected to a canvas with
 ``canvas.mpl_connect("key_press_event", key_press_handler)`` and
 ``canvas.mpl_connect("button_press_event", button_press_handler)``, rather than
diff --git a/doc/users/next_whats_new/2020-04-14-title-yparam.rst b/doc/users/next_whats_new/2020-04-14-title-yparam.rst
@@ -1,8 +1,9 @@
 `~.axes.Axes.set_title` gains a y keyword argument to control auto positioning
 ------------------------------------------------------------------------------
+
 `~.axes.Axes.set_title` tries to auto-position the title to avoid any
 decorators on the top x-axis.  This is not always desirable so now
 *y* is an explicit keyword argument of `~.axes.Axes.set_title`.  It
 defaults to *None* which means to use auto-positioning.  If a value is
 supplied (i.e. the pre-3.0 default was ``y=1.0``) then auto-positioning is
-turned off.  This can also be set with the new rcParameter :rc:`axes.titley`.  
+turned off.  This can also be set with the new rcParameter :rc:`axes.titley`.
diff --git a/doc/users/next_whats_new/2020-04-22-suptitle-tl.rst b/doc/users/next_whats_new/2020-04-22-suptitle-tl.rst
@@ -1,2 +1,2 @@
 tight_layout now supports suptitle
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+----------------------------------
diff --git a/doc/users/next_whats_new/imshow_m_n_1.rst b/doc/users/next_whats_new/imshow_m_n_1.rst
@@ -1,5 +1,6 @@
 Imshow now coerces 3D arrays with depth 1 to 2D
 ------------------------------------------------
-Starting from this version arrays of size MxNx1 will be coerced into MxN 
-for displaying. This means commands like ``plt.imshow(np.random.rand(3, 3, 1))`` 
+
+Starting from this version arrays of size MxNx1 will be coerced into MxN
+for displaying. This means commands like ``plt.imshow(np.random.rand(3, 3, 1))``
 will no longer return an error message that the image shape is invalid.

Original file line number	Diff line number	Diff line change
`@@ -1,2 +1,2 @@`
`1`	`1`	`3D axes now support minor ticks`
`2`		-```````````````````````````````
	`2`	`+-------------------------------`
Original file line number	Diff line number	Diff line change
`@@ -1,4 +1,3 @@`
`1`		`-:orphan:`
`2`	`1`
`3`	`2`	`Setting axes box aspect`
`4`	`3`	`-----------------------`