Merge branch 'main' into aspect_equal_3d

Author: scottshambaugh

.github/ISSUE_TEMPLATE/bug_report.yml

@@ -15,8 +15,9 @@ body:
     id: reproduction
     attributes:
       label: Code for reproduction
-      description: If possible, please provide a minimum self-contained example.
-      placeholder: Paste your code here
+      description: |
+        If possible, please provide a minimum self-contained example.
+      placeholder: Paste your code here. This field is automatically formatted as Python code.
       render: python
     validations:
       required: true

.github/workflows/cibuildwheel.yml

@@ -53,7 +53,7 @@ jobs:
           fetch-depth: 0
 
       - name: Build wheels for CPython 3.10
-        uses: pypa/cibuildwheel@v2.8.0
+        uses: pypa/cibuildwheel@v2.8.1
         env:
           CIBW_BUILD: "cp310-*"
           CIBW_SKIP: "*-musllinux*"
@@ -66,7 +66,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.9
-        uses: pypa/cibuildwheel@v2.8.0
+        uses: pypa/cibuildwheel@v2.8.1
         env:
           CIBW_BUILD: "cp39-*"
           CIBW_SKIP: "*-musllinux*"
@@ -79,7 +79,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for CPython 3.8
-        uses: pypa/cibuildwheel@v2.8.0
+        uses: pypa/cibuildwheel@v2.8.1
         env:
           CIBW_BUILD: "cp38-*"
           CIBW_SKIP: "*-musllinux*"
@@ -92,7 +92,7 @@ jobs:
           CIBW_ARCHS: ${{ matrix.cibw_archs }}
 
       - name: Build wheels for PyPy
-        uses: pypa/cibuildwheel@v2.8.0
+        uses: pypa/cibuildwheel@v2.8.1
         env:
           CIBW_BUILD: "pp38-*"
           CIBW_SKIP: "*-musllinux*"

doc/api/animation_api.rst

@@ -111,7 +111,7 @@ artist at a global scope and let Python sort things out.  For example ::
 
    fig, ax = plt.subplots()
    xdata, ydata = [], []
-   ln, = plt.plot([], [], 'ro')
+   ln, = ax.plot([], [], 'ro')
 
    def init():
        ax.set_xlim(0, 2*np.pi)

doc/api/index_backend_api.rst

@@ -2,6 +2,8 @@
 ``matplotlib.backends``
 ***********************
 
+.. module:: matplotlib.backends
+
 .. toctree::
    :maxdepth: 1
 

doc/api/matplotlib_configuration_api.rst

@@ -4,6 +4,11 @@
 
 .. py:currentmodule:: matplotlib
 
+.. automodule:: matplotlib
+   :no-members:
+   :no-undoc-members:
+   :noindex:
+
 Backend management
 ==================
 

doc/api/next_api_changes/behavior/23233-TH.rst

@@ -0,0 +1,13 @@
+``stem(..., markerfmt=...)`` behavior
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+The behavior of the *markerfmt* parameter of `~.Axes.stem` has changed:
+
+- If *markerfmt* does not contain a color, the color is taken from *linefmt*.
+- If *markerfmt* does not contain a marker, the default is 'o'.
+
+Before, *markerfmt* was passed unmodified to ``plot(..., fmt)``, which had
+a number of unintended side-effects; e.g. only giving a color switched to
+a solid line without markers.
+
+For a simple call ``stem(x, y)`` without parameters, the new rules still
+reproduce the old behavior.

doc/api/next_api_changes/behavior/23443-AL.rst

@@ -0,0 +1,2 @@
+The pgf backend now uses the article documentclass as basis for compilation
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

doc/api/next_api_changes/behavior/23475-WLQ.rst

@@ -0,0 +1,5 @@
+The markerfacecoloralt parameter to Line2D is now supported by axes.errorbar
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+- markerfacecoloralt is now passed to the line plotter from axes.errorbar
+- Documentation for axes.errorbar how accurately lists which properties are
+  passed on to Line2D, rather than claiming that all kwargs are passed on

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

@@ -0,0 +1,11 @@
+Event handlers
+~~~~~~~~~~~~~~
+The ``draw_event``, ``resize_event``, ``close_event``, ``key_press_event``,
+``key_release_event``, ``pick_event``, ``scroll_event``,
+``button_press_event``, ``button_release_event``, ``motion_notify_event``,
+``enter_notify_event`` and ``leave_notify_event`` methods of `.FigureCanvasBase`
+are deprecated.  They had inconsistent signatures across backends, and made it
+difficult to improve event metadata.
+
+In order to trigger an event on a canvas, directly construct an `.Event` object
+of the correct class and call ``canvas.callbacks.process(event.name, event)``.

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

@@ -0,0 +1,4 @@
+``FigureCanvasBase.pick``
+~~~~~~~~~~~~~~~~~~~~~~~~~
+... is deprecated.  Directly call `.Figure.pick`, which has taken over the
+responsibility of checking the canvas widgetlock as well.