matplotlib · tacaswell · Feb 12, 2018 · Feb 11, 2018 · Feb 11, 2018 · Feb 11, 2018
diff --git a/INSTALL.rst b/INSTALL.rst
@@ -181,7 +181,7 @@ Matplotlib requires a large number of dependencies:
     (for Python 2.7 only)
   * `subprocess32 <https://pypi.python.org/pypi/subprocess32/>`_ (for Python
     2.7 only, on Linux and macOS only)
-
+  * `kiwisolver <https://github.com/nucleic/kiwi>`__ (>= 1.0.0)
 
 Optionally, you can also install a number of packages to enable better user
 interface toolkits. See :ref:`what-is-a-backend` for more details on the
@@ -193,8 +193,10 @@ optional Matplotlib backends and the capabilities they provide.
   * `PyQt5 <https://pypi.python.org/pypi/PyQt5>`_: for the Qt5Agg backend;
   * :term:`pygtk` (>= 2.4): for the GTK and the GTKAgg backend;
   * :term:`wxpython` (>= 2.9 or later): for the WX or WXAgg backend;
+  * `cairocffi <https://cairocffi.readthedocs.io/en/latest/>`__ (>=
+    v0.8): for cairo based backends;
   * `pycairo <https://pypi.python.org/pypi/pycairo>`_: for GTK3Cairo;
-  * `Tornado <https://pypi.python.org/pypi/tornado>`_: for the WebAgg backend.
+  * `Tornado <https://pypi.python.org/pypi/tornado>`_: for the WebAgg backend;
 
 For better support of animation output format and image file formats, LaTeX,
 etc., you can install the following:

diff --git a/doc/api/api_changes.rst b/doc/api/api_changes.rst
@@ -13,11 +13,281 @@ For new features that were added to Matplotlib, please see
 API Changes in 2.2.0
 ====================
 
-.. toctree::
-   :glob:
-   :maxdepth: 1
+..
+
+  .. toctree::
+     :glob:
+     :maxdepth: 1
+
+     next_api_changes/*
+
+
+Deprecations
+------------
+
+Classes, functions, and methods
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The unused and untested ``Artist.onRemove`` and ``Artist.hitlist`` methods have
+been deprecated.
+
+The now unused ``mlab.less_simple_linear_interpolation`` function is
+deprecated.
+
+The unused ``ContourLabeler.get_real_label_width`` method is deprecated.
+
+The unused ``FigureManagerBase.show_popup`` method is deprecated.  This
+introduced in e945059b327d42a99938b939a1be867fa023e7ba in 2005 but never built
+out into any of the backends.
+
+:class:`backend_tkagg.AxisMenu` is deprecated, as it has become
+unused since the removal of "classic" toolbars.
+
+
+Changed function signatures
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+kwarg ``fig`` to `.GridSpec.get_subplot_params` is
+deprecated,  use ``figure`` instead.
+
+Using `.pyplot.axes` with an `.Axes` as argument is deprecated. This sets
+the current axes, i.e. it has the same effect as `.pyplot.sca`. For clarity
+``plt.sca(ax)`` should be preferred over ``plt.axes(ax)``.
+
+
+Using strings instead of booleans to control grid and tick visibility
+is deprecated.  Using ``"on"``, ``"off"``, ``"true"``, or ``"false"``
+to control grid and tick visibility has been deprecated.  Instead, use
+normal booleans (``True``/``False``) or boolean-likes.  In the future,
+all non-empty strings may be interpreted as ``True``.
+
+When given 2D inputs with non-matching numbers of columns, `~.pyplot.plot`
+currently cycles through the columns of the narrower input, until all the
+columns of the wider input have been plotted.  This behavior is deprecated; in
+the future, only broadcasting (1 column to *n* columns) will be performed.
+
+
+rcparams
+~~~~~~~~
+
+The :rc:`backend.qt4` and :rc:`backend.qt5` rcParams were deprecated
+in version 2.2.  In order to force the use of a specific Qt binding,
+either import that binding first, or set the ``QT_API`` environment
+variable.
+
+Deprecation of the ``nbagg.transparent`` rcParam.  To control
+transparency of figure patches in the nbagg (or any other) backend,
+directly set ``figure.patch.facecolor``, or the ``figure.facecolor``
+rcParam.
+
+
+
+Removals
+--------
+
+Function Signatures
+~~~~~~~~~~~~~~~~~~~
+
+Contouring no longer supports ``legacy`` corner masking.  The
+deprecated ``ContourSet.vmin`` and ``ContourSet.vmax`` properties have
+been removed.
+
+Passing ``None`` instead of ``"none"`` as format to `~.Axes.errorbar` is no
+longer supported.
+
+The ``bgcolor`` keyword argument to ``Axes`` has been removed.
+
+Modules, methods, and functions
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+The ``matplotlib.finance``, ``mpl_toolkits.exceltools`` and
+``mpl_toolkits.gtktools`` modules have been removed.  ``matplotlib.finance``
+remains available at https://github.com/matplotlib/mpl_finance.
+
+The ``mpl_toolkits.mplot3d.art3d.iscolor`` function has been removed.
+
+The ``Axes.get_axis_bgcolor``, ``Axes.set_axis_bgcolor``,
+``Bbox.update_from_data``, ``Bbox.update_datalim_numerix``,
+``MaxNLocator.bin_boundaries`` methods have been removed.
+
+``mencoder`` can no longer be used to encode animations.
+
+The unused `FONT_SCALE` and `fontd` attributes of the `RendererSVG`
+class have been removed.
+
+color maps
+~~~~~~~~~~
+
+The ``spectral`` colormap has been removed.  The ``Vega*`` colormaps, which
+were aliases for the ``tab*`` colormaps, have been removed.
+
+
+rcparams
+~~~~~~~~
+
+The following deprecated rcParams have been removed:
+
+- ``axes.color_cycle`` (see ``axes.prop_cycle``),
+- ``legend.isaxes``,
+- ``svg.embed_char_paths`` (see ``svg.fonttype``),
+- ``text.fontstyle``, ``text.fontangle``, ``text.fontvariant``,
+  ``text.fontweight``, ``text.fontsize`` (renamed to ``text.style``, etc.),
+- ``tick.size`` (renamed to ``tick.major.size``).
+
+
+
+Removal of unused imports
+-------------------------
+Many unused imports were removed from the codebase.  As a result,
+trying to import certain classes or functions from the "wrong" module
+(e.g. `~.Figure` from :mod:`matplotlib.backends.backend_agg` instead of
+:mod:`matplotlib.figure`) will now raise an `ImportError`.
+
+
+Exception type changes
+----------------------
+
+If `MovieWriterRegistry` can't find the requested `MovieWriter`, a
+more helpful `RuntimeError` message is now raised instead of the
+previously raised `KeyError`.
+
+`~.tight_layout.auto_adjust_subplotpars` now raises `ValueError`
+instead of `RuntimeError` when sizes of input lists don't match
+
+
+`Figure.set_figwidth` and `Figure.set_figheight` default forward to True
+------------------------------------------------------------------------
+
+`matplotlib.Figure.set_figwidth` and `matplotlib.Figure.set_figheight`
+had the kwarg `forward=False`
+by default, but `Figure.set_size_inches` now defaults to `forward=True`.
+This makes these functions conistent.
+
+
+Do not truncate svg sizes to nearest point
+------------------------------------------
+
+There is no reason to size the SVG out put in integer points, change
+to out putting floats for the *height*, *width*, and *viewBox* attributes
+of the *svg* element.
+
+
+Fontsizes less than 1 pt are clipped to be 1 pt.
+------------------------------------------------
+
+FreeType doesn't allow fonts to get smaller than 1 pt, so all Agg
+backends were silently rounding up to 1 pt.  PDF (other vector
+backends?) were letting us write fonts that were less than 1 pt, but
+they could not be placed properly because position information comes from
+FreeType.  This change makes it so no backends can use fonts smaller than
+1 pt, consistent with FreeType and ensuring more consistent results across
+backends.
+
+
+
+Changes to Qt backend class MRO
+-------------------------------
+
+To support both Agg and cairo rendering for Qt backends all of the
+non-Agg specific code previously in
+:class:`.backend_qt5agg.FigureCanvasQTAggBase` has been moved to
+:class:`.backend_qt5.FigureCanvasQT` so it can be shared with the cairo
+implementation.  The :meth:`.FigureCanvasQTAggBase.paintEvent`,
+:meth:`.FigureCanvasQTAggBase.blit`, and
+:meth:`.FigureCanvasQTAggBase.print_figure` methods have moved to
+:meth:`.FigureCanvasQTAgg.paintEvent`, :meth:`.FigureCanvasQTAgg.blit`, and
+:meth:`.FigureCanvasQTAgg.print_figure`.  The first two methods assume that
+the instance is also a :class:`QWidget` so to use
+:class:`FigureCanvasQTAggBase` it was required to multiple inherit
+from a :class:`QWidget` sub-class.
+
+Having moved all of its methods either up or down the class hierarchy
+:class:`FigureCanvasQTAggBase` has been deprecated.  To do this with
+out warning and to preserve as much API as possible,
+:class:`.backend_qt5.FigureCanvasQTAggBase` now inherits from
+:class:`.backend_qt5.FigureCanvasQTAgg`.
+
+The MRO for :class:`FigureCanvasQTAgg` and
+:class:`FigureCanvasQTAggBase` used to be ::
+
+
+   [matplotlib.backends.backend_qt5agg.FigureCanvasQTAgg,
+    matplotlib.backends.backend_qt5agg.FigureCanvasQTAggBase,
+    matplotlib.backends.backend_agg.FigureCanvasAgg,
+    matplotlib.backends.backend_qt5.FigureCanvasQT,
+    PyQt5.QtWidgets.QWidget,
+    PyQt5.QtCore.QObject,
+    sip.wrapper,
+    PyQt5.QtGui.QPaintDevice,
+    sip.simplewrapper,
+    matplotlib.backend_bases.FigureCanvasBase,
+    object]
+
+and ::
+
+
+   [matplotlib.backends.backend_qt5agg.FigureCanvasQTAggBase,
+    matplotlib.backends.backend_agg.FigureCanvasAgg,
+    matplotlib.backend_bases.FigureCanvasBase,
+    object]
+
+
+respectively.  They are now ::
+
+   [matplotlib.backends.backend_qt5agg.FigureCanvasQTAgg,
+    matplotlib.backends.backend_agg.FigureCanvasAgg,
+    matplotlib.backends.backend_qt5.FigureCanvasQT,
+    PyQt5.QtWidgets.QWidget,
+    PyQt5.QtCore.QObject,
+    sip.wrapper,
+    PyQt5.QtGui.QPaintDevice,
+    sip.simplewrapper,
+    matplotlib.backend_bases.FigureCanvasBase,
+    object]
+
+and ::
+
+   [matplotlib.backends.backend_qt5agg.FigureCanvasQTAggBase,
+    matplotlib.backends.backend_qt5agg.FigureCanvasQTAgg,
+    matplotlib.backends.backend_agg.FigureCanvasAgg,
+    matplotlib.backends.backend_qt5.FigureCanvasQT,
+    PyQt5.QtWidgets.QWidget,
+    PyQt5.QtCore.QObject,
+    sip.wrapper,
+    PyQt5.QtGui.QPaintDevice,
+    sip.simplewrapper,
+    matplotlib.backend_bases.FigureCanvasBase,
+    object]
+
+
+
+New dependency
+--------------
+
+`kiwisolver <https://github.com/nucleic/kiwi>`__ is now a required
+dependency to support the new constrained_layout,  see
+:ref:`sphx_glr_tutorials_intermediate_constrainedlayout_guide.py` for
+more details.
+
+
+`Axes.imshow` clips RGB values to the valid range
+-------------------------------------------------
+
+When `Axes.imshow` is passed an RGB or RGBA value with out-of-range
+values, it now logs a warning and clips them to the valid range.
+The old behaviour, wrapping back in to the range, often hid outliers
+and made interpreting RGB images unreliable.
+
+
+GTKAgg and GTKCairo backends deprecated
+---------------------------------------
+
+The GTKAgg and GTKCairo backends have been deprecated. These obsolete backends
+allow figures to be rendered via the GTK+ 2 toolkit. They are untested, known
+to be broken, will not work with Python 3, and their use has been discouraged
+for some time. Instead, use the `GTK3Agg` and `GTK3Cairo` backends for
+rendering to GTK+ 3 windows.
 
-   next_api_changes/*
 
 
 API Changes in 2.1.2

diff --git a/doc/api/api_changes/2017-09-29_JMK_constrained_layout_api.rst b/doc/api/api_changes/2017-09-29_JMK_constrained_layout_api.rst
diff --git a/doc/api/api_changes/2018-01-26-ZHD.rst b/doc/api/api_changes/2018-01-26-ZHD.rst
diff --git a/doc/api/api_changes/2018-02-04-AL.rst b/doc/api/api_changes/2018-02-04-AL.rst
diff --git a/doc/api/api_changes/2018-02-10-ES.rst b/doc/api/api_changes/2018-02-10-ES.rst
diff --git a/doc/api/next_api_changes/01-11-2017-DS.rst b/doc/api/next_api_changes/01-11-2017-DS.rst
diff --git a/doc/api/next_api_changes/171225-AL-tickbools.rst b/doc/api/next_api_changes/171225-AL-tickbools.rst
diff --git a/doc/api/next_api_changes/2017-09-22-AL-contour.rst b/doc/api/next_api_changes/2017-09-22-AL-contour.rst
diff --git a/doc/api/next_api_changes/2017-09-22-AL-removal-of-deprecated-features.rst b/doc/api/next_api_changes/2017-09-22-AL-removal-of-deprecated-features.rst