Move more top level headings to the top

dstansby · tacaswell · commit 2fc70a42fee1 · 2019-04-14T15:51:08.000-04:00
diff --git a/doc/api/prev_api_changes/api_changes_3.1.0.rst b/doc/api/prev_api_changes/api_changes_3.1.0.rst
@@ -1,6 +1,60 @@
 API Changes for 3.1.0
 =====================
 
+Exception changes
+-----------------
+
+- `mpl_toolkits.axes_grid1.axes_size.GetExtentHelper` now raises `ValueError`
+  for invalid directions instead of `KeyError`.
+
+Removals
+--------
+
+The following deprecated APIs have been removed:
+
+Classes and methods
+~~~~~~~~~~~~~~~~~~~
+- ``Verbose`` (replaced by python logging library)
+- ``artist.Artist.hitlist`` (no replacement)
+- ``artist.Artist.is_figure_set`` (use ``artist.figure is not None`` instead)
+- ``axis.Axis.unit_data`` (use ``axis.Axis.units`` instead)
+- ``backend_bases.FigureCanvasBase.onRemove`` (no replacement)
+  ``backend_bases.FigureManagerBase.show_popup`` (this never did anything)
+- ``backend_wx.SubplotToolWx`` (no replacement)
+- ``backend_wx.Toolbar`` (use ``backend_wx.NavigationToolbar2Wx`` instead)
+- ``cbook.align_iterators`` (no replacment)
+- ``contour.ContourLabeler.get_real_label_width`` (no replacement)
+- ``legend.Legend.draggable`` (use `legend.Legend.set_draggable()` instead)
+- ``texmanager.TexManager.postscriptd``, ``texmanager.TexManager.pscnt``,
+  ``texmanager.TexManager.make_ps``, ``texmanager.TexManager.get_ps_bbox``
+  (no replacements)
+
+Arguments
+~~~~~~~~~
+- The ``fig`` kwarg to ``GridSpec.get_subplot_params`` and
+  ``GridSpecFromSubplotSpec.get_subplot_params`` (use the argument
+  ``figure`` instead)
+- Passing 'box-forced' to `axes.Axes.set_adjustable` (use 'box' instead)
+- Support for the strings 'on'/'true'/'off'/'false' to mean
+  ``True``/``False`` (directly use ``True``/``False`` instead).
+  The following functions are affected: `Axes.grid`, `Axes3D.grid`
+  `Axis.set_tick_params`, `pyplot.box`.
+- Using `pyplot.axes` with an `axes.Axes` type argument
+  (use `pyplot.sca` instead)
+
+Other
+~~~~~
+- svgfont support (in :rc:`svg.fonttype`) has been removed,
+- Logging is now done with the standard python ``logging`` library.
+  ``matplotlib.verbose`` and the command line switches ``--verbose-LEVEL`` are
+  removed.
+
+  To control the logging output use::
+
+    import logging
+    logger = logging.getLogger('matplotlib')
+    logger.set_level(logging.INFO)
+
 :mod:`matplotlib.mlab` removals
 -------------------------------
 
@@ -608,54 +662,6 @@ The following keyword arguments are deprecated:
   an unintended implementation detail with the same semantics as
   ``shade=False``. Please use the latter code instead.
 
-  API removals
-
-
-The following deprecated APIs were removed:
-
-Classes and methods
--------------------
-- ``Verbose`` (replaced by python logging library)
-- ``artist.Artist.hitlist`` (no replacement)
-- ``artist.Artist.is_figure_set`` (use ``artist.figure is not None`` instead)
-- ``axis.Axis.unit_data`` (use ``axis.Axis.units`` instead)
-- ``backend_bases.FigureCanvasBase.onRemove`` (no replacement)
-  ``backend_bases.FigureManagerBase.show_popup`` (this never did anything)
-- ``backend_wx.SubplotToolWx`` (no replacement)
-- ``backend_wx.Toolbar`` (use ``backend_wx.NavigationToolbar2Wx`` instead)
-- ``cbook.align_iterators`` (no replacment)
-- ``contour.ContourLabeler.get_real_label_width`` (no replacement)
-- ``legend.Legend.draggable`` (use `legend.Legend.set_draggable()` instead)
-- ``texmanager.TexManager.postscriptd``, ``texmanager.TexManager.pscnt``,
-  ``texmanager.TexManager.make_ps``, ``texmanager.TexManager.get_ps_bbox``
-  (no replacements)
-
-Arguments
----------
-- The ``fig`` kwarg to ``GridSpec.get_subplot_params`` and
-  ``GridSpecFromSubplotSpec.get_subplot_params`` (use the argument
-  ``figure`` instead)
-- Passing 'box-forced' to `axes.Axes.set_adjustable` (use 'box' instead)
-- Support for the strings 'on'/'true'/'off'/'false' to mean
-  ``True``/``False`` (directly use ``True``/``False`` instead).
-  The following functions are affected: `Axes.grid`, `Axes3D.grid`
-  `Axis.set_tick_params`, `pyplot.box`.
-- Using `pyplot.axes` with an `axes.Axes` type argument
-  (use `pyplot.sca` instead)
-
-Other
------
-- svgfont support (in :rc:`svg.fonttype`) has been removed,
-- Logging is now done with the standard python ``logging`` library.
-  ``matplotlib.verbose`` and the command line switches ``--verbose-LEVEL`` are
-  removed.
-
-  To control the logging output use::
-
-    import logging
-    logger = logging.getLogger('matplotlib')
-    logger.set_level(logging.INFO)
-
 Deprecations
 ------------
 
@@ -886,9 +892,6 @@ Changes to the internal tick handling API
 The signature of the (private) ``Axis._update_ticks`` has been changed to not
 take the renderer as argument anymore (that argument is unused).
 
-Deprecations
-------------
-
 `~Axes.bxp` now respects :rc:`boxplot.boxprops.linewidth` even when *patch_artist* is set
 -----------------------------------------------------------------------------------------
 
@@ -1082,9 +1085,3 @@ Such points are now included, but masked out by returning a masked array.
 If the *plotnonfinite* kwarg to `~.Axes.scatter` is set, then points with
 nonfinite values are plotted using the bad color of the `PathCollection`\ 's
 colormap (as set by `Colormap.set_bad`).
-
-Changed exceptions
-------------------
-
-- `mpl_toolkits.axes_grid1.axes_size.GetExtentHelper` now raises `ValueError`
-  for invalid directions instead of `KeyError`.
