Merge branch 'master' into issue_8946

Author: l-johnston

.coveragerc

@@ -7,6 +7,7 @@ omit = matplotlib/_version.py
 
 [report]
 exclude_lines =
+    pragma: no cover
     raise NotImplemented
     def __str__
     def __repr__

.github/CODE_OF_CONDUCT.md

@@ -0,0 +1,2 @@
+Matplotlib follows the Python Software Foundation Code of Conduct in everything we do,
+see https://www.python.org/psf/conduct/.

doc/api/figure_api.rst

@@ -16,7 +16,6 @@ Classes
    :template: autosummary.rst
    :nosignatures:
 
-   AxesStack
    Figure
    SubplotParams
 

doc/api/next_api_changes/behavior/18525-ES.rst

@@ -0,0 +1,5 @@
+``mplot3d.art3d.get_dir_vector`` always returns NumPy arrays
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+For consistency, `~.mplot3d.art3d.get_dir_vector` now always returns NumPy
+arrays, even if the input is a 3-element iterable.

doc/api/next_api_changes/behavior/8987-Z.rst

@@ -0,0 +1,6 @@
+``ScalarFormatter`` *useLocale* option obeys grouping
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+When the `~.ScalarFormatter` option *useLocale* is enabled (or
+:rc:`axes.formatter.use_locale` is *True*) and the configured locale uses
+grouping, a separator will be added as described in `locale.format_string`.

doc/api/next_api_changes/deprecations/18528-AL.rst

@@ -0,0 +1,5 @@
+*minimumdescent* parameter/property of ``TextArea``
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+`.offsetbox.TextArea` has behaved as if *minimumdescent* was always True
+(regardless of the value to which it was set) since Matplotlib 1.3, so the
+parameter/property is deprecated.

doc/api/next_api_changes/removals/18515-ES.rst

@@ -0,0 +1,33 @@
+GTK
+~~~
+
+The following methods and properties have been removed:
+
+* ``ConfigureSubplotsGTK3.destroy`` method
+* ``ConfigureSubplotsGTK3.init_window`` method
+* ``ConfigureSubplotsGTK3.window`` property
+
+WX
+~~
+``FigureFrameWx.statusbar``, ``NavigationToolbar2Wx.set_status_bar``, and
+``NavigationToolbar2Wx.statbar`` have been removed. The status bar can be
+retrieved by calling standard wx methods (``frame.GetStatusBar()`` and
+``toolbar.GetTopLevelParent().GetStatusBar()``).
+
+``backend_wx.ConfigureSubplotsWx.configure_subplots`` and
+``backend_wx.ConfigureSubplotsWx.get_canvas`` have been removed.
+
+PGF
+~~~
+``backend_pgf.repl_escapetext`` and ``backend_pgf.repl_mathdefault`` have been
+removed.
+
+``RendererPgf.latexManager`` has been removed.
+
+FigureCanvas
+~~~~~~~~~~~~
+``FigureCanvasBase.draw_cursor`` and ``FigureCanvasMac.invalidate`` have been
+removed.
+
+The ``dryrun`` parameter to the various ``FigureCanvasFoo.print_foo`` methods
+has been removed.

doc/api/next_api_changes/removals/18516-ES.rst

@@ -0,0 +1,11 @@
+Fonts
+~~~~~
+``font_manager.JSONEncoder`` has been removed. Use `.font_manager.json_dump` to
+dump a `.FontManager` instance.
+
+``font_manager.createFontList`` has been removed. `.font_manager.FontManager.addfont`
+is now available to register a font at a given path.
+
+The ``as_str``, ``as_rgba_str``, ``as_array``, ``get_width`` and ``get_height``
+methods of ``matplotlib.ft2font.FT2Image`` have been removed. Convert the
+``FT2Image`` to a NumPy array with ``np.asarray`` before processing it.

doc/api/next_api_changes/removals/18522-ES.rst

@@ -0,0 +1,39 @@
+``matplotlib.mlab``
+~~~~~~~~~~~~~~~~~~~
+``mlab.apply_window`` and ``mlab.stride_repeat`` have been removed.
+
+Axes3D
+~~~~~~
+``axes3d.unit_bbox`` has been removed; use ``Bbox.unit`` instead.
+
+axisartist
+~~~~~~~~~~
+``mpl_toolkits.axisartist.grid_finder.GridFinderBase`` has been removed; use
+`.GridFinder` instead.
+
+``axisartist.axis_artist.BezierPath`` has been removed; use
+`.patches.PathPatch` instead.
+
+Returning a factor equal to None from axisartist Locators (which are **not**
+the same as "standard" tick Locators), or passing a factor equal to None
+to axisartist Formatters (which are **not** the same as "standard" tick
+Formatters) is no longer supported. Pass a factor equal to 1 instead.
+
+Misc
+~~~~
+``matplotlib.get_home`` has been removed; use standard library instead.
+
+``matplotlib.compare_versions`` has been removed; use comparison of
+``distutils.version.LooseVersion``\s instead.
+
+``matplotlib.checkdep_ps_distiller`` has been removed.
+
+``matplotlib.figure.AxesStack`` has been removed.
+
+``BboxBase.is_unit`` has been removed; check the `.Bbox` extents if needed.
+
+``Affine2DBase.matrix_from_values(...)`` has been removed; use (for example)
+``Affine2D.from_values(...).get_matrix()`` instead.
+
+``style.core.is_style_file`` and ``style.core.iter_style_files`` have been
+removed.

doc/api/prev_api_changes/api_changes_2.1.0.rst

@@ -329,7 +329,7 @@ a previous axes instance currently reuses the earlier instance.  This
 behavior has been deprecated in Matplotlib 2.1. In a future version, a
 *new* instance will always be created and returned.  Meanwhile, in such
 a situation, a deprecation warning is raised by
-:class:`~matplotlib.figure.AxesStack`.
+``matplotlib.figure.AxesStack``.
 
 This warning can be suppressed, and the future behavior ensured, by passing
 a *unique* label to each axes instance.  See the docstring of